نظام إدارة المحتوى المعتمد على Git لمواقع 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 بنصف تكلفة الرموز. الموجه مُعد خصيصاً للترجمة الإبداعية، بحيث تبدو النصوص وكأنها كُتبت باللغة الهدف. يُحلل الإخراج كـ 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، وإدخالات خريطة الموقع تعود جميعها مكتوبة بالكامل.

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

ماذا ستحصل