تھیم کا ابتدائی سیٹ اپ

1. شروع کرنے کے لیے پہلے npm install یا pnpm install کے ذریعے تمام ضروری پیکجز انسٹال کریں، پھر npm run build یا pnpm build چلا کر ابتدائی بلڈ بنائیں تاکہ یہ یقینی ہو جائے کہ سیٹ اپ درست کام کر رہا ہے۔
2. سائٹ کی تلاش کے لیے Pagefind بلڈ کو کاپی کریں تاکہ وہ ڈیو ماحول میں دستیاب ہو۔ یہ آپ کے آپریٹنگ سسٹم کے مطابق مختلف ہوتا ہے۔ میں نے مدد کے لیے چند کمانڈز بنائی ہیں۔
   • Windows کے لیے npm run winsearch چلائیں
   • OSX یا Linux کے لیے npm run osxsearch چلائیں
3. اس کے بعد آپ اپنی سائٹ کا i18n سیٹ اپ کنفیگر کرنا چاہیں گے (ایک زبان یا کئی زبانیں)۔ بس npm run docs:config-i18n کمانڈ چلائیں اور سیٹ اپ مکمل کرنے کے لیے اسکرپٹ کی ہدایات پر عمل کریں!
4. اب آپ سائٹ کو اپنی پسند کے مطابق ترتیب دے سکتے ہیں!

کوڈ کا تعارف

میں نے چند کوڈ ٹورز بنائے ہیں جو آپ کو کوڈبیس سے متعارف کرانے میں مدد دیں گے۔ انہیں VSCode یا کسی دوسرے IDE میں دیکھنے کے لیے آپ کو Code Tour ایکسٹینشن کی ضرورت ہو گی۔

کوڈ کی ساخت

کوڈ اس طرح ترتیب دیا گیا ہے کہ زیادہ تر اجزاء src/docs ڈائریکٹری کے تحت آتے ہیں۔ اس سے پورے فولڈر کو کسی موجودہ پروجیکٹ میں شامل کرنا اور چند منٹ میں دستاویزات کی فعالیت جوڑنا آسان ہو جاتا ہے۔

کنفیگریشن کے اختیارات

سائٹ کی مجموعی کنفیگریشن src/docs/config/ فولڈر میں کی جاتی ہے۔ زیادہ تر سیٹنگز الگ الگ زبان کے فولڈروں کے اندر ہوتی ہیں تاکہ ترجموں کو سنبھالنا آسان رہے۔

سائٹ سیٹنگز

src/docs/config/siteSettings.json.ts فائل سائٹ کی سیٹنگز کنفیگر کرنے کے لیے استعمال ہوتی ہے۔ ان میں یہ چیزیں شامل ہیں کہ ویو ٹرانزیشنز فعال کرنی ہیں یا نہیں، اینیمیشنز فعال کرنی ہیں یا نہیں، اور دستاویزات کی سرخیوں کے لیے لنک کاپی کرنے کے بٹن دکھانے ہیں یا نہیں۔

سائٹ ڈیٹا

src/docs/config/[language]/siteData.json.ts فائل سائٹ کا ڈیٹا کنفیگر کرنے کے لیے استعمال ہوتی ہے۔ اس میں سائٹ کا عنوان، تفصیل، سوشل لنکس اور ڈیفالٹ تصویر جیسی چیزیں شامل ہیں۔

نیویگیشن ڈیٹا

اوپر والے نیو بار کے لیے اپنا نیویگیشن ڈیٹا src/docs/config/[language]/navData.json.ts فائل میں کنفیگر کریں۔

سائیڈبار لے آؤٹ

اپنے دستاویزی حصوں کی ترتیب src/docs/config/[language]/sidebarNavData.json.ts فائل میں کنفیگر کریں۔

روبوٹس

تاکہ Google جیسے روبوٹس درست سائٹ میپ دیکھ سکیں، آپ public/robots.txt فائل میں ترمیم کر کے اپنی ویب سائٹ کا ڈومین درج کرنا چاہیں گے۔

مزید وسائل

Astro کے بارے میں عمومی معلومات

Astro src/pages/ ڈائریکٹری میں .astro یا .md فائلیں تلاش کرتا ہے۔ ہر صفحہ اپنی فائل کے نام کی بنیاد پر ایک روٹ کے طور پر پیش کیا جاتا ہے۔

src/components/ میں کوئی خاص بات نہیں، لیکن ہم Astro/React/Vue/Svelte/Preact کے کمپوننٹس وہیں رکھنا پسند کرتے ہیں۔

کوئی بھی جامد اثاثے، جیسے تصاویر، public/ ڈائریکٹری میں رکھے جا سکتے ہیں۔ تصویر کی بہتری کے لیے Astro کے اثاثے استعمال کرتے وقت میں اکثر تصاویر کے لیے src/assets بھی استعمال کرتا ہوں۔

کمانڈز

تمام کمانڈز پروجیکٹ کی جڑ سے، ٹرمینل کے ذریعے چلائی جاتی ہیں:

کمانڈ	ایکشن
npm install	انحصارات انسٹال کرتی ہے
npm run dev	localhost:4321 پر مقامی ڈیو سرور شروع کرتی ہے
npm run build	آپ کی پروڈکشن سائٹ ./dist/ میں بلڈ کرتی ہے
npm run preview	ڈیپلائے کرنے سے پہلے آپ کے بلڈ کا مقامی پیش منظر دکھاتی ہے
npm run astro ...	astro add, astro check جیسی CLI کمانڈز چلاتی ہے
npm run astro -- --help	Astro CLI استعمال کرنے میں مدد فراہم کرتی ہے

مزید جاننا چاہتے ہیں?

بلا جھجک دستاویزات دیکھیں یا Discord سرور میں شامل ہو جائیں۔