Il CMS basato su git per siti multilingua in MDX

Come funziona

1. 1

   Definisci uno schema

   I tipi di contenuto sono schemi Zod. Indica quali campi vanno tradotti, quali restano solo in inglese e come i documenti si relazionano tra loro.

   // scribe.config.ts
   defineContentType({
     id: "blog",
     path: "/blog/{slug}",
     slugStrategy: "localized",
     schema: z.object({
       title: field.translatable(z.string().min(1)),
       description: field.translatable(z.string().min(50)),
       author: field.relation("author"),
       heroImage: field.structural(z.string().optional()),
     }),
   });

2. 2

   Scrivi i contenuti

   Un file MDX per ogni documento, committato nel repository. Il nome del file fa da slug in inglese; il frontmatter viene validato in base allo schema.

   ---
   title: "Hello, world"
   description: "A first post that says hello to the world."
   author: jane
   publishedAt: "2026-01-15"
   ---
   
   The body is MDX. **Markdown** and <Components /> both work.

3. 3

   Traduci le modifiche

   I contenuti da tradurre hanno un hash: solo le pagine nuove o aggiornate vengono inviate a Gemini (tramite Batch API, dimezzando il costo dei token). Il prompt è calibrato per la transcreation, per farti ottenere testi che sembrano scritti da un madrelingua. L'output viene parsato come MDX prima di essere salvato; un errore del modello fa fallire lo script, non il sito.

   export GEMINI_API_KEY=...
   
   npx scribe translate --locale fr de --dry-run   # show the worklist
   npx scribe translate --locale fr de             # translate, validate, store
   git add .scribe/store.sqlite                    # translations live in git

4. 4

   Leggi tutto, già tipizzato

   Il runtime deduce i tipi di documento direttamente dalla tua configurazione. Elenchi, query, relazioni, hreflang e sitemap: tutto ti viene restituito già tipizzato.

   const scribe = createScribe(config);
   
   const posts = scribe.blog.list("fr");                  // BlogDoc[]
   const { document } = scribe.blog.resolve(slug, "fr");  // EN fallback built in
   const author = scribe.blog.related(document!, "author"); // AuthorDoc
   const hreflang = scribe.blog.alternates(document!);

Cosa include