O CMS baseado em git para sites MDX multilíngues

Como funciona

1. 1

   Defina um schema

   Os tipos de conteúdo são schemas do Zod. Indique quais campos devem ser traduzidos, quais continuam apenas em inglês e como os documentos se relacionam.

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

   Escreva o conteúdo

   Um arquivo MDX por documento, com commit direto no seu repositório. O nome do arquivo é o slug em inglês e o frontmatter é validado pelo 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

   Traduza o que mudou

   O conteúdo traduzível recebe um hash. Isso garante que apenas páginas novas ou desatualizadas sejam enviadas ao Gemini através da Batch API pela metade do preço por token. O prompt é otimizado para transcriação, garantindo que o texto soe natural no idioma de destino. O resultado é processado como MDX antes de ser salvo. Uma resposta inválida interrompe a execução, não o seu site em produção.

   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

   Leia com tipagem

   O runtime infere os tipos de documento a partir da sua configuração. Listas, buscas, relações, alternativas de hreflang e entradas de sitemap retornam com tipagem completa.

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

O que ele oferece