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

nfuwari Lucius7 کے بلاگ (blog.lucius7.cn) کے لیے سورس ریپوزٹری ہے، جو Astro کے Fuwari تھیم پر بنایا گیا ایک ذاتی سائٹ ہے اور GitHub Pages پر ڈیپلائے کی گئی ہے۔ چینی اور انگریزی مواد کو الگ رکھا گیا ہے۔ پوسٹس src/content/posts/zh/ اور src/content/posts/en/ کے تحت موجود ہیں، جن میں سے ہر ایک کی اپنی فہرستیں، کیٹیگری اور ٹیگ کاؤنٹ، پوسٹ نیویگیشن، RSS فیڈ اور سرچ انڈیکس ہے، اور روٹ URL /zh/ پر ری ڈائریکٹ ہوتا ہے۔ انٹرفیس کی تحریریں src/i18n/ میں ہیں، About صفحات ہر زبان کے لیے src/content/spec/ کے تحت ہیں، اور ترجمے یکساں رشتہ دار راستوں (relative paths) یا translationKey کے ذریعے منسلک کیے جا سکتے ہیں، جبکہ لینگویج سوئچر ٹارگٹ زبان کے ہوم پیج پر واپس جاتا ہے۔ تحریر Markdown پر مبنی ہے۔ ایک جنریٹر اسکرپٹ (pnpm new-post zh/name یا pnpm new-post en/name) ایک ڈرافٹ بناتا ہے جس میں frontmatter ڈیفالٹس شامل ہیں جیسے lang: zh_CN یا lang: en؛ پوسٹس ڈیفالٹ طور پر draft: true ہوتی ہیں اور صرف مقامی ڈویلپمنٹ میں نظر آتی ہیں، کیونکہ پروڈکشن بلڈز میں ڈرافٹس شامل نہیں ہوتے۔ Frontmatter فیلڈز اور ویلیڈیشن src/content/config.ts میں بیان کیے گئے ہیں۔ ریاضی کی سپورٹ remark-math اور rehype-katex کے ذریعے فراہم کی گئی ہے، جس کے اسٹائلز اور فونٹس سائٹ کے ساتھ آتے ہیں۔ پڑھنے والوں کے لیے لائٹ اور ڈارک تھیمز، کیٹیگریز، ٹیگز، Pagefind سرچ، RSS اور sitemap آؤٹ پٹ دستیاب ہیں۔ سائٹ کی شناخت، تھیم کا رنگ، پروفائل، نیویگیشن، سوشل لنکس اور پوسٹ لائسنس src/config.ts میں کنفیگر کیے گئے ہیں، جبکہ بینر امیج، اوتار (ایک Tencent QQ اوتار اینڈ پوائنٹ)، سائٹ آئیکن اور فوٹر رجسٹریشن لنک بھی وہاں یا public/ اور src/assets/ کے ذریعے کنفیگر کیے جا سکتے ہیں۔ دو اختیاری ڈیش بورڈ فیچرز مصنف کی OJFlare پبلک API سے ڈیٹا پڑھتے ہیں: ایک سائیڈ بار وجیٹ جو تازہ ترین تین منظور شدہ Codeforces/AtCoder سبمیشنز دکھاتا ہے، اور About صفحات پر ایک AC کنٹریبیوشن کیلنڈر جو problemId کے ذریعے منظور شدہ ہسٹری کو ڈی ڈپلیکیٹ کرتا ہے، Asia/Taipei (UTC+8) تاریخیں استعمال کرتا ہے، اور سال اور پلیٹ فارم فلٹرز فراہم کرتا ہے۔ دونوں ایک ہی پولنگ لوپ شیئر کرتے ہیں، صفحہ نظر آنے کے دوران ہر پانچ منٹ بعد ریفریش ہوتے ہیں، ریفریش ناکام ہونے پر پہلے سے لوڈ شدہ ریکارڈز کو برقرار رکھتے ہیں، اور انہیں کنفیگ میں ڈس ایبل کیا جا سکتا ہے؛ بلاگ کی بلڈ API کی دستیابی پر منحصر نہیں ہے۔ ٹولنگ میں ڈرافٹ بشمول پری ویو کے لیے pnpm dev، pnpm lint، Astro/Svelte/TypeScript چیکنگ کے لیے pnpm check، pnpm build (جو Pagefind انڈیکس بھی بناتا ہے) اور بلٹ سائٹ کے لیے pnpm preview شامل ہیں۔ ٹیسٹ اسکرپٹس لائیو سروسز سے رابطہ کیے بغیر لینگویج روٹنگ، MacFlare ایکٹیویٹی وجیٹ اور OJFlare پارسنگ کی جانچ کرتے ہیں۔ GitHub Actions مین برانچ کی اپ ڈیٹس پر اسٹائل چیکس، ٹائپ چیکس، بلڈ اور ڈیپلائمنٹ چلاتا ہے، جسے GitHub Pages پر شائع کیا جاتا ہے، جس کی کسٹم ڈومین Alibaba Cloud ESA کے ذریعے فراہم کی جاتی ہے اور CNAME فائل میں ریکارڈ کی گئی ہے۔ Dependabot ہفتہ وار npm اور GitHub Actions کی جانچ کرتا ہے۔ تحریر، دو لسانی مواد، LaTeX، ڈیپلائمنٹ اور ڈیپینڈینسی ریویو کے لیے گائیڈز docs/ کے تحت موجود ہیں، اور پروجیکٹ کوڈ MIT لائسنس اور اپ اسٹریم ایٹریبیوشن کو برقرار رکھتا ہے۔