| MDP(1) | General Commands Manual | MDP(1) |
نام (NAME)
mdp - ابزار ارائه مبتنی بر خط فرمان با قالب مارکداون
خلاصه دستور (SYNOPSIS)
mdp [OPTION]... [FILE]
توضیحات (DESCRIPTION)
دستور mdp یک برنامه خط فرمانی است که به شما امکان میدهد از FILE های با قالببندی مارکداون ارائههایی زیبا و شکیل بسازید.
استفاده از آن به سادگیِ نوشتن محتوای ارائه در ویرایشگر متن دلخواهتان و اجرای ارائه از طریق خط فرمان است.
گزینهها (OPTIONS)
کنترل ورودی (Input Control)
- FILE
- فایل ورودی که ارائه از آن خوانده میشود. اگر هیچ فایلی مشخص نشود، یا اگر نام فایل - باشد، ارائه از ورودی استاندارد خوانده خواهد شد.
کنترل خروجی (Output Control)
- -c, --nocodebg
- عدم تغییر رنگ پسزمینه بلوکهای کد.
- -e, --expand
- فعالسازی بسط موجودیتهای نویسهای (به عنوان مثال تبدیل '>' به '>').
- -f, --nofade
- غیرفعالسازی محو شدن تدریجی رنگ در حالت ۲۵۶ رنگ.
- -i, --invert
- معکوسسازی رنگهای سیاه و سفید.
- -j N, --jump N
- پرش به اسلاید شماره N.
- -L N, --left-indent N
- انتقال محتوای اسلاید به میزان N ستون به سمت راست.
- -s, --noslidenum
- عدم نمایش شماره اسلاید در پایین صفحه.
- -T N, --top-indent N
- انتقال محتوای اسلاید به میزان N سطر به سمت پایین.
- -t, --notrans
- غیرفعالسازی شفافیت در ترمینالهای دارای پسزمینه شفاف.
- -x, --noslidemax
- نمایش شماره اسلاید، اما بدون نمایش تعداد کل اسلایدها.
گزینههای متفرقه (Miscellaneous Options)
- -d, --debug
- فعالسازی پیامهای اشکالزدایی در STDERR. تکرار این گزینه سطح اشکالزدایی را افزایش میدهد.
- -h, --help
- نمایش راهنمای استفاده و خروج.
- -v, --version
- نمایش اطلاعات نسخه و پروانه برنامه.
متغیرهای محیطی (ENVIRONMENT VARIABLES)
کنترل خروجی (Output Control)
- MDP_LIST_HEAD[1-3], MDP_LIST_OPEN[1-3]
- کنترل
نویسههای
فهرستهای
نامرتب.
مقدار پیشفرض معادل است با:
MDP_LIST_OPEN1=' | '
MDP_LIST_OPEN2=' | '
MDP_LIST_OPEN3=' | '
MDP_LIST_HEAD1=' +- '
MDP_LIST_HEAD2=' +- '
MDP_LIST_HEAD3=' +- '
قالببندی مارکداون (MARKDOWN FORMATTING)
برای مشاهده فهرست کاملی از نشانهگذاریهای پشتیبانیشده، به ارائه نمونه (sample.md) ارائه شده همراه با mdp، یا بهصورت برخط در آدرس https://github.com/visit1985/mdp مراجعه کنید.
اسلایدها (Slides)
FILE ورودی با استفاده از خطوط افقی به چند اسلاید تقسیم میشود. هر خط افقی متشکل از حداقل ۳ نویسه --- یا *** در یک سطر مجزا است. پیش از این سطر باید یک سطر کاملاً خالی وجود داشته باشد. این سطر میتواند شامل فاصله (space) نیز باشد اما نویسه دیگری نباید در آن قرار گیرد.
اگر هر یک از اسلایدها برای نمایش در اندازه صفحه جاری بیش از حد بزرگ باشد، پیامی خطا در لحظه آغاز ارائه نمایش داده خواهد شد.
حالت خطبهخط (Line-by-Line Mode)
حالت بلوکبهبلوک (Block-by-Block Mode)
قرار گرفتن تنها یک <br>، <BR> یا ^ در یک سطر در غیر این صورت خالی، به mdp اعلام میکند که خروجی اسلاید جاری را متوقف کرده (نقطه توقف) و منتظر فشرده شدن کلیدی توسط کاربر بماند.
این قابلیت به کاربر امکان میدهد تا موارد فهرست یا نشانهدار را یکی یکی (خطبهخط) یا بلوکبهبلوک نمایش دهد.
سرآیندها (Headers)
دستور mdp از خطوط فراداده در بالای فایل ورودی با قالب [KEY]:[VALUE] پشتیبانی میکند. اولین مدخل فراداده به عنوان عنوان استفاده میشود و مدخلهای تکراری footer: برای نوار پایینی به کار میروند. اگر تنها یک مقدار برای footer تعیین شده باشد، در صورت مخفی بودن شماره اسلایدها، در مرکز قرار میگیرد. به عنوان مثال:
<!-- title: Example Presentation footer: Someone footer: 2026-01-01 -->
فرادادههای قدیمی (Legacy) نیز به صورت خطوط %title:، %author:، %date: در بالای فایل ورودی پذیرفته میشوند. برچسبهای قدیمی %author: و %date: به ترتیب به عنوان مقادیر پاورقی اول و دوم در نظر گرفته میشوند. میتوان از یادداشتهای (کامنتهای) HTML برای مخفی نگهداشتن این خطوط فراداده از مجموعه اسلایدها استفاده کرد، و فرادادههای درون یادداشت نیازی به پیشوند % ندارند.
سرآیندها تنها در بالای FILE ورودی تشخیص داده میشوند.
نشانهگذاریهای چندسطری (Line spanning markup)
تیترها، بلوکهای کد، نقلقولها و فهرستهای نامرتب پشتیبانی میشوند.
نشانهگذاریهای درونخطی (In-line markup)
و همچنین متن برجسته (bold)، متن زیرخطدار و کد درونخطی (in-line code).
پشتیبانی از رنگ (COLOR SUPPORT)
امروزه بیشتر ترمینالها قادر به نمایش ۲۵۶ رنگ هستند، اما برخی از آنها به طور پیشفرض تنها ۱۶ رنگ را فعال میکنند. برای بهرهمندی از تمام قابلیتهای mdp، این ترمینالها باید متوجه شوند که حالت ۲۵۶ رنگ را فعال کنند. این کار معمولاً با تنظیم متغیر محیطی TERM انجام میشود.
export TERM=xterm-256color
کلیدهای کنترلی صفحهکلید (KEYBOARD CONTROLS)
- h, j, k, l, Arrow keys, Space, Enter, Backspace, Page Up, Page Down
- نمایش اسلاید بعدی/قبلی یا ادامه پس از یک نقطه توقف.
- g, Home
- پرش به اسلاید نخست.
- G, End
- پرش به اسلاید آخر.
- 1..N
- پرش به اسلاید شماره N.
- r
- بارگذاری مجدد FILE ورودی. در صورتی که ورودی از ورودی استاندارد خوانده شده باشد، این کلید غیرفعال است.
- q
- خروج از mdp.
سفارشیسازی (CUSTOMIZATION)
دستور mdp میتواند با ویرایش فایل config.h و کامپایل دوباره شخصیسازی شود.
نویسندگان (AUTHORS)
نوشته شده توسط Michael Goehler و دیگران؛ ببینید: https://github.com/visit1985/mdp/blob/master/AUTHORS.
کپیرایت و تکثیر (COPYRIGHT)
حق نشر (C) 2026 Michael Goehler
این یک نرمافزار آزاد است؛ برای شرایط تکثیر، سورسکد را بررسی کنید. هیچگونه ضمانتی وجود ندارد؛ حتی برای قابل فروش بودن یا تناسب با یک هدف خاص.
| 2016-04-02 | User Commands |