ویرایش فایل‌های Markdown با استفاده از Markmon

۲۳ مرداد ، ۱۳۹۷

وقتی صحبت از درست کردن فایل‌های با فرمت md. میشود نیاز به رابط کاربری داریم تا بتوانیم به صورت پویا تغییرات اعمال شده روی آن‌ها را ببینیم Markmon این امکان را فراهم می‌کند در ادامه بیشتر توضیح می‌دهیم.

Markmon یک پکیج ساده جهت پیشنمایش پویا و به صورت real-time فایل‌های Markdown  برای ادیتور Sublime می‌باشد .

در تعریف دیگر Markmon پیش‌نمایش دهنده Pandoc( a universal document converter ) / Markdown با استفاده از مفسر سریع Mathjax می‌باشد.

( نمایی از Markmon )

نکته : Markmon خود تجزیه‌کننده‌ای ( parser ) ندارد.

ویژگی‌ها

۱. فایل Markdown خود را در ویرایشگر مورد‌ علاقه خود ویرایش کنید و به صورت لحظه‌ای بعد از ذخیره نتیجه‌اش را ببینید.

۲.میتوانید با هر وسیله‌ای که به اینترنت متصل هستید نتیجه را ببینید مانند گوشی موبایل.

۳. به طور اتوماتیک آخرین تغییرات برجسته ( Highlight ) می‌شوند.

۴. تفسیر سریع فایل شما به وسیله Mathjax بدون پیام‌های لودینگ و …

۵. ساپورت فایل‌های ارجاع شده لوکال مانند عکس‌ها.

پلاگین ادیتور Sublime

اگر میخواهید نتایج فایل‌های ‌Markdown به صورت پویا و در حال تایپ‌کردن ببینید باید پلاگین Sublime text 3 را نصب کنید برای اطلاعات بیشتر و نحوه نصب این پلاگین کلیک کنید.

 

( نمایی از نحوه عملکرد این پلاگین )

نحوه نصب Markmon

دستور زیر را در ترمینال وارد کنید :

npm install -g markmon

برای نصب در ویندوز : شما نیاز به کامپایلر و بعضی فایل‌های توسعه ( Headers ) دارید. آسان‌ترین راه برای نصب آن این است که Windows SDK 7.1 را نصب کنید و cmd را از محیط SDK Development Command line اجرا کنید و سپس دستور بالا را وارد کنید.( نکته‌‌ای که درباره نصب ‌‌‌SDK وجود دارد این است که گاهی هنگام نصب ارور‌های بی‌معنا می‌دهد پیشنهاد می‌کنیم برای راحتی نصب اگر در حال حاضر ‌MS Visual C++ 2010 redist روی سیستمتان نصب دارید آنرا پاک کرده و در زمانی دیگر اقدام به نصب آن کنید )

چگونگی استفاده از Markmon

 

Usage: node ./bin/markmon [filename]   --[Options]

       Options:    

          --port           Port to listen to              [default: 3000]        

          --command     Command to parse markdown to html    [default: "pandoc --mathjax -N -t HTML5"]

          --view           Command to execute after the server is setup         

          --projectdir    Root directory of your project, useful for local image resources     

          --stylesheet    Path to your custom stylesheet     

          --help            Get this help message

 

 

[localhost :[port این دستور یک لوکال‌ سرور برای شما ایجاد می‌‌‌کند و شما میتونید از طریق آن به html تولید‌شده روی مرورگرهایتان دسترسی داشته باشید.

برای مثال view-- برای سیستم عامل مکینتاش  به صورت "\view  " open\"http://localhost:3000--  میباشد که بعد از اینکه سرور راه‌اندازی شد صفحه را باز می‌کند.

این نکته را در نظر داشته باشید که لینک "http://localhost:3000" تا زمانی که سرور راه‌اندازی نشده و فایل Markdown توسط Markmon تفسیر نشده است چیزی نشان نمی‌دهد.

دستور (command) باید بتواند از طریق stdin  ورودی بگیرد و html را به خروجی stdout بدهد.

اگر هیچ فایل با نام مشخصی  به Markmon ندهید Markmon  در حالت Server mode اجرا می‌شود و میتواند با دستور PUT از ورودی گرفته و به حالت html درآورده و سپس html نهایی را به همه Socket ها بدهد.

 

 Markmon چگونه کار می‌کند؟

Markmon یک سرور تحت node.js اجرا می‌کند و فایل‌های Markdown  را در هر آپدیت کردن فایل شما ( ویرایش فایل و ذخیره آن ) با استفاده از Socket.io تفسیر کرده و به صورت بخش‌های html تبدیل کرده و میفرستد.

 

جمع بندی

Markmon ابزاری کارآمد تحت ادیتور موردنظر شما ( به صورت پیش‌فرض Sublime text editor ) می‌باشد و تحت تبدیلگر فرمت Pandoc کار می‌کند و میتواند فایل‌های با فرمت

Markdown (.md) Format  را برای شما تفسیر کرده و روی مرورگرتان نشان دهد.

 


میانگین آرا:
96.6% (6 نفر)
رای دهید:
مقالات مرتبط
مشاهده بیشتر...