النشر والموقع الكامل
مصدر واحد وواجهتا قراءة
Markdown في GitHub هو المرجع الأساسي. يبني الموقع التوثيق الكامل مباشرةً عند proof21.xyz/docs/. ويمكن إبقاء GitBook نسخة اختيارية للتحرير أو القراءة على نطاقه المجاني. لا يستخدم الموقع وسيطًا لميزة المسار الفرعي المدفوعة في GitBook.
لا تعني هذه الملفات تفعيل Git Sync تلقائيًا أو نشر الموقع أو تغيير النطاق. يجب مزامنة تحديثات GitBook صراحةً إلى حين إعداد الاتصال.
البناء والفحص
من جذر المستودع، ثبّت محلل الموقع بالإصدارات المحددة وشغّل المولد:
python3 -m pip install -r requirements-web.txt
python3 scripts/build_site.py
python3 scripts/check_site.py
python3 -m http.server 4173 --bind 127.0.0.1 --directory site
يقرأ المولد قائمة الصفحات المسموحة في docs/SUMMARY.md، ويحوّل Markdown إلى HTML ثابت، وينسخ رسوم SVG ذات الإصدارات، وينشئ البحث وخريطة الموقع وRSS ومخرجات القراءة الآلية. ولا ينسخ ops/ أو بيانات الاعتماد أو جذر المستودع إلى الموقع العام.
لا يستخدم الموقع قاعدة بيانات أو بيئة تشغيل مدفوعة. ولا يلزم اشتراك Sites. ويمكن تقديم المخرجات المبنية عبر مضيف ثابت عادي.
إعداد Vercel
يحدد vercel.json في جذر المستودع مجلد المخرجات site وأمر البناء. استورد المستودع بإعداد الإطار Other، واجعل جذر المستودع جذرًا للبناء. يجب تقديم site/ فقط، لا جذر المستودع. يحتاج البناء إلى الجذر لقراءة docs/ وbrand/.
خطة Vercel Hobby ليست ترخيصًا تجاريًا. اختر خطة مناسبة أو مضيفًا ثابتًا آخر؛ لا توجد هنا موافقة على تغيير الفوترة. noindex ليس مصادقة. استخدم حماية النشر للمراجعة الخاصة. [1]
GitBook المجاني
يمكن لـ GitBook Free/Basic نشر توثيق عام على نطاقه، ويتضمن Git Sync ومخرجات قابلة للقراءة آليًا. النطاقات المخصصة والهوية المتقدمة تتطلب الخطط المناسبة. لا تحتاج مساحة غير منشورة إلى مصادقة زوار مدفوعة لمجرد إبقاء المسودات خاصة. [2]
النطاقات والروابط الاجتماعية
الأصل المختار هو proof21.xyz. لا تضبط DNS إلا بعد وجود مشروع استضافة، وبالقيم الخاصة به، مع الحفاظ على سجلات البريد والتحقق. نطاق .ai مخطط وغير مؤكد.
تبقى وجهتا X وLinkedIn فارغتين حتى يزود المالك روابط دقيقة. GitHub لا يزال خاصًا؛ تصرح روابط المعاينة بذلك وتخفي النسخ العامة رابط المصدر الخاص. لا يُستخدم رابط محرر GitBook وجهة للتوثيق العام.