.\" This is the groff documentation source for MDP
.\"
.\" Preview with: groff -man -Tascii mdp.1
.\"           or: man -l mdp.1
.\"
.
.
.TH MDP 1 "2016-04-02" "User Commands"
.SH "نام (NAME)"
mdp \- ابزار ارائه مبتنی بر خط فرمان با قالب مارک‌داون
.SH "خلاصه دستور (SYNOPSIS)"
.B mdp
.RI [ OPTION ].\|.\|.\|
.RI [ FILE ]
.
.SH "توضیحات (DESCRIPTION)"
دستور
.B mdp
یک برنامه خط فرمانی است که به شما امکان می‌دهد از
.IR FILE
های با
.B قالب‌بندی مارک‌داون
ارائه‌هایی زیبا و شکیل بسازید.
.PP
استفاده از آن به سادگیِ نوشتن محتوای ارائه در ویرایشگر متن دلخواهتان و اجرای ارائه از طریق خط فرمان است.
.
.SH "گزینه‌ها (OPTIONS)"
.SS "کنترل ورودی (Input Control)"
.TP
.IR FILE
فایل ورودی که ارائه از آن خوانده می‌شود. اگر هیچ فایلی مشخص نشود، یا اگر نام فایل
.BR \-
باشد، ارائه از ورودی استاندارد خوانده خواهد شد.
.SS "کنترل خروجی (Output Control)"
.TP
.BR \-c ", " \-\^\-nocodebg
عدم تغییر رنگ پس‌زمینه بلوک‌های کد.
.TP
.BR \-e ", " \-\^\-expand
فعال‌سازی بسط موجودیت‌های نویسه‌ای (به عنوان مثال تبدیل '>' به '>').
.TP
.BR \-f ", " \-\^\-nofade
غیرفعال‌سازی محو شدن تدریجی رنگ در حالت ۲۵۶ رنگ.
.TP
.BR \-i ", " \-\^\-invert
معکوس‌سازی رنگ‌های سیاه و سفید.
.TP
.IR "\fB\-j\fP N" ", " "\fB\-\^\-jump\fP N"
پرش به اسلاید شماره \fIN\fP.
.TP
.IR "\fB\-L\fP N" ", " "\fB\-\^\-left-indent\fP N"
انتقال محتوای اسلاید به میزان \fIN\fP ستون به سمت راست.
.TP
.BR \-s ", " \-\^\-noslidenum
عدم نمایش شماره اسلاید در پایین صفحه.
.TP
.IR "\fB\-T\fP N" ", " "\fB\-\^\-top-indent\fP N"
انتقال محتوای اسلاید به میزان \fIN\fP سطر به سمت پایین.
.TP
.BR \-t ", " \-\^\-notrans
غیرفعال‌سازی شفافیت در ترمینال‌های دارای پس‌زمینه شفاف.
.TP
.BR \-x ", " \-\^\-noslidemax
نمایش شماره اسلاید، اما بدون نمایش تعداد کل اسلایدها.
.
.SS "گزینه‌های متفرقه (Miscellaneous Options)"
.TP
.BR \-d ", " \-\^\-debug
فعال‌سازی پیام‌های اشکال‌زدایی در STDERR. تکرار این گزینه سطح اشکال‌زدایی را افزایش می‌دهد.
.TP
.BR \-h ", " \-\^\-help
نمایش راهنمای استفاده و خروج.
.TP
.BR \-v ", " \-\^\-version
نمایش اطلاعات نسخه و پروانه برنامه.
.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.SS "کنترل خروجی (Output Control)"
.TP
.BR MDP_LIST_HEAD[1-3],\ MDP_LIST_OPEN[1-3]
کنترل نویسه‌های فهرست‌های نامرتب.

مقدار پیش‌فرض معادل است با:
.br
MDP_LIST_OPEN1=' |  '
.br
MDP_LIST_OPEN2=' |  '
.br
MDP_LIST_OPEN3=' |  '
.br
MDP_LIST_HEAD1=' +- '
.br
MDP_LIST_HEAD2=' +- '
.br
MDP_LIST_HEAD3=' +- '
.
.SH "قالب‌بندی مارک‌داون (MARKDOWN FORMATTING)"
برای مشاهده فهرست کاملی از نشانه‌گذاری‌های پشتیبانی‌شده، به ارائه نمونه
(sample.md) ارائه شده همراه با
.BR mdp ،\|
یا به‌صورت برخط در آدرس
.IR https://github.com/visit1985/mdp
مراجعه کنید.
.SS "اسلایدها (Slides)"
.IR FILE
ورودی با استفاده از خطوط افقی به چند اسلاید تقسیم می‌شود. هر خط افقی متشکل از حداقل ۳ نویسه
.B \-\-\-
یا
.B ***
در یک سطر مجزا است.
.B پیش از این سطر باید یک سطر کاملاً خالی وجود داشته باشد.
این سطر می‌تواند شامل فاصله (space) نیز باشد اما نویسه دیگری نباید در آن قرار گیرد.
.PP
اگر هر یک از اسلایدها برای نمایش در اندازه صفحه جاری بیش از حد بزرگ باشد، پیامی خطا در لحظه آغاز ارائه نمایش داده خواهد شد.
.
.SS "حالت خط‌به‌خط (Line-by-Line Mode)"
.SS "حالت بلوک‌به‌بلوک (Block-by-Block Mode)"
قرار گرفتن تنها یک
.BR "<br>" "، " "<BR>" " یا " "^"
در یک سطر در غیر این صورت خالی، به
.B mdp
اعلام می‌کند که خروجی اسلاید جاری را متوقف کرده (نقطه توقف) و منتظر فشرده شدن کلیدی توسط کاربر بماند.
.PP
این قابلیت به کاربر امکان می‌دهد تا موارد فهرست یا نشانه‌دار را یکی یکی (خط‌به‌خط) یا بلوک‌به‌بلوک نمایش دهد.
.
.SS "سرآیندها (Headers)"
دستور
.B mdp
از خطوط فراداده در بالای فایل ورودی با قالب
.BR [KEY] : [VALUE]
پشتیبانی می‌کند. اولین مدخل فراداده به عنوان عنوان استفاده می‌شود و مدخل‌های تکراری
.BR footer:
برای نوار پایینی به کار می‌روند. اگر تنها یک مقدار برای footer تعیین شده باشد، در صورت مخفی بودن شماره اسلایدها، در مرکز قرار می‌گیرد. به عنوان مثال:
.PP
.nf
<!--
title: Example Presentation
footer: Someone
footer: 2026-01-01
-->
.fi
.PP
فراداده‌های قدیمی (Legacy) نیز به صورت خطوط
.BR %title: "، " %author: "، " %date:
در بالای فایل ورودی پذیرفته می‌شوند. برچسب‌های قدیمی
.BR %author:
و
.BR %date:
به ترتیب به عنوان مقادیر پاورقی اول و دوم در نظر گرفته می‌شوند. می‌توان از یادداشت‌های (کامنت‌های) HTML برای مخفی نگه‌داشتن این خطوط فراداده از مجموعه اسلایدها استفاده کرد، و فراداده‌های درون یادداشت نیازی به پیشوند
.BR %
ندارند.
.PP
سرآیندها تنها در بالای
.IR FILE
ورودی تشخیص داده می‌شوند.
.
.SS "نشانه‌گذاری‌های چندسطری (Line spanning markup)"
تیترها، بلوک‌های کد، نقل‌قول‌ها و فهرست‌های نامرتب پشتیبانی می‌شوند.
.
.SS "نشانه‌گذاری‌های درون‌خطی (In-line markup)"
و همچنین متن برجسته (bold)، متن زیرخط‌دار و کد درون‌خطی (in-line code).
.
.SH "پشتیبانی از رنگ (COLOR SUPPORT)"
امروزه بیشتر ترمینال‌ها قادر به نمایش ۲۵۶ رنگ هستند، اما برخی از آن‌ها به طور پیش‌فرض تنها ۱۶ رنگ را فعال می‌کنند. برای بهره‌مندی از تمام قابلیت‌های
.BR mdp ،
این ترمینال‌ها باید متوجه شوند که حالت ۲۵۶ رنگ را فعال کنند. این کار معمولاً با تنظیم متغیر محیطی TERM انجام می‌شود.
.PP
.BR "export TERM=xterm-256color"
.
.SH "کلیدهای کنترلی صفحه‌کلید (KEYBOARD CONTROLS)"
.TP
.BR "h, j, k, l, Arrow keys, Space, Enter, Backspace, Page Up, Page Down"
نمایش اسلاید بعدی/قبلی یا ادامه پس از یک نقطه توقف.
.TP
.BR "g, Home"
پرش به اسلاید نخست.
.TP
.BR "G, End"
پرش به اسلاید آخر.
.TP
.BR "1..N"
پرش به اسلاید شماره
.BR N .
.TP
.BR "r"
بارگذاری مجدد
.IR FILE
ورودی.\|
در صورتی که ورودی از ورودی استاندارد خوانده شده باشد، این کلید غیرفعال است.
.TP
.BR "q"
خروج از
.BR mdp "."
.
.SH "سفارشی‌سازی (CUSTOMIZATION)"
دستور
.B mdp
می‌تواند با ویرایش فایل config.h و کامپایل دوباره شخصی‌سازی شود.
.SH "نویسندگان (AUTHORS)"
نوشته شده توسط Michael Goehler و دیگران؛ ببینید:
.IR https://github.com/visit1985/mdp/blob/master/AUTHORS "."
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
حق نشر (C) 2026 Michael Goehler
.PP
این یک نرم‌افزار آزاد است؛ برای شرایط تکثیر، سورس‌کد را بررسی کنید. هیچ‌گونه ضمانتی وجود ندارد؛ حتی برای قابل فروش بودن یا تناسب با یک هدف خاص.