.TH "cmark-gfm" "1" "March 24, 2016" "LOCAL" "General Commands Manual"
.SH "نام (NAME)"
cmark-gfm \- پارسر و رندر کننده مارک‌داون با طعم گیت‌هاب (GitHub Flavored Markdown)
.SH "خلاصه دستور (SYNOPSIS)"
.HP 6n
\fBcmark-gfm\fR
[\fIگزینه‌ها\fR]
[\fIفایل\fR...]
.SH "توضیحات (DESCRIPTION)"
دستور
\fBcmark-gfm\fR
متن ساده قالب‌بندی‌شده با مارک‌داون را با استفاده از قراردادهای شرح‌داده‌شده در مشخصات 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، صرف‌نظر از مقدار داده‌شده با
.B \-\-width
غیرفعال می‌شود.
.TP 12n
.B \-\-nobreaks
شکست‌های نرم را به صورت فاصله رندر می‌کند. در صورت تعیین این گزینه، شکستن سخت خطوط برای تمام قالب‌های خروجی، صرف‌نظر از مقدار داده‌شده با
.B \-\-width
غیرفعال می‌شود.
.TP 12n
.B \-\-sourcepos
صفت موقعیت در منبع (source position) را در خروجی لحاظ می‌کند.
.TP 12n
.B \-\-normalize
گره‌های متنی مجاور را با یکدیگر ادغام و یکپارچه می‌کند.
.TP 12n
.B \-\-extension, \-e \f[I]EXTENSION_NAME\f[]
نام افزونه مورد استفاده را مشخص می‌کند.
.TP 12n
.B \-\-list\-extensions
افزونه‌های موجود را فهرست کرده و خارج می‌شود.
.TP 12n
.B \-\-validate-utf8
اعتبارسنجی UTF-8 را انجام داده و توالی‌های نامعتبر را با U+FFFD جایگزین می‌کند.
.TP 12n
.B \-\-smart
استفاده از نشانه‌گذاری هوشمند. علامت‌های نقل‌قول تکی و دوتایی صاف، بسته به موقعیتشان به صورت نقل‌قول‌های خمیده رندر می‌شوند.
\f[C]\-\-\f[]
به صورت خط تیره کوتاه (en-dash)،
\f[C]\-\-\-\f[]
به صورت خط تیره بلند (em-dash) و
\f[C]...\f[]
به صورت سه‌نقطه (ellipses) رندر خواهد شد.
.TP 12n
.B \-\-unsafe
رندر کردن کدهای خام HTML و نشانی‌های بالقوه خطرناک. (کد خام HTML با کامنت جایگزین نمی‌شود؛ نشانی‌های بالقوه خطرناک نیز با رشته خالی جایگزین نمی‌شوند.) نشانی‌های خطرناک مواردی هستند که با
`javascript:`، `vbscript:`، `file:` یا `data:`
آغاز می‌شوند (به استثنای انواع mime شامل
`image/png`، `image/gif`، `image/jpeg` یا `image/webp`).
.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]http://spec.commonmark.org\f[]