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

مارک ڈاؤن ویور (بائنری نام `mdv`) ایک لوکل مارک ڈاؤن ویور اور فائل براؤزر ہے جو ایک ہی بائنری کے طور پر تقسیم کیا جاتا ہے۔ یہ مارک ڈاؤن فائلوں کی ایک ڈائریکٹری کو لوکل HTTP ایڈریس پر پیش کرتا ہے اور دو پین والا انٹرفیس پیش کرتا ہے: بائیں جانب ایک قابل توسیع، مستقل فائل ٹری اور دائیں جانب رینڈر شدہ مواد۔ رینڈرنگ میں گٹ ہب فلیورڈ مارک ڈاؤن کو گٹ ہب جیسے اسٹائلنگ، نحو ہائی لائٹڈ کوڈ بلاکس، اور بنڈل میرمیڈ ڈایاگرام سپورٹ کے ساتھ شامل کیا گیا ہے۔ تمام UI اثاثے — CSS، JavaScript اور HTML ٹیمپلیٹس — بائنری میں ایمبیڈ ہیں، لہذا کسی بیرونی انحصار یا علیحدہ تنصیب کے مراحل کی ضرورت نہیں ہے۔ سیکیورٹی ڈیفالٹس میں ڈائریکٹری ٹراورسل تحفظ اور XSS کے خلاف HTML صفائی شامل ہے۔ شٹ ڈاؤن UI سے یا Ctrl+C کے ساتھ متحرک کیا جا سکتا ہے۔ تنصیب ریلیز پیج سے ہدف پلیٹ فارم کے لیے `mdv` بائنری ڈاؤن لوڈ کرکے، آرکائیو نکال کر اور بائنری کو PATH پر رکھ کر کی جاتی ہے۔ کنفیگریشن `config.json` فائل یا کمانڈ لائن فلیگ سے آ سکتی ہے، جس میں درج ذیل ترجیح ہے (بعد والا پہلے والے کو اوور رائڈ کرتا ہے): بلٹ ان ڈیفالٹس، `$HOME/.config/mdv/config.json`، موجودہ ورکنگ ڈائریکٹری میں `config.json`، `MDV_` سے شروع ہونے والے ماحولیاتی متغیرات (مثال کے طور پر `MDV_PORT=9000`)، اور آخر میں کمانڈ لائن فلیگ۔ ایک `config.json.example` بطور حوالہ فراہم کیا گیا ہے۔ استعمال یہ ہے کہ مارک ڈاؤن فائلوں والی کسی بھی ڈائریکٹری سے `mdv` چلائیں اور براؤزر میں `http://127.0.0.1:8080` کھولیں۔ فلیگ میں `-p, --port` (ڈیفالٹ 8080)، `-o, --open` براؤزر خود بخود کھولنے کے لیے، `-d, --dir` روٹ ڈائریکٹری سیٹ کرنے کے لیے (ڈیفالٹ `.`)، اور `--version` شامل ہیں۔ سورس سے بنانے کے لیے Go 1.24 یا بعد کے ورژن کی ضرورت ہے۔ Make اہداف میں موجودہ پلیٹ فارم کے لیے `build`، کراس کمپائلیشن کے لیے `build-all`، زپ آرکائیوز بنانے کے لیے `package`، `test`، اور `clean` شامل ہیں۔ ہدف پلیٹ فارمز linux/amd64، linux/arm64، darwin/arm64 اور windows/amd64 ہیں؛ macOS بلڈز صرف arm64 ہیں، جبکہ Intel Macs سورس سے بنا سکتے ہیں۔ ریپوزٹری میں CHANGELOG.md اور NOTICE.md بھی شامل ہیں جس میں تیسرے فریق کے لائسنس انتسابات ہیں۔