البدء

1. التثبيت

أضف scribe-cms والتبعيات الأساسية المرافقة (peer dependencies) إلى مشروعك.

2. إنشاء scribe.config.ts

قم بتعريف أنواع المحتوى باستخدام مخططات Zod في المسار الجذري لمشروعك. استخدم `field.translatable()` للحقول القابلة للترجمة، و`field.structural()` للحقول المقتصرة على الإنجليزية فقط، و`field.relation()` لإنشاء روابط مرجعية بين المستندات.

3. كتابة المحتوى

أنشئ ملفات `.mdx` داخل مجلد `content/`. سيكون اسم الملف هو المعرف (slug) باللغة الإنجليزية. يتم التحقق من صحة البيانات الوصفية (Frontmatter) بناءً على المخطط الخاص بك أثناء التحميل.

4. التحقق من الصحة

نفّذ الأمر `scribe validate` قبل عملية البناء (build) لاكتشاف أي أخطاء في المخطط، أو روابط مرجعية مفقودة، أو تعارضات في ملفات الترجمة.

5. القراءة في وقت التشغيل

قم باستيراد `createScribe` من `scribe-cms/runtime`، ومرر ملف الإعدادات الخاص بك، ثم استخدم دوال الوصول المكتوبة (typed accessors) مثل `scribe.blog.list()` و `scribe.blog.resolve(slug, locale)`.

راجع صفحة الأمثلة للحصول على مقتطفات برمجية جاهزة للنسخ واللصق.