.\"     %A%
.\"
.Dd January 23, 2008
.Dt THEME 1
.Os MASTODON
.Sh "نام (NAME)"
.Nm theme
.Nd ساخت یک صفحه وب از روی فایل قالب
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Op Fl C Pa option-flags
.Op Fl c Pa options
.Op Fl d Pa root
.Op Fl E
.Op Fl f
.Op Fl o Pa file
.Op Fl p Pa pagename
.Op Fl t Pa template
.Op Fl V
.Op Pa textfile
.Sh "توضیحات (DESCRIPTION)"
ابزار
.Nm
یک
.Pa textfile
با قالب‌بندی
.Xr markdown 7
.Pq یا ورودی استاندارد در صورت عدم تعیین
را دریافت کرده، آن را کامپایل می‌کند و با یک
.Em قالب
.Po
به‌طور پیش‌فرض
.Pa page.theme
.Pc
ترکیب می‌نماید تا یک صفحه وب تولید کند. اگر مسیری به قالب مشخص نشده باشد،
.Nm
به دنبال
.Pa page.theme
در دایرکتوری جاری، و سپس در هر دایرکتوری والد تا
.Pa "document root"
.Po
تنظیم‌شده با
.Fl d
یا در صورت عدم تنظیم،
.Em "دایرکتوری ریشه"
سیستم
.Pc
می‌گردد. اگر
.Pa page.theme
یافت شود،
.Nm
آن را در خروجی کپی می‌کند، به دنبال برچسب‌های html به‌صورت
.Em "<?theme action?>"
می‌گردد و
.Ar action
جاسازی‌شده را به شکل مناسب پردازش می‌نماید.
.Pp
.Nm
کنش‌های زیر را پردازش می‌کند:
.Bl -tag -width "include("
.It Ar author
نام نویسنده(ها) را از تابع
.Xr mkd_doc_author 3
چاپ می‌کند.
.It Ar body
فایل ورودی قالب‌بندی‌شده
.Xr markdown 7
را چاپ می‌کند.
.It Ar date
تاریخ بازگردانده‌شده توسط
.Xr mkd_doc_date 3
یا در صورت عدم وجود، تاریخ آخرین تغییر فایل ورودی را چاپ می‌کند.
.It Ar dir
بخش دایرکتوری از pagename را چاپ می‌کند.
.It Ar include Ns Pq Pa file
محتوای
.Pa file
را چاپ می‌کند. ترجمه
.Xr Markdown 7
روی این فایل انجام
.Em نخواهد
شد.
.It Ar source
بخش نام فایل از pagename.
.It Ar style
شیوه‌نامه‌های یافت‌شده در فایل ورودی
.Pq Xr mkd-extensions 7 را ببینید
را چاپ می‌کند.
.It Ar title
عنوان بازگردانده‌شده توسط
.Xr mkd_doc_title 3
یا در صورت عدم وجود آن، نام فایل منبع را چاپ می‌کند.
.It Ar version
نسخه‌ای از
.Xr discount 7
که این نسخه از theme با آن کامپایل شده است را چاپ می‌کند.
.El
.Pp
اگر ورودی از یک فایل خوانده شود و خروجی با گزینه
.Fl o
تنظیم نشده باشد،
.Nm
خروجی را در
.Pa file-sans-text.html
می‌نویسد
.Po
اگر
.Ar file
دارای پسوند
.Pa .text
باشد، آن پسوند حذف شده و با
.Pa .html
جایگزین می‌شود؛ در غیر این صورت
.Pa .html
به انتهای نام فایل اضافه خواهد شد.
.Pc
.Pp
گزینه‌ها به شرح زیر هستند:
.Bl -tag -width "-o file"
.It Fl d Pa root
تنظیم
.Em "document root"
روی
.Ar root
.It Fl E
به‌طور معمول
theme عبارت‌های
.Pa "<?theme body?>"
یا
.Pa "<?theme toc?>"
را در بخش
.Pa "<head>"
یا
.Pa "<?theme style?>"
را در بخش
.Pa "<body>"
گسترش نمی‌دهد، اما گزینه
.Fl E
این رفتار را نادیده گرفته و اجازه گسترش در همه‌جا را می‌دهد.
.It Fl f
رونویسی اجباری فایل‌های html موجود.
.It Fl o Pa filename
نوشتن خروجی در
.Ar filename .
.It Fl p Ar path
تنظیم pagename روی
.Ar path .
.It Fl t Ar filename
استفاده از
.Ar filename
به عنوان فایل قالب.
.El
.Sh "مقادیر بازگشتی (RETURN VALUES)"
ابزار
.Nm
در صورت موفقیت با مقدار ۰ و در صورت بروز خطا با مقداری بزرگ‌تر از ۰ خارج می‌شود.
.Sh "همچنین ببینید (SEE ALSO)"
.Xr markdown 1 ,
.Xr markdown 3 ,
.Xr markdown 7 ,
.Xr mkd-extensions 7 .
.Sh "نویسندگان (AUTHORS)"
.An David Parsons
.Pq Li orc@pell.portland.or.us