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

Quartz ایک static-site generator ہے جس کا بیان کردہ مقصد لوگوں کو ان کے ڈیجیٹل گارڈن اور نوٹس کو بغیر کسی قیمت کے ویب سائٹ کے طور پر شائع کرنے میں مدد کرنا ہے۔ اس کے README کے مطابق، یہ ٹولز کا ایک مجموعہ ہے جو Markdown مواد کو لیتا ہے اور اسے ایک مکمل فعال سائٹ میں تبدیل کر دیتا ہے۔ پروجیکٹ کی اپنی دستاویزات میں درج تفصیلات: - **ان پٹ اور آؤٹ پٹ**: Markdown مواد ذریعہ ہے، اور نتیجہ ایک فعال static website ہے۔ README ورک فلو کو ڈائنامک ایپلی کیشن سرور چلانے کے بجائے نوٹس شائع کرنے کے گرد ترتیب دیتا ہے۔ - **پوزیشننگ**: پروجیکٹ اپنی تعریف تیز رفتار اور "batteries-included" کے طور پر کرتا ہے، جس کا اشارہ یہ ہے کہ اس کا مقصد وہ تمام ضروری حصے فراہم کرنا ہے جن سے سائٹ چل سکے، بجائے اس کے کہ الگ الگ اجزاء سے وسیع اسمبلی کی ضرورت ہو۔ - **ڈیجیٹل گارڈنز**: اس کی ترتیب رچرڈ ہیمنگ کے کھلے دروازے کے ساتھ کام کرنے کے حوالے سے قول نقل کرتی ہے، اور نیٹ ورکڈ تھوٹ (networked thought) پر مصنف کی تحریروں کا لنک دیتی ہے، جس سے یہ واضح ہوتا ہے کہ اس کا مطلوبہ استعمال صرف روایتی بلاگ شائع کرنا نہیں بلکہ آپس میں جڑے ہوئے، ارتقاء پذیر ذاتی علم کو پیش کرنا ہے۔ - **ورژن**: README کا عنوان Quartz v5 ہے، جو ایک فعال ورژن ریلیز لائن کی نشاندہی کرتا ہے۔ - **دستاویزات**: quartz.jzhao.xyz پر ایک مخصوص ڈاکومنٹیشن سائٹ کو نقطہ آغاز کے طور پر دیا گیا ہے، لہذا انسٹالیشن اور کنفیگریشن کی تفصیلات ریپوزٹری README سے باہر رکھی گئی ہیں۔ - **کمیونٹی**: کمیونٹی بحث اور سپورٹ کے لیے ایک Discord سرور کا لنک دیا گیا ہے۔ - **فنڈنگ**: اسپانسرز سیکشن GitHub اسپانسرز کا اعتراف کرتا ہے، اور README میں ایک اسپانسر گرافک شامل ہے۔ یہ کن لوگوں کے لیے موزوں ہو سکتا ہے: وہ لکھاری، محققین اور ڈویلپرز جو Markdown میں نوٹس رکھتے ہیں اور انہیں ایک براؤز ایبل سائٹ کے طور پر شائع کرنا چاہتے ہیں، خاص طور پر وہ جو نوٹس کے درمیان ڈیجیٹل گارڈن اسٹائل لنکنگ میں دلچسپی رکھتے ہیں۔ چونکہ آؤٹ پٹ ایک static site ہے، اس لیے یہ عام طور پر مفت یا کم لاگت والی static hosting کے ساتھ ہم آہنگ ہے، اگرچہ README خود ہوسٹنگ کے اختیارات کی تفصیل نہیں دیتا۔ وہ باتیں جو README سے واضح نہیں ہیں: مخصوص فیچرز جیسے سرچ، گراف ویوز، بیک لنکس، تھیمز، پلگ انز یا ڈیپلائمنٹ ٹارگٹس یہاں شمار نہیں کیے گئے، اور کوئی پرفارمنس بینچ مارکس یا موازنہ فراہم نہیں کیا گیا ہے۔ ان تفصیلات پر بھروسہ کرنے سے پہلے لنک شدہ دستاویزات میں ان کی تصدیق کی جانی چاہیے۔ اسی طرح، لائسنسنگ، سپورٹڈ Markdown extensions اور بلڈ ریکوائرمنٹس فراہم کردہ متن میں بیان نہیں کی گئی ہیں۔