Le CMS basé sur git pour les sites MDX multilingues

Fonctionnement

1. 1

   Définition d'un schéma

   Les types de contenu correspondent à des schémas Zod. Indiquez quels champs traduire, lesquels doivent rester en anglais et comment les documents sont liés entre eux.

   // 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

   Rédaction du contenu

   Chaque document correspond à un fichier MDX versionné dans votre dépôt. Son nom définit le slug en anglais. L'en-tête (frontmatter) est validé selon votre schéma.

   ---
   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

   Traduction des changements

   Le contenu traduisible est haché pour n'envoyer que les pages manquantes ou obsolètes à Gemini, via l'API Batch qui divise par deux le coût des jetons. Le prompt est optimisé pour la transcréation afin d'obtenir un texte qui semble rédigé directement dans la langue cible. Le résultat est analysé comme du MDX avant stockage. Une mauvaise réponse fait échouer l'exécution locale, pas votre site.

   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

   Lecture typée

   L'environnement d'exécution déduit les types de documents depuis votre configuration. Les listes, recherches, relations, balises hreflang et entrées de sitemap sont entièrement typées à leur retour.

   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!);

Ce qui est inclus