MDP(1) General Commands Manual MDP(1)

mdp - ابزار ارائه مبتنی بر خط فرمان با قالب مارک‌داون

mdp [OPTION]... [FILE]

دستور mdp یک برنامه خط فرمانی است که به شما امکان می‌دهد از FILE های با قالب‌بندی مارک‌داون ارائه‌هایی زیبا و شکیل بسازید.

استفاده از آن به سادگیِ نوشتن محتوای ارائه در ویرایشگر متن دلخواهتان و اجرای ارائه از طریق خط فرمان است.

فایل ورودی که ارائه از آن خوانده می‌شود. اگر هیچ فایلی مشخص نشود، یا اگر نام فایل - باشد، ارائه از ورودی استاندارد خوانده خواهد شد.

عدم تغییر رنگ پس‌زمینه بلوک‌های کد.
فعال‌سازی بسط موجودیت‌های نویسه‌ای (به عنوان مثال تبدیل '>' به '>').
غیرفعال‌سازی محو شدن تدریجی رنگ در حالت ۲۵۶ رنگ.
معکوس‌سازی رنگ‌های سیاه و سفید.
پرش به اسلاید شماره N.
انتقال محتوای اسلاید به میزان N ستون به سمت راست.
عدم نمایش شماره اسلاید در پایین صفحه.
انتقال محتوای اسلاید به میزان N سطر به سمت پایین.
غیرفعال‌سازی شفافیت در ترمینال‌های دارای پس‌زمینه شفاف.
نمایش شماره اسلاید، اما بدون نمایش تعداد کل اسلایدها.

فعال‌سازی پیام‌های اشکال‌زدایی در STDERR. تکرار این گزینه سطح اشکال‌زدایی را افزایش می‌دهد.
نمایش راهنمای استفاده و خروج.
نمایش اطلاعات نسخه و پروانه برنامه.

کنترل نویسه‌های فهرست‌های نامرتب.

مقدار پیش‌فرض معادل است با:
MDP_LIST_OPEN1=' | '
MDP_LIST_OPEN2=' | '
MDP_LIST_OPEN3=' | '
MDP_LIST_HEAD1=' +- '
MDP_LIST_HEAD2=' +- '
MDP_LIST_HEAD3=' +- '

برای مشاهده فهرست کاملی از نشانه‌گذاری‌های پشتیبانی‌شده، به ارائه نمونه (sample.md) ارائه شده همراه با mdp، یا به‌صورت برخط در آدرس https://github.com/visit1985/mdp مراجعه کنید.

FILE ورودی با استفاده از خطوط افقی به چند اسلاید تقسیم می‌شود. هر خط افقی متشکل از حداقل ۳ نویسه --- یا *** در یک سطر مجزا است. پیش از این سطر باید یک سطر کاملاً خالی وجود داشته باشد. این سطر می‌تواند شامل فاصله (space) نیز باشد اما نویسه دیگری نباید در آن قرار گیرد.

اگر هر یک از اسلایدها برای نمایش در اندازه صفحه جاری بیش از حد بزرگ باشد، پیامی خطا در لحظه آغاز ارائه نمایش داده خواهد شد.

قرار گرفتن تنها یک <br>، <BR> یا ^ در یک سطر در غیر این صورت خالی، به mdp اعلام می‌کند که خروجی اسلاید جاری را متوقف کرده (نقطه توقف) و منتظر فشرده شدن کلیدی توسط کاربر بماند.

این قابلیت به کاربر امکان می‌دهد تا موارد فهرست یا نشانه‌دار را یکی یکی (خط‌به‌خط) یا بلوک‌به‌بلوک نمایش دهد.

دستور mdp از خطوط فراداده در بالای فایل ورودی با قالب [KEY]:[VALUE] پشتیبانی می‌کند. اولین مدخل فراداده به عنوان عنوان استفاده می‌شود و مدخل‌های تکراری footer: برای نوار پایینی به کار می‌روند. اگر تنها یک مقدار برای footer تعیین شده باشد، در صورت مخفی بودن شماره اسلایدها، در مرکز قرار می‌گیرد. به عنوان مثال:

<!--
title: Example Presentation
footer: Someone
footer: 2026-01-01
-->

فراداده‌های قدیمی (Legacy) نیز به صورت خطوط %title:، %author:، %date: در بالای فایل ورودی پذیرفته می‌شوند. برچسب‌های قدیمی %author: و %date: به ترتیب به عنوان مقادیر پاورقی اول و دوم در نظر گرفته می‌شوند. می‌توان از یادداشت‌های (کامنت‌های) HTML برای مخفی نگه‌داشتن این خطوط فراداده از مجموعه اسلایدها استفاده کرد، و فراداده‌های درون یادداشت نیازی به پیشوند % ندارند.

سرآیندها تنها در بالای FILE ورودی تشخیص داده می‌شوند.

تیترها، بلوک‌های کد، نقل‌قول‌ها و فهرست‌های نامرتب پشتیبانی می‌شوند.

و همچنین متن برجسته (bold)، متن زیرخط‌دار و کد درون‌خطی (in-line code).

امروزه بیشتر ترمینال‌ها قادر به نمایش ۲۵۶ رنگ هستند، اما برخی از آن‌ها به طور پیش‌فرض تنها ۱۶ رنگ را فعال می‌کنند. برای بهره‌مندی از تمام قابلیت‌های mdp، این ترمینال‌ها باید متوجه شوند که حالت ۲۵۶ رنگ را فعال کنند. این کار معمولاً با تنظیم متغیر محیطی TERM انجام می‌شود.

export TERM=xterm-256color

نمایش اسلاید بعدی/قبلی یا ادامه پس از یک نقطه توقف.
پرش به اسلاید نخست.
پرش به اسلاید آخر.
1..N
پرش به اسلاید شماره N.
بارگذاری مجدد FILE ورودی. در صورتی که ورودی از ورودی استاندارد خوانده شده باشد، این کلید غیرفعال است.
خروج از mdp.

دستور mdp می‌تواند با ویرایش فایل config.h و کامپایل دوباره شخصی‌سازی شود.

نوشته شده توسط Michael Goehler و دیگران؛ ببینید: https://github.com/visit1985/mdp/blob/master/AUTHORS.

حق نشر (C) 2026 Michael Goehler

این یک نرم‌افزار آزاد است؛ برای شرایط تکثیر، سورس‌کد را بررسی کنید. هیچ‌گونه ضمانتی وجود ندارد؛ حتی برای قابل فروش بودن یا تناسب با یک هدف خاص.

2016-04-02 User Commands