scher.nl
Persoonlijk project · november 2026

CMS op scher.nl

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.

Probeer de demo → De bewerkmodus op de homepage, zonder inlog. Wat je typt blijft in je browser en wordt niet opgeslagen.
Functies
4
Pagina's bewerkbaar
10
Vertaling
NL → EN
Van opslaan tot live
± 2 min
De homepage van scher.nl in de demo van de bewerkmodus: de titel heeft een oranje kader omdat de muis erop staat, de inleiding een groen kader omdat die is aangepast, en onderin een balk met 1 tekst gewijzigd en de knoppen Opslaan, Herstellen en Stoppen.
De homepage in de demo: een aangepaste tekst krijgt een groen kader, de balk onderin telt de wijzigingen.
In één beeld

Van tekst naar live site

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.

Hoe een tekstwijziging live komt Een tekst wordt aangepast in het tekstbestand op GitHub, in het CMS op scher.nl/admin of op de pagina zelf met de bewerkmodus. Alle drie schrijven in het tekstbestand van de pagina, met Nederlands en Engels per tekst. De GitHub Action Teksten laat Claude het Engels bijwerken en bouwt de HTML uit de teksten en het sjabloon met de opmaak. Cloudflare zet de pagina in beide talen live. Tekstbestandop GitHub CMSscher.nl/admin Op de pagina?bewerk TekstenNL en EN per tekst Sjabloonopmaak, één keer Action TekstenClaude vertaalt · bouwt Cloudflarelive NL + EN
Uitgangspunt

Hoe het was

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.

Gebouwd

Vier functies, elk een stap verder

  1. 1

    Teksten los van de opmaak

    Claude CodeGitHub

    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.

    VoorheenEr was geen functie om teksten aan te passen. Elke wijziging was een opdracht aan Claude: die paste de HTML van de Nederlandse én de Engelse pagina aan, op een branch met een pull request, en daarna moest je de preview bekijken en mergen. Ook voor een komma. Zelf kon alleen rechtstreeks in de HTML, met kans op een kapotte pagina.
    VerbeteringEén overzichtelijk bestand per pagina, NL en EN naast elkaar. Aan de opmaak kom je niet meer, dus die kan ook niet stuk.
    teksten/*.yamlsjablonen/npm run buildnpm run check
  2. 2

    Automatische vertaling met Claude

    Claude APIGitHub Actions

    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.

    Na stap 1Overzichtelijk, maar elke wijziging nog steeds twee keer: zelf vertalen en zelf de build draaien.
    VerbeteringAlleen het Nederlands aanpassen. Vertalen, bouwen en live zetten gaat vanzelf, en de vertaling gaat door hetzelfde HTML-filter als elke tekst.
    Claude Sonnet 5.5alleen gewijzigde tekstenHTML-filter
  3. 3

    Een CMS op scher.nl/admin

    Sveltia CMSCloudflare Worker

    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.

    Na stap 2Wel alleen Nederlands, maar nog steeds een YAML-bestand op GitHub openen en de juiste sleutel zoeken.
    VerbeteringGewoon een formulier in de browser, ook op telefoon of tablet. Geen bestanden, sleutels of git meer nodig.
    Sveltia CMSGitHub App, 1 repoinlog via eigen Worker
  4. 4

    Bewerken op de pagina zelf

    Claude CodeEigenaar

    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.

    Na stap 3In het CMS bewerk je velden los van de pagina, en moet je uitzoeken welk veld bij welke zin hoort.
    VerbeteringWat je ziet, pas je aan, precies op de plek waar het staat. Geen zoeken meer, en je ziet meteen hoe het eruitziet.
    ?bewerkzelfde inlog als /adminalleen gewijzigde teksten
Onder de motorkap

De Claude API

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.

KenmerkClaude-app (desktop)Claude API
Voor wieEen mens die chat, schrijft of bouwtEen programma, zoals een GitHub Action
Hoe het startJij typt een vraagAutomatisch, bij elke push
Zonder jouNee, iemand moet het vragenJa, ook na een wijziging in het CMS of met ?bewerk
AntwoordVrije tekst in een gesprekVast formaat dat code direct controleert en verwerkt
VoorspelbaarElk gesprek een beetje andersElke keer dezelfde instructies en hetzelfde model
KostenVast bedrag per maand (abonnement)Per gebruik, met een uitgavelimiet
Sterk inMeedenken en bouwen, zoals deze site met Claude CodeTerugkerend werk in een bouwstraat

Waarom hier de API

  • Vertalen moet gebeuren zonder dat iemand iets doet. Een tekst uit het CMS of de bewerkmodus komt binnen als commit, en de Action draait op een server van GitHub, waar geen Claude-app is.
  • De vertaling gaat zonder tussenkomst de site in. Daarom moet het antwoord een vast formaat hebben dat code kan controleren, in plaats van een chatbericht.
  • Elke vertaling volgt dezelfde vaste regels: HTML-tags laten staan, links naar de Engelse pagina's, eigennamen niet vertalen. Zo is het resultaat elke keer voorspelbaar.
  • Alleen gewijzigde teksten gaan naar Claude, dus het gebruik per wijziging is klein, en het is per verzoek terug te zien.
  • De Claude-app blijft het gereedschap om de site te bouwen en te verbeteren. De API doet het automatische deel daarachter.
Vergelijking

Toen en nu

TaakVoorheenNu
Een zin aanpassenTwee HTML-bestanden openen en tussen de tags zoekenOp de pagina klikken en typen
Engelse versieZelf vertalen en invoerenClaude vertaalt bij elke wijziging
WaarEen computer met de code, of een opdracht aan Claude CodeElke browser, ook op telefoon
Risico op een kapotte paginaEen vergeten tag breekt de opmaakOpmaak staat los; de build controleert elke tekst
Nieuwe paginaTeksten in twee talen met de hand bijhoudenKomt vanzelf in het CMS en de bewerkmodus
Zelf proberen

De demo

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.

Werkt zoals echtElke zichtbare tekst op de homepage aanklikken en overtypen, gewijzigde teksten die oplichten, de teller in de balk en alles terugzetten met Herstellen. Ook op de Engelse homepage.
NagespeeldOpslaan laat alleen zien wat er in het echt gebeurt: een commit, de vertaling door Claude en binnen twee minuten live. Wat je typt, bestaat alleen in je eigen browservenster en is weg na herladen.
Waarom geen echte opslag voor bezoekers? Elke wijziging op main staat binnen twee minuten live. Schrijven kan daarom alleen met een GitHub-inlog die rechten heeft op deze ene repository.
Probeer de demo →