منصوبے کے بارے میں

اس ریپوزٹری میں ایپاچی ڈوریس کی سرکاری ویب سائٹ، doris.apache.org کا سورس کوڈ شامل ہے۔ یہ جدید اسٹیٹک سائٹ جنریٹر Docusaurus 3 سے تیار کیا گیا ہے۔ ## مواد - **دستاویزات**: انگریزی اور چینی (zh-CN) دستاویزات، متعدد ورژنز (current/dev, 4.x, 3.x, 2.1) - **بلاگ**: پروجیکٹ خبریں اور اعلانات - **کمیونٹی**: حصہ ڈالنے کے طریقہ کار اور کمیونٹی وسائل - **ری ایکٹ کمپوننٹس**: `src/` ڈائریکٹری میں حسب ضرورت صفحات اور UI عناصر ## ٹیکنالوجی اسٹیک - Docusaurus 3 (اسٹیٹک سائٹ جنریٹر) - Node.js >= 18 - Yarn پیکج مینجر - React پر مبنی کمپوننٹس ## مقامی ترقی ایک مددگار اسکرپٹ (`local_dev.sh`) مقامی طور پر سائٹ چلانے کو آسان بناتا ہے: ```bash # انگریزی ڈیو سرفر شروع کریں ./local_dev.sh # چینی ڈیو سرفر شروع کریں ./local_dev.sh start-zh # حسب ضرورت پورٹ ./local_dev.sh start --port 8080 # پروڈکشن بلڈ (انگریزی + چینی) ./local_dev.sh build-all ``` بڑی بلڈز کے لیے `NODE_OPTIONS=--max-old-space-size=8192` سے میموری بڑھائی جا سکتی ہے۔ ## ورژننگ دستاویزات کو `docs/` (current) اور `versioned_docs/` (محفوظ شدہ ورژنز) کے تحت ہر ریلیز لائن کے لیے الگ ڈائریکٹریز کے ساتھ ورژن دیا گیا ہے۔ سائیڈ بارز `sidebars.ts` اور `versioned_sidebars/` میں ورژن وار علیحدہ منظم ہیں۔ ## کثیر اللسانی سپورٹ سائٹ انگریزی اور سادہ چینی کی حمایت کرتی ہے۔ چینی ترجمے `i18n/zh-CN/` کے تحت موجود ہیں۔ ایڈیٹنگ کے دوران عام طور پر دونوں زبانوں کے ورژنوں میں ترمیم کی ضرورت ہوتی ہے۔ ## ڈائریکٹری ساخت - `docs/` — موجودہ انگریزی دستاویزات - `versioned_docs/` — ورژن وار محفوظ شدہ انگریزی دستاویزات - `i18n/zh-CN/` — اوپر دی گئی ساخت کے مطابق چینی ترجمے - `blog/` — مارک ڈاؤن بلاگ پوسٹس - `community/` — کمیونٹی دستاویزات - `src/` — ری ایکٹ کمپوننٹس اور حسب ضرورت صفحات - `static/` — اسٹیٹک اثاثے (تصاویر، CSS، JS) ## CI / ڈپلائمنٹ گِٹ ہب ایکشنز خودکار بلڈز کو سنوارتی ہیں: - ڈوریس ماسٹر برانچ سے روزانہ cron ڈپلائمنٹ - مخصوص برانچز کے لیے مینول ڈپلائمنٹ ورک فلو - پل ریکویسٹس پر بلڈ تصدیق ## حصہ ڈالنا حصہ ڈالنے کے طریقہ کار ڈوریس ویب سائٹ پر دستیاب ہیں، جن میں دستاویزاتی فارمیٹ کے معیارات اور عمومی حصہ ڈالنے کے عمل شامل ہیں۔