Tot begin november was elke tekstwijziging op scher.nl werk in HTML, en dan twee keer: in de Nederlandse en in de Engelse pagina. In vier stappen is dat veranderd. Nu pas je een tekst aan in een formulier of direct op de pagina, en Claude zorgt voor het Engels.
Er zijn drie manieren om een tekst aan te passen. Alle drie komen uit bij hetzelfde tekstbestand, en vanaf daar gaat het vanzelf: vertalen, bouwen en live zetten.
Elke pagina bestond als twee HTML-bestanden, een Nederlandse en een Engelse, met de tekst midden tussen de opmaak. Een zin aanpassen betekende: het juiste bestand vinden, de zin tussen de tags opzoeken, hem aanpassen zonder een tag te breken, en daarna hetzelfde in het Engels, zelf vertaald. Dat ging meestal via een opdracht aan Claude Code, ook voor een komma.
Alle teksten staan nu per pagina in één tekstbestand (teksten/<pagina>.yaml), met de Nederlandse en Engelse versie onder elkaar. De opmaak staat in een sjabloon dat beide talen delen. Een build maakt daar de HTML van en controleert dat de Nederlandse en Engelse pagina dezelfde opbouw hebben.
Na elke push zoekt de GitHub Action Teksten welke Nederlandse teksten zijn veranderd, laat Claude (Sonnet 5.5) alleen die naar het Engels vertalen, bouwt de HTML opnieuw en zet het resultaat als commit terug. Een Engelse tekst die je zelf schrijft, blijft staan. Wordt er toch rechtstreeks HTML aangepast of een nieuwe pagina als HTML gemaakt, dan haalt de Action die teksten ook naar het tekstbestand.
Op scher.nl/admin staat een CMS met een formulier per pagina en leesbare veldnamen. Inloggen gaat met GitHub, via een eigen GitHub App die alleen bij deze site kan; de inlog loopt over de Worker van scher.nl zelf. Opslaan wordt een commit, en de Action van stap 2 doet de rest. De formulieren worden bij elke build uit de tekstbestanden gemaakt, dus een nieuwe pagina staat er vanzelf in.
Zet ?bewerk achter het adres van een pagina, en elke zichtbare tekst wordt aanklikbaar. Je typt eroverheen, de gewijzigde teksten lichten op, en Opslaan zet alleen die teksten in het tekstbestand. Dat werkt op elke pagina en in beide talen, met dezelfde inlog als het CMS. Voor teksten die je niet ziet, zoals de paginatitel of teksten in een figuur, blijft het CMS de plek.
De vertaling in stap 2 loopt via de Claude API: de toegang tot Claude voor programma's in plaats van voor mensen. Bij elke push stuurt de GitHub Action per pagina één verzoek met de gewijzigde Nederlandse teksten, en de bestaande Engelse teksten als context, zodat termen en toon gelijk blijven. Claude (Sonnet 5.5) antwoordt in een vast formaat: per tekst precies één Engelse vertaling. Dat antwoord gaat eerst door het HTML-filter en pas daarna de site in.
In deze stap zit geen mens aan het stuur. De Action gebruikt een API-sleutel die als geheim in GitHub staat en alleen in de vertaalstap beschikbaar is. Het gebruik wordt per verzoek afgerekend, los van het Claude-abonnement, en er staat een uitgavelimiet op.
| Kenmerk | Claude-app (desktop) | Claude API |
|---|---|---|
| Voor wie | Een mens die chat, schrijft of bouwt | Een programma, zoals een GitHub Action |
| Hoe het start | Jij typt een vraag | Automatisch, bij elke push |
| Zonder jou | Nee, iemand moet het vragen | Ja, ook na een wijziging in het CMS of met ?bewerk |
| Antwoord | Vrije tekst in een gesprek | Vast formaat dat code direct controleert en verwerkt |
| Voorspelbaar | Elk gesprek een beetje anders | Elke keer dezelfde instructies en hetzelfde model |
| Kosten | Vast bedrag per maand (abonnement) | Per gebruik, met een uitgavelimiet |
| Sterk in | Meedenken en bouwen, zoals deze site met Claude Code | Terugkerend werk in een bouwstraat |
| Taak | Voorheen | Nu |
|---|---|---|
| Een zin aanpassen | Twee HTML-bestanden openen en tussen de tags zoeken | Op de pagina klikken en typen |
| Engelse versie | Zelf vertalen en invoeren | Claude vertaalt bij elke wijziging |
| Waar | Een computer met de code, of een opdracht aan Claude Code | Elke browser, ook op telefoon |
| Risico op een kapotte pagina | Een vergeten tag breekt de opmaak | Opmaak staat los; de build controleert elke tekst |
| Nieuwe pagina | Teksten in twee talen met de hand bijhouden | Komt vanzelf in het CMS en de bewerkmodus |
De demo is dezelfde bewerkmodus, met ?bewerk=demo in het adres. Alleen opslaan doet niets: er is geen inlog en geen verbinding met GitHub, ook niet als de eigenaar in dezelfde browser is ingelogd.
main staat binnen twee minuten live. Schrijven kan daarom alleen met een GitHub-inlog die rechten heeft op deze ene repository.