Git-ориентированная CMS для мультиязычных MDX-сайтов

Как это работает

1. 1

   Задайте схему

   Типы контента — это схемы Zod. Укажите, какие поля нужно переводить, какие остаются только на английском и как документы ссылаются друг на друга.

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

   Напишите контент

   Один MDX-файл на документ, всё коммитится в репозиторий. Имя файла становится английским слагом, а frontmatter проверяется по схеме.

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

   Переводите только то, что изменилось

   Текст для перевода хешируется, поэтому в Gemini отправляются только новые или изменённые страницы (через Batch API, за полцены). Промпт настроен на транскреацию, чтобы текст звучал естественно для носителей. Результат парсится как MDX перед сохранением: если ИИ ошибся, упадёт скрипт, а не сайт.

   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

   Читайте с полной типизацией

   Рантайм выводит типы документов из вашего конфига. Списки, выборки, связи, альтернативные ссылки hreflang и элементы sitemap возвращаются со строгой типизацией.

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

Что вы получаете