نام (NAME)

cmark - تبدیل متن با قالب‌بندی CommonMark به HTML و سایر فرمت‌ها

خلاصه دستور (SYNOPSIS)

cmark [گزینه‌ها] فایل*

توضیحات (DESCRIPTION)

دستور cmark متن ساده قالب‌بندی‌شده با مارک‌داون (Markdown) را با استفاده از قواعد توصیف‌شده در مشخصات CommonMark به یکی از قالب‌های HTML، groff man، CommonMark XML، LaTeX یا CommonMark تبدیل می‌کند. این برنامه ورودی را از ورودی استاندارد (stdin) یا فایل‌های مشخص‌شده خوانده (و محتوای آن‌ها را به هم پیوند می‌دهد) و خروجی را در خروجی استاندارد (stdout) می‌نویسد.

گزینه‌ها (OPTIONS)

--to, -t FORMAT

تعیین قالب خروجی (html, man, xml, latex, commonmark).

--width WIDTH

تعیین عرض ستون برای شکستن خطوط در خروجی. برای غیرفعال کردن شکستن خطوط، از مقدار 0 (پیش‌فرض) استفاده کنید. این گزینه در حال حاضر تنها روی رندرکننده‌های commonmark، latex و man تأثیر می‌گذارد.

--hardbreaks

رندر کردن شکست‌های نرم خطوط (خطوط جدید درون پاراگراف‌ها در سورس CommonMark) به‌صورت شکست خط سخت در قالب مقصد. در صورت مشخص شدن این گزینه، شکست خط سخت برای خروجی CommonMark بدون در نظر گرفتن مقدار ارائه‌شده با --width غیرفعال می‌شود.

--nobreaks

رندر کردن شکست‌های نرم خطوط به‌صورت فاصله (space). در صورت مشخص شدن این گزینه، شکست خط سخت برای تمامی قالب‌های خروجی بدون در نظر گرفتن مقدار ارائه‌شده با --width غیرفعال می‌گردد.

--sourcepos

گنجاندن صفت موقعیت منبع (source position).

--validate-utf8

اعتبارسنجی UTF-8 و جایگزینی دنباله‌های غیرمجاز با U+FFFD.

--smart

استفاده از نشانه‌گذاری هوشمند. نقل‌قول‌های تکی و جفتی ساده بر اساس جایگاهشان به‌صورت نقل‌قول‌های خمیده (curly quotes) رندر می‌شوند. -- به‌صورت خط تیره کوتاه (en-dash)، --- به‌صورت خط تیره بلند (em-dash) و ... به‌صورت سه‌نقطه (ellipses) رندر خواهد شد.

--safe

حذف کدهای خام HTML و نشانی‌های بالقوه خطرناک اینترنتی (پیش‌فرض). کد HTML خام با یک کامنت جایگزین می‌شود و نشانی‌های بالقوه خطرناک با رشته خالی جایگزین می‌گردند. نشانی‌های بالقوه خطرناک آن‌هایی هستند که با `javascript:`، `vbscript:`، `file:` یا `data:` (به جز انواع داده‌های رسانه‌ای `image/png`، `image/gif`، `image/jpeg` یا `image/webp`) آغاز می‌شوند.

--unsafe

رندر کردن کدهای خام HTML یا نشانی‌های بالقوه خطرناک و نادیده گرفتن رفتار پیش‌فرض (--safe).

--help

نمایش اطلاعات راهنمای استفاده از دستور.

--version

نمایش نسخه برنامه.

نویسندگان (AUTHORS)

John MacFarlane, Vicent Marti, Kārlis Gaņģis, Nick Wellnhofer.

همچنین ببینید (SEE ALSO)

مشخصات فنی CommonMark: https://spec.commonmark.org