نام (NAME)

theme — ساخت یک صفحه وب از روی فایل قالب

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

theme [-C option-flags] [-c options] [-d root] [-E] [-f] [-o file] [-p pagename] [-t template] [-V] [textfile]

توضیحات (DESCRIPTION)

ابزار theme یک textfile با قالب‌بندی markdown(7) (یا ورودی استاندارد در صورت عدم تعیین) را دریافت کرده، آن را کامپایل می‌کند و با یک قالب (به‌طور پیش‌فرض page.theme) ترکیب می‌نماید تا یک صفحه وب تولید کند. اگر مسیری به قالب مشخص نشده باشد، theme به دنبال page.theme در دایرکتوری جاری، و سپس در هر دایرکتوری والد تا document root (تنظیم‌شده با -d یا در صورت عدم تنظیم، دایرکتوری ریشه سیستم) می‌گردد. اگر page.theme یافت شود، theme آن را در خروجی کپی می‌کند، به دنبال برچسب‌های html به‌صورت <?theme action?> می‌گردد و action جاسازی‌شده را به شکل مناسب پردازش می‌نماید.

theme کنش‌های زیر را پردازش می‌کند:

author

نام نویسنده(ها) را از تابع mkd_doc_author(3) چاپ می‌کند.

body

فایل ورودی قالب‌بندی‌شده markdown(7) را چاپ می‌کند.

date

تاریخ بازگردانده‌شده توسط mkd_doc_date(3) یا در صورت عدم وجود، تاریخ آخرین تغییر فایل ورودی را چاپ می‌کند.

dir

بخش دایرکتوری از pagename را چاپ می‌کند.

include(file)

محتوای file را چاپ می‌کند. ترجمه Markdown(7) روی این فایل انجام نخواهد شد.

source

بخش نام فایل از pagename.

style

شیوه‌نامه‌های یافت‌شده در فایل ورودی (mkd-extensions(7) را ببینید) را چاپ می‌کند.

title

عنوان بازگردانده‌شده توسط mkd_doc_title(3) یا در صورت عدم وجود آن، نام فایل منبع را چاپ می‌کند.

version

نسخه‌ای از discount(7) که این نسخه از theme با آن کامپایل شده است را چاپ می‌کند.

اگر ورودی از یک فایل خوانده شود و خروجی با گزینه -o تنظیم نشده باشد، theme خروجی را در file-sans-text.html می‌نویسد (اگر file دارای پسوند .text باشد، آن پسوند حذف شده و با .html جایگزین می‌شود؛ در غیر این صورت .html به انتهای نام فایل اضافه خواهد شد.)

گزینه‌ها به شرح زیر هستند:

-d root

تنظیم document root روی root

-E

به‌طور معمول theme عبارت‌های <?theme body?> یا <?theme toc?> را در بخش <head> یا <?theme style?> را در بخش <body> گسترش نمی‌دهد، اما گزینه -E این رفتار را نادیده گرفته و اجازه گسترش در همه‌جا را می‌دهد.

-f

رونویسی اجباری فایل‌های html موجود.

-o filename

نوشتن خروجی در filename.

-p path

تنظیم pagename روی path.

-t filename

استفاده از filename به عنوان فایل قالب.

مقادیر بازگشتی (RETURN VALUES)

ابزار theme در صورت موفقیت با مقدار ۰ و در صورت بروز خطا با مقداری بزرگ‌تر از ۰ خارج می‌شود.

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

markdown(1), markdown(3), markdown(7), mkd-extensions(7).

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

David Parsons (orc@pell.portland.or.us)