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

escaping ایک مضبوط رائے (opinionated) رکھنے والا پرسنل سائٹ جنریٹر ہے، جس کا بنیادی تصور GitHub Issues کو فوری رینڈرنگ کے ڈیٹا کے بجائے ڈیٹرمینسٹک کمپائلیشن کے ان پٹ کے طور پر دیکھنا ہے۔ یہ مواد کی تجزیہ کاری (parsing)، روٹنگ الاٹمنٹ، HTML پیوریفیکیشن اور پروڈکٹ ویریفکیشن جیسے مرحلہ وار پائپ لائنز کے ذریعے Issues کو مکمل اسٹیٹک ویب سائٹس میں کمپائل کرتا ہے۔ اس کی اہم صلاحیتوں میں شامل ہیں: 1. مواد کا انتظام: لیبلز اور front matter والے GitHub Issues سے Blog، Ideas اور About صفحات کا مواد نکالنے کی حمایت کرتا ہے۔ 2. سائٹ ماڈل: ہوم پیج، آرکائیو پیجز، ڈیٹیل پیجز، پروجیکٹ پیجز، ٹیگ پیجز کے ساتھ ساتھ Atom feed، sitemap اور robots.txt جیسے SEO پروڈکٹس یکساں طور پر تیار کرتا ہے۔ 3. تھیم سسٹم: متعدد بلٹ ان تھیمز (جیسے geoqiao.me, Escape1, Escape2, Quiet) فراہم کرتا ہے اور مقامی طور پر کسٹم تھیمز لوڈ کرنے کی حمایت کرتا ہے۔ 4. سیکیورٹی میکانزم: اس میں Markdown HTML وائٹ لسٹ، سخت URL ویریفیکیشن، آؤٹ پٹ ڈائریکٹری کی حدود اور Jinja آٹو-ایسکیپنگ شامل ہے۔ 5. اشاعت کا عمل: ایک مرحلہ وار اشاعت میکانزم استعمال کرتا ہے، جہاں نئے پروڈکٹس کو staging ماحول میں تصدیق کے بعد، ڈائریکٹری رینیمنگ کے ذریعے آفیشل آؤٹ پٹ سے تبدیل کیا جاتا ہے، جو رول بیک کی حمایت کرتا ہے۔ اس ٹول کے لیے Python 3.11+ ماحول درکار ہے، اور ڈیپینڈینسی مینجمنٹ کے لیے uv استعمال کرنے کی سفارش کی جاتی ہے۔ یہ جنریٹر لاجک کو سائٹ کنفیگریشن سے الگ کرتا ہے، جس سے صارفین کو ایک آزاد ریپوزٹری میں سائٹ کنفیگریشن اور مواد برقرار رکھنے کی اجازت ملتی ہے۔