منصوبے کے بارے میں
github-markdown-css ایک چھوٹا CSS پیکیج ہے جس کا بیان کردہ مقصد GitHub کے رینڈر شدہ Markdown پر لاگو ہونے والے بصری اسٹائل کو دوبارہ پیش کرنا ہے، جس میں کم سے کم مقدار میں CSS استعمال کیا گیا ہے۔ اسٹائل شیٹ ہاتھ سے ترمیم شدہ نہیں بلکہ تیار کی گئی ہے؛ README تعاون کو علیحدہ generate-github-markdown-css ریپوزٹری کی طرف بھیجتا ہے۔
استعمال سیدھا ہے: github-markdown.css درآمد کریں، اپنے رینڈر شدہ Markdown پر مشتمل کنٹینر میں markdown-body کلاس شامل کریں، اور چوڑائی مقرر کریں۔ README نوٹ کرتا ہے کہ GitHub 980px چوڑائی اور 45px پیڈنگ استعمال کرتا ہے، اور موبائل پر 15px پیڈنگ، اور box-sizing، min-width، max-width، margin auto، اور تنگ ویو پورٹس کے لیے میڈیا کوئری کے ساتھ ایک مثال فراہم کرتا ہے۔ prefers-color-scheme کے ذریعے ڈارک موڈ کا پس منظر رنگ بھی دکھایا گیا ہے۔
پیکیج سات تھیمز فراہم کرتا ہے: ایک ڈیفالٹ جو prefers-color-scheme کے ذریعے لائٹ اور ڈارک کے درمیان خودکار طور پر سوئچ کرتا ہے، صرف لائٹ، صرف ڈارک، ڈارک ڈِمڈ، ڈارک ہائی کنٹراسٹ، ڈارک کلر بلائنڈ (پروٹانوپیا اور ڈیوٹیرانوپیا)، اور لائٹ کلر بلائنڈ ویرینٹس۔
ان اسٹائلز سے مماثل HTML کے لیے، README GitHub کے /markdown API کا مشورہ دیتا ہے، جو وہ HTML تیار کرتا ہے جو GitHub خود بناتا ہے۔ یہ نوٹ کرتا ہے کہ دیگر Markdown پارسرز زیادہ تر اسٹائلز کے ساتھ بھی کام کریں گے، اور کوڈ ہائی لائٹنگ کے لیے starry-night کی سفارش کرتا ہے جو GitHub کی نقل کرتا ہے۔
انسٹالیشن کے اختیارات میں فائل کو دستی طور پر ڈاؤن لوڈ کرنا، CDNJS استعمال کرنا، یا npm install github-markdown-css شامل ہیں۔ ایک ڈیمو صفحہ منسلک ہے۔
ٹربل شوٹنگ نوٹ وضاحت کرتا ہے کہ اسٹائلنگ کے مسائل جیسے ڈارک موڈ میں ٹیبل کے فونٹس کا سیاہ ہونا براؤزر کے کوئرکس موڈ میں جانے کی وجہ سے ہو سکتا ہے؛ صفحے کے اوپری حصے میں doctype شامل کرنے سے اس سے بچا جا سکتا ہے۔ ڈیولپمنٹ کے لیے، npm run make CSS کو اپ ڈیٹ کرتا ہے۔
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.