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

یہ ریپوزٹری ایک ذاتی بلاگ اور ویب سائٹ کے سورس کو محفوظ رکھتی ہے جسے Jekyll اور Chirpy تھیم کے ساتھ ایک اسٹیٹک سائٹ کے طور پر تیار کیا گیا ہے۔ سائٹ کو GitHub Pages کے ذریعے شائع کیا گیا ہے، اور README مین سائٹ، ایک علیحدہ ڈویلپمنٹ/پریویو ڈیپلائمنٹ، اور ایک بیرونی ڈاکومنٹیشن انڈیکس کی نشاندہی کرتا ہے۔ مواد کی تنظیم بلاگ کئی تاریخی ذرائع سے پوسٹس اکٹھی کرتا ہے، بشمول موجودہ سائٹ، Kubernetes سے متعلق GitHub Pages سائٹس کا ایک گروپ، اور دو پرانے Linux پر مبنی بلاگز جن کا مواد 2009 تک جاتا ہے۔ README ذرائع اور سال کے لحاظ سے پوسٹس کی تقسیم کی فہرست فراہم کرتا ہے، اور ہر ذریعے کے ساتھ 14 کیٹیگریز اور 55 ٹیگز کی فہرست دیتا ہے۔ بار بار آنے والے موضوعات میں Linux، Kubernetes، نیٹ ورکنگ، کلاؤڈ، سیکیورٹی، DevOps، OpenWrt، ورچوئلائزیشن، اسٹوریج، Android، فوٹوگرافی اور Windows شامل ہیں۔ ٹیگ کاؤنٹس ظاہر کرتے ہیں کہ کون سے موضوعات سب سے زیادہ ظاہر ہوتے ہیں، جیسے کہ kubernetes، amazon-eks، security، eksctl، bash، cert-manager، wifi اور pxe۔ کیٹیگری اور ٹیگ انڈیکس صفحات تیار کیے گئے ہیں تاکہ پوسٹس کو موضوع کے لحاظ سے براؤز کیا جا سکے۔ تھیمنگ اور سائٹ جنریشن سائٹ اوپن سورس Chirpy تھیم پر مبنی ہے، اور README تھیم ریپوزٹری اور ایک ساتھی سائٹ دونوں کے لنکس فراہم کرتا ہے جو اسے استعمال کرنے کے لیے تجاویز اور بہترین طریقوں کی وضاحت کرتی ہے۔ بلڈ اور کوالٹی ٹولنگ لوکل بلڈز کو ایک کنٹینر میں دوبارہ تیار کیا جا سکتا ہے: دستاویزی کمانڈ بلڈ ٹولنگ، Ruby اور Bundler انسٹال کرتی ہے، پھر bundle install اور jekyll build چلاتی ہے جس کا آؤٹ پٹ public ڈائریکٹری کی طرف بھیجا جاتا ہے۔ Linting کو MegaLinter کے ذریعے سنبھالا جاتا ہے، جسے کوڈ بیس کی توثیق کے جھنڈے (flag) کے ساتھ چلایا جا سکتا ہے۔ دو GitHub Actions ورک فلو اسٹیٹس بیجز کے ذریعے ظاہر کیے گئے ہیں: ایک کوڈ بیس کی linting کے لیے اور دوسرا GitHub Pages پر بلڈ اور ڈیپلائے کرنے کے لیے۔ پروجیکٹ OpenSSF Scorecard اور OpenSSF Best Practices بیجز بھی دکھاتا ہے، جو سپلائی چین اور پروجیکٹ ہیلتھ پروگراموں میں شرکت کی نشاندہی کرتے ہیں۔ ٹیسٹنگ کنونشنز README ایک کنٹینر پر مبنی ٹیسٹ کمانڈ کی دستاویز فراہم کرتا ہے جو یوٹیلیٹیز اور Docker انسٹال کرتا ہے، اضافی پلگ انز اور ٹاسکس کے ساتھ mise ٹول مینیجر سیٹ اپ کرتا ہے، اور پھر پوسٹ تخلیق کا ٹاسک کال کرتا ہے۔ فینسڈ کوڈ بلاکس (fenced code blocks) کے بارے میں ایک کنونشن کنٹرول کرتا ہے کہ پوسٹ ٹیسٹ ورک فلو میں کیا ہوتا ہے: bash کے طور پر نشان زدہ کوڈ بلاکس تخلیق کے مرحلے کے دوران چلائے جاتے ہیں، sh کے طور پر نشان زدہ بلاکس کلین اپ یا ڈسٹرائے مرحلے کے دوران چلائے جاتے ہیں، اور shell کے طور پر نشان زدہ بلاکس صرف رینڈر شدہ صفحات پر دکھائے جاتے ہیں اور کبھی نہیں چلائے جاتے۔ یہ ٹیوٹوریل اسٹائل کی پوسٹس کو رن ایبل سیناریوز کے طور پر استعمال کرنے کی اجازت دیتا ہے۔ نوٹس اور حدود یہ ریپوزٹری ایک ویب سائٹ اور مواد کا پروجیکٹ ہے نہ کہ کوئی دوبارہ استعمال کے قابل ایپلی کیشن یا لائبریری۔ اس کی دستاویزی صلاحیتیں اسٹیٹک سائٹ جنریشن، مواد کی درجہ بندی، کنٹینر پر مبنی بلڈز، linter کنفیگریشن، CI ورک فلو اور پوسٹس کے اندر کنونشن پر مبنی کمانڈ ایگزیکیوشن تک محدود ہیں۔