.TH "cmark" "1" "February 11, 2020" "LOCAL" "General Commands Manual"
.SH "نام (NAME)"
cmark \- تبدیل متن با قالب‌بندی CommonMark به HTML و سایر فرمت‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.HP 6n
\fBcmark\fR
[\fIگزینه‌ها\fR]
\fIفایل\fR*
.SH "توضیحات (DESCRIPTION)"
دستور
\fBcmark\fR
متن ساده قالب‌بندی‌شده با مارک‌داون (Markdown) را با استفاده از قواعد توصیف‌شده در مشخصات CommonMark به یکی از قالب‌های HTML، groff man، CommonMark XML، LaTeX یا CommonMark تبدیل می‌کند. این برنامه ورودی را از ورودی استاندارد (\fIstdin\fR) یا فایل‌های مشخص‌شده خوانده (و محتوای آن‌ها را به هم پیوند می‌دهد) و خروجی را در خروجی استاندارد (\fIstdout\fR) می‌نویسد.
.SH "گزینه‌ها (OPTIONS)"
.TP 12n
.B \-\-to, \-t \f[I]FORMAT\f[]
تعیین قالب خروجی (\f[C]html\f[], \f[C]man\f[], \f[C]xml\f[], \f[C]latex\f[], \f[C]commonmark\f[]).
.TP 12n
.B \-\-width \f[I]WIDTH\f[]
تعیین عرض ستون برای شکستن خطوط در خروجی. برای غیرفعال کردن شکستن خطوط، از مقدار 0 (پیش‌فرض) استفاده کنید. این گزینه در حال حاضر تنها روی رندرکننده‌های commonmark، latex و man تأثیر می‌گذارد.
.TP 12n
.B \-\-hardbreaks
رندر کردن شکست‌های نرم خطوط (خطوط جدید درون پاراگراف‌ها در سورس CommonMark) به‌صورت شکست خط سخت در قالب مقصد. در صورت مشخص شدن این گزینه، شکست خط سخت برای خروجی CommonMark بدون در نظر گرفتن مقدار ارائه‌شده با \-\-width غیرفعال می‌شود.
.TP 12n
.B \-\-nobreaks
رندر کردن شکست‌های نرم خطوط به‌صورت فاصله (space). در صورت مشخص شدن این گزینه، شکست خط سخت برای تمامی قالب‌های خروجی بدون در نظر گرفتن مقدار ارائه‌شده با \-\-width غیرفعال می‌گردد.
.TP 12n
.B \-\-sourcepos
گنجاندن صفت موقعیت منبع (source position).
.TP 12n
.B \-\-validate-utf8
اعتبارسنجی UTF-8 و جایگزینی دنباله‌های غیرمجاز با U+FFFD.
.TP 12n
.B \-\-smart
استفاده از نشانه‌گذاری هوشمند. نقل‌قول‌های تکی و جفتی ساده بر اساس جایگاهشان به‌صورت نقل‌قول‌های خمیده (curly quotes) رندر می‌شوند.
\f[C]\-\-\f[] به‌صورت خط تیره کوتاه (en-dash)،
\f[C]\-\-\-\f[] به‌صورت خط تیره بلند (em-dash) و
\f[C]...\f[] به‌صورت سه‌نقطه (ellipses) رندر خواهد شد.
.TP 12n
.B \-\-safe
حذف کدهای خام HTML و نشانی‌های بالقوه خطرناک اینترنتی (پیش‌فرض).
کد HTML خام با یک کامنت جایگزین می‌شود و نشانی‌های بالقوه خطرناک با رشته خالی جایگزین می‌گردند. نشانی‌های بالقوه خطرناک آن‌هایی هستند که با `javascript:`، `vbscript:`، `file:` یا `data:` (به جز انواع داده‌های رسانه‌ای `image/png`، `image/gif`، `image/jpeg` یا `image/webp`) آغاز می‌شوند.
.TP 12n
.B \-\-unsafe
رندر کردن کدهای خام HTML یا نشانی‌های بالقوه خطرناک و نادیده گرفتن رفتار پیش‌فرض (\-\-safe).
.TP 12n
.B \-\-help
نمایش اطلاعات راهنمای استفاده از دستور.
.TP 12n
.B \-\-version
نمایش نسخه برنامه.
.SH "نویسندگان (AUTHORS)"
John MacFarlane, Vicent Marti, Kārlis Gaņģis, Nick Wellnhofer.
.SH "همچنین ببینید (SEE ALSO)"
.PP
مشخصات فنی CommonMark: \f[C]https://spec.commonmark.org\f[]