We publiceren in meerdere talen zonder het schrijven te vertragen. Onze aanpak is eenvoudig: schrijf één keer in het Engels, vertaal vervolgens betrouwbaar met Gemini - terwijl structuur, links en codeblokken intact blijven.

Waar we voor optimaliseren

Nauwkeurigheid: Duidelijke technische betekenis boven letterlijke woord-voor-woord.
Structuur behouden: HTML, code en links onaangeroerd laten.
Consistente URL's: Stabiele slugs per taal, zodat links nooit breken.
Snelheid: Alle talen vertalen met één commando.

De stack (in vogelvlucht)

Contentformaat: Elke post staat als een JSON-bestand met title, date, excerpt, content, readTime, tags, categories, translatedSlugs en slug.
Framework: Next.js + next-intl voor locale-bewuste routing.
Gemini: We roepen de Gemini API aan via een klein Node-script (scripts/translate-es-gemini.ts). Het gebruikt standaard REST, ondersteunt een fallback-model en handhaaft: “vertaal alleen waarden, raak HTML of URL's niet aan.”
Orchestratie met één commando: scripts/translate-all-languages.ts voert elke per-locale vertaling uit, normaliseert vervolgens slug-mappings en valideert de volledigheid.
Dynamische taalkiezer: Deze leest per-post translatedSlugs, zodat het wisselen van talen altijd op de juiste URL landt.

Hoe het end-to-end werkt

Schrijven in het Engels: Maak app/[locale]/blog/posts/<slug>/index.json met uw inhoud. Gebruik schone HTML in content en houd codeblokken omheind.
Vertalen: Voer één commando uit (voorbeelden hieronder). Achter de schermen roepen we Gemini aan voor title, excerpt, content en readTime. Meta-gegevens zoals date, tags en categories blijven ongewijzigd.
Slugs normaliseren: We houden een translatedSlugs-kaart bij in elk bestand (Engels en vertalingen). De taalkiezer gebruikt deze om tussen talen te springen.
Valideren: Een snelle controle bevestigt dat elk taalbestand bestaat en een complete translatedSlugs-kaart heeft.

Waarom Gemini geschikt is voor deze taak

Instructieopvolging: Onze prompt is strikt: “vertaal alleen waarden, behoud HTML/code/links.” Dat is cruciaal voor veilige weergave.
Gebalanceerde snelheid en kwaliteit: We gebruiken standaard een snel model en vallen automatisch terug als een modelnaam verandert.
Voldoende deterministisch: Lage temperatuur houdt de toon consistent over posts.

Veiligheidsmaatregelen die we hebben toegevoegd

HTML-veilige vertalingen: Het script stuurt alleen de waarden van JSON-sleutels. Het laat het model nooit tags of attributen herschrijven.
Slug-discipline: translatedSlugs bevat de slug van de post per taal (bijv. en, es, fr, de, ru, nl, it, zh). Onze taalkiezer gebruikt deze bron van waarheid.
Validatie: Een commando controleert of elk taalbestand bestaat en of de slug-kaart compleet is.
Rate-limit vriendelijk: We voegen een kleine vertraging tussen verzoeken toe om de API niet te overbelasten.

Ontwikkelaars workflow

# Vertaal één post naar alle talen
npm run translate-all translate my-new-post

# Valideer dat alle taalbestanden en slug-kaarten bestaan
npm run translate-all validate my-new-post

# Voer opnieuw uit en overschrijf vertalingen als je Engels hebt bewerkt
npm run translate-all translate my-new-post --force

Dat is alles. Eén commando om te vertalen, één om te valideren. De taalkiezer werkt gewoon omdat deze de per-taal slugs opzoekt die we in elk JSON-bestand bijhouden.

Tips voor betere resultaten

Schrijf duidelijk. Korte, directe zinnen vertalen het best.
Houd codeblokken omheind en inline code verpakt in <code>.
Vermijd idiomen en grappen, tenzij u bereid bent de doeltekst aan te passen.
Geef de voorkeur aan semantische HTML. Koppen en lijsten helpen lezers en modellen.

Veelgestelde vragen

Bewerk je vertalingen?

Ja, als nuance ertoe doet (titels, intro's). Het idee is om snel te beginnen met een sterke conceptversie, en vervolgens te polijsten waar nodig.

Privacy?

Vertalingen gaan naar de Gemini API. Voeg geen geheimen toe aan posts. We bewaren referenties in .env.local (GOOGLE_API_KEY of GEMINI_API_KEY).

Modellen?

We gebruiken standaard een snel Gemini-model en vallen automatisch terug als dit niet beschikbaar is. U kunt dit overschrijven via GEMINI_MODEL.

Conclusie

Geweldige meertalige content hoeft niet traag te zijn. Houd uw bronmateriaal schoon, automatiseer de saaie delen, valideer en lever.

Engineering

Hoe we Gemini gebruiken om onze blog te vertalen (snel, consistent, mensvriendelijk)