عن المشروع
هذا المستودع يحتوي على شفرة المصدر لموقع ويب Apache Doris الرسمي، المستضاف على doris.apache.org. يتم بناؤه باستخدام Docusaurus 3، وهو مولد مواقع ثابتة حديث.
ما يحتويه
- **التوثيق**: توثيق إنجليزي وصيني (zh-CN) عبر إصدارات متعددة (الحالي/dev، 4.x، 3.x، 2.1)
- **المدونة**: أخبار المشروع وإعلاناته
- **المجتمع**: إرشادات المساهمة وموارد المجتمع
- **مكونات React**: صفحات مخصصة وعناصر واجهة مستخدم في دليل `src/`
مكدس التكنولوجيا
- Docusaurus 3 (مولد مواقع ثابتة)
- Node.js >= 18
- مدير حزم Yarn
- مكونات مبنية على React
التطوير المحلي
يُسهِّل نص المساعدة (`local_dev.sh`) تشغيل الموقع محليًا:
# Start English dev server
./local_dev.sh
# Start Chinese dev server
./local_dev.sh start-zh
# Custom port
./local_dev.sh start --port 8080
# Production build (English + Chinese)
./local_dev.sh build-all
يمكن زيادة الذاكرة عبر `NODE_OPTIONS=--max-old-space-size=8192` للبناءات الكبيرة.
الإصدار
يتم إصدار التوثيق عبر دليلين منفصلين لكل خط إصدار تحت `docs/` (الحالي) و`versioned_docs/` (الإصدارات المؤرشفة). تُدار الشريط الجانبي بشكل منفصل لكل إصدار في `sidebars.ts` و`versioned_sidebars/`.
الدعم متعدد اللغات
يدعم الموقع الإنجليزية والصينية المبسطة. توجد الترجمات الصينية تحت `i18n/zh-CN/`. عند التحرير، عادةً ما تحتاج إصدارات اللغتين إلى التحديث.
هيكل الدليل
- `docs/` — توثيق إنجليزي حالي
- `versioned_docs/` — توثيق إنجليزي مؤرشف حسب الإصدار
- `i18n/zh-CN/` — ترجمات صينية تتطابق مع الهيكل أعلاه
- `blog/` — منشورات مدونة بصيغة Markdown
- `community/` — توثيق المجتمع
- `src/` — مكونات React وصفحات مخصصة
- `static/` — أصول ثابتة (صور، CSS، JS)
CI / النشر
تتعامل GitHub Actions مع البناءات الآلية:
- نشر يومي عبر cron يتزامن مع فرع master الخاص بـ Doris
- سير عمل نشر يدوي للفروع المحددة
- التحقق من البناء عند طلبات السحب
المساهمة
تتوفر إرشادات المساهمة على موقع Doris، وتغطي مواصفات تنسيق التوثيق وعمليات المساهمة العامة.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.