نام (NAME)

sile - موتور صفحه‌آرایی و حروف‌چینی بهبودیافته سایمون

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

sile [options] [INPUT]

توضیحات (DESCRIPTION)

حروف‌چین SILE فایل(های) ورودی را می‌خواند و محتوای آن‌ها را در قالب یک سند خروجی، معمولاً PDF، حروف‌چینی می‌کند.

به‌طور پیش‌فرض، فایل‌های ورودی می‌توانند با نشانه‌گذاری اعلانی SIL، ساختاریافته XML، یا برنامه‌نویسی‌شده با Lua باشند. قالب ورودی به‌طور خودکار توسط ماژول‌های فعال شناسایی می‌شود. به‌طور پیش‌فرض، خروجی فایلی هم‌نام با اولین فایل ورودی خواهد بود که پسوند آن به .pdf تغییر یافته است. نام فایل خروجی را می‌توان با آرگومان --output تغییر داد. با استفاده از --backend می‌توان قالب خروجی متفاوتی (یا راه‌انداز دیگری برای همان قالب) مشخص کرد. قالب‌های ورودی یا خروجی اضافی را می‌توان با بارگذاری یک ماژول شخص ثالث که از آن‌ها پشتیبانی می‌کند، از طریق افزودن آرگومان --use در خط فرمان مدیریت کرد (که پیش از تلاش برای خواندن اسناد ورودی بارگذاری خواهد شد).

گزینه‌ها (OPTIONS)

-b, --backend=value

مشخص کردن بک‌اند خروجی.

مقدار پیش‌فرض libtexpdf است و برای بیشتر خروجی‌های PDF مناسب است. جایگزین‌های پشتیبانی‌شده به‌صورت توکار شامل text، debug، dummy، cairo و podofo هستند. سایر تولیدکنندگان خروجی را می‌توان از طریق --use فعال کرد.

-c, --class=value

بازنویسی کلاس پیش‌فرض یا مشخص‌شده سند.

کلاس پیش‌فرض برای اسنادی که کلاسی در تگ ریشه تعیین نکرده‌اند plain است. از این گزینه می‌توان برای تغییر کلاس پیش‌فرض یا بازنویسی کلاس مشخص‌شده در یک سند استفاده کرد. سایر کلاس‌های ارائه‌شده همراه برنامه شامل base، bible، book، diglot، docbook، docbook، jbook، jplain، letter، pecha، tbook، tplain و triglot هستند. کلاس‌های دیگر به‌طور پویا از مسیر ماژول بارگذاری خواهند شد.

-d, --debug=value[,value]

نمایش اطلاعات اشکال‌زدایی برای جنبه‌های مشخص‌شده از عملکرد SILE.

پرچم‌های اشکال‌زدایی متعدد را می‌توان به‌صورت فهرستی جداشده با کاما مشخص کرد. اگرچه بسته‌ها ممکن است پرچم‌های اشکال‌زدایی خود را تعریف کنند، پرکاربردترین آن‌ها عبارتند از typesetter، pagebuilder، vboxes، break، frames، profile و versions. می‌توان بیش از یک بار مشخص کرد.

-e, --evaluate=value

ارزیابی عبارت Lua پیش از پردازش ورودی.

می‌توان بیش از یک بار مشخص کرد.

-E, --evaluate-after=value

ارزیابی عبارت Lua پس از پردازش ورودی.

می‌توان بیش از یک بار مشخص کرد.

-f, --fontmanager=value

مشخص کردن مدیر قلم مورد استفاده.

مدیر قلم مسئول پیدا کردن مکان فایل‌های قلم روی سیستم با توجه به نام قلم است. مدیر قلم پیش‌فرض در سیستم‌های غیر macOS، fontconfig و در macOS، macfonts است.

-m, --makedepsfile

تولید فهرستی از وابستگی‌ها در قالب Makefile.

این گزینه تمام فایل‌های استفاده‌شده در طول فرایند حروف‌چینی (فایل‌های ورودی، کتابخانه‌های Lua، قلم‌ها، تصاویر و غیره) را ردیابی می‌کند. پس از اتمام، فهرست در FILE و در قالب فهرست وابستگی برای یک هدف در یک Makefile نوشته می‌شود. این فهرست می‌تواند بعداً برای تعیین اینکه آیا با تغییر هر یک از ورودی‌ها، PDF نیاز به رندر مجدد دارد یا خیر، استفاده شود.

-o, --output=file

تنظیم صریح نام فایل خروجی.

به‌طور پیش‌فرض از نام پایه (basename) اولین فایل ورودی به عنوان نام فایل خروجی استفاده خواهد شد. پسوند بر اساس بک‌اند خروجی انتخاب می‌شود که معمولاً .pdf است. با این گزینه می‌توان هر نام و مسیر دلخواهی را تعیین کرد. علاوه بر این می‌توان از - برای نوشتن خروجی در STDOUT استفاده کرد.

-O, --options=parameter=value[,parameter=value]

تنظیم یا بازنویسی گزینه‌های کلاس سند.

می‌تواند برای تغییر گزینه‌های پیش‌فرض یا بازنویسی گزینه‌های تعیین‌شده در یک سند به کار رود. به عنوان مثال، تنظیم --options papersize=letter هم مقدار پیش‌فرض papersize (که A4 است) و هم هر مقدار مشخص‌شده در گزینه‌های سند را بازنویسی می‌کند. می‌توان بیش از یک بار مشخص کرد.

-I, --include=filename

منسوخ شده است؛ از --use، --preamble، --postamble یا چندین فایل ورودی استفاده کنید.

-p, --preamble=filename

گنجاندن محتوای یک فایل SIL، XML یا سایر فایل‌های منبع، پیش از محتوای سند ورودی.

مقدار باید یک نام فایل کامل با مسیر نسبی نسبت به PWD یا یک مسیر مطلق باشد. می‌توان بیش از یک بار مشخص کرد.

-P, --postamble=filename

گنجاندن محتوای یک فایل SIL، XML یا سایر فایل‌های منبع، پس از محتوای سند ورودی.

مقدار باید یک نام فایل کامل با مسیر نسبی نسبت به PWD یا یک مسیر مطلق باشد. می‌توان بیش از یک بار مشخص کرد.

-u, --use=module[[parameter=value[,parameter=value]]]

بارگذاری و مقداردهی اولیه یک کلاس، ورودی‌گیر (inputter)، شکل‌دهنده قلم (shaper) یا ماژول‌های دیگر پیش از پردازش ورودی اصلی.

مقدار باید نام یک ماژول قابل‌بارگذاری (بدون پسوند، با استفاده از '.' به عنوان جداکننده مسیر) باشد و با استفاده از مسیر جستجوی ماژول‌های SILE بارگذاری خواهد شد. گزینه‌ها را می‌توان با قرار دادن جفت‌های key=value درون قلاب‌ها به دنبال نام ماژول ارسال کرد. این قابلیت به‌ویژه زمانی مفید است که سند ورودی SIL یا طرح‌واره XML شناخته‌شده به‌صورت توکار نباشد و SILE پیش از تلاش برای خواندن فایل ورودی، نیاز به یادگیری قابلیت‌های جدید داشته باشد. اگر ماژول یک کلاس سند باشد، جایگزین plain به عنوان کلاس پیش‌فرض برای پردازش اسنادی می‌شود که کلاسی را مشخص نکرده‌اند. از آنجا که این گزینه پیش از بارگذاری سند اجرا می‌شود، حتی می‌تواند یک تجزیه‌کننده ورودی جدید اضافه کند یا یک تجزیه‌کننده موجود را برای پشتیبانی از قالب‌های فایل جدید تغییر دهد. ماژول‌های بسته به دیباچه (preamble) اضافه خواهند شد تا پس از مقداردهی اولیه کلاس بارگذاری شوند. می‌توان بیش از یک بار مشخص کرد.

-q, --quiet

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

-t, --traceback

نمایش ردگیری دقیق مکان خطاها در هنگام بروز خطاها و هشدارها.

[INPUT]

نام فایل(های) سند ورودی، به‌طور پیش‌فرض در قالب‌های SIL، XML یا Lua.

یک یا چند فایل ورودی که محتوا از آن‌ها پردازش می‌شود. اولین فایل فهرست‌شده به عنوان سند اصلی در نظر گرفته می‌شود و بقیه به ترتیب پردازش می‌شوند. قالب‌های ورودی‌گیر دیگر را می‌توان از طریق --use فعال کرد. از - برای خواندن جریان محتوا از STDIN استفاده کنید.

-h, --help

چاپ پیام راهنما و خروج.

-v, --version

چاپ نسخه.