الانتقال إلى المحتوى الرئيسي
لتوفير الوقت وبناء بيئة التطوير بسرعة، نوفّر إصدارًا آخر من إعدادات بيئة التطوير، وهو GitHub Codespace.

دليل الإعداد

1

إنشاء Codespaces

انقر على الزر التالي لإنشاء codespace سحابية لتطوير server-pro.Open in GitHub Codespacesيُنصح باختيار نوع جهاز (Machine Type) بـ 4 أنوية على الأقل. للحصول على أنواع أجهزة أكبر، يمكنك تقديم طلب إلى فريق الدعم الرسمي لـ GitHub عبر فتح تذكرة من هنا.
2

تشغيل سكربت الإعداد

ستحتاج إلى الانتظار بصبر حتى يتم إنشاء الـ codespace. بعد أن تتمكن من الوصول إلى الطرفية (Terminal)، شغّل الأمر التالي:
يسحب bin/setup الصور ويشغّل الخدمات، ثم يطبّق bin/i18n ترجمات وحدات Ayakaleaf Pro التي لا تحتويها ملفات اللغات الملتزَم بها، راجع تحديث ترجمات i18n.
يتيح لك هذا السكربت (bin/setup) إعداد بيئة التطوير على أحدث commit في الفرع server-pro في أقصر وقت ممكن. وقد لا يكون مناسبًا للإصدارات الأقدم أو الفروع الأخرى.نقوم ببناء صورة Docker الخاصة بالتطوير يوميًا باستخدام GitHub Action.
3

الوصول إلى Launchpad

انتقل إلى علامة تبويب المنافذ، وسترى قائمة بمنافذ الويب المتاحة. انقر على المنفذ 80 (وهو OVERLEAF_PORT في develop/dev.rc). يُفترض أن ترى الآن صفحة launchpad. تعمل Mailpit وGrafana وMongo Express وRedisInsight على مسارات المنفذ نفسه (/mailpit/ و/grafana/ و/mongo-express/ و/redis-insight/)، وتشير إليها قائمة Dev tools في الموقع بعد تسجيل الدخول. وحدة تحكم RustFS على المنفذ 9001 وHoppscotch على 9170، راجع المنافذ.
سترى:
4

استمتع بالتطوير

حان دورك الآن! ابدأ ببناء ميزتك الرائعة. يشغّل bin/setup بالفعل كل خدمة في وضع التطوير (node --watch، مثل bin/dev)، لذا تظهر تغييرات الكود دون أي أمر إضافي.بعد تغيير develop/dev.rc، شغّل bin/setup مجددًا: فهو يمر عبر bin/docker-compose الذي يضيف ملفات الميزات المفعّلة.
لا تشغّل الخدمات يدويًا باستخدام docker compose -f docker-compose.yml -f docker-compose.dev.yml -f docker-compose.image.yml up. فهذا يتخطى ملفات الميزات في dev.rc، فتُعاد إنشاء web وfilestore وhistory-v1 دون إعدادات RustFS وتعود إلى وحدات تخزين محلية لا تحتوي على سجل مشاريعك وملفاتها الثنائية.
آخر تعديل في ٢٠ نوفمبر ٢٠٢٦