SILE(1) General Commands Manual SILE(1)

sile - سیستم حروف‌چینی اسناد، خواندن فایل‌های ورودی و رندر محتوا در قالبی معمولاً PDF

sile [-b|--backend] [-c|--class] [-d|--debug] [-e|--evaluate] [-E|--evaluate-after] [-f|--fontmanager] [--luarocks-tree] [-m|--makedeps] [-o|--output] [-O|--option] [-p|--preamble] [-P|--postamble] [-u|--use] [-q|--quiet] [-t|--traceback] [-h|--help] [INPUT]

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

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

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

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

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

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

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

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

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

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

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

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

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

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

افزودن یک مسیر به فهرست درخت‌های LuaRocks که برای یافتن ماژول‌ها جستجو می‌شوند.

هنگام نصب ماژول‌های شخص ثالث SILE از طریق LuaRocks، چندین مکان نصب احتمالی وجود دارد. آن‌ها ممکن است در سیستم میزبان، دایرکتوری خانگی کاربر، مسیری محلی در پروژه یا هر مکان دلخواهی نصب شوند. در مورد سیستم یا مسیر محلی پروژه‌ای که دقیقاً `lua_modules` نام دارد، ماژول‌ها به‌طور خودکار پیدا خواهند شد. در مورد هر مسیر دیگری، باید به SILE اعلام شود که کجا آن‌ها را پیدا کند. این کار را می‌توان با تنظیم متغیر محیطی LUA_PATH پیش از اجرای SILE یا با استفاده از این گزینه انجام داد.

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

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

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

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

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

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

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

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

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

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

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

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

فرونشاندن هشدارها و پیام‌های اطلاعاتی در حین پردازش.
نمایش ردگیری دقیق پشته فراخوانی خطا (traceback) هنگام وقوع خطاها و هشدارها.
چاپ راهنما (مشاهده خلاصه با '-h').
[INPUT]
نام فایل(های) سند ورودی، به‌طور پیش‌فرض در قالب‌های SIL، XML یا Lua.

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

Simon Cozens, Caleb Maclennan <caleb@alerque.com>, Olivier Nicole, Didier Willis

SILE