.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH typst-compile 1  "typst-compile " 
.SH "نام (NAME)"
typst\-compile \- کامپایل یک فایل ورودی به یکی از قالب‌های خروجی پشتیبانی‌شده
.SH "خلاصه دستور (SYNOPSIS)"
\fBtypst\-compile\fR [\fB\-f\fR|\fB\-\-format\fR] [\fB\-\-root\fR] [\fB\-\-input\fR] [\fB\-\-font\-path\fR] [\fB\-\-ignore\-system\-fonts\fR] [\fB\-\-ignore\-embedded\-fonts\fR] [\fB\-\-package\-path\fR] [\fB\-\-package\-cache\-path\fR] [\fB\-\-creation\-timestamp\fR] [\fB\-\-pretty\fR] [\fB\-\-pages\fR] [\fB\-\-pdf\-standard\fR] [\fB\-\-no\-pdf\-tags\fR] [\fB\-\-ppi\fR] [\fB\-\-deps\fR] [\fB\-\-deps\-format\fR] [\fB\-j\fR|\fB\-\-jobs\fR] [\fB\-\-features\fR] [\fB\-\-diagnostic\-format\fR] [\fB\-\-open\fR] [\fB\-\-timings\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIINPUT\fR> [\fIOUTPUT\fR] 
.SH "توضیحات (DESCRIPTION)"
یک فایل ورودی را به یکی از قالب‌های خروجی پشتیبانی‌شده کامپایل می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-f\fR, \fB\-\-format\fR \fI<FORMAT>\fR
قالب فایل خروجی؛ به‌طور پیش‌فرض از پسوند فایل تشخیص داده می‌شود.
.br

.br
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
pdf
.IP \(bu 2
png
.IP \(bu 2
svg
.IP \(bu 2
html
.IP \(bu 2
bundle
.RE
.TP
\fB\-\-root\fR \fI<DIR>\fR
ریشه پروژه را (برای مسیرهای مطلق) پیکربندی می‌کند.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBTYPST_ROOT\fR تعیین شود. 
.RE
.TP
\fB\-\-input\fR \fI<key=value>\fR
یک جفت کلید\-مقدار رشته‌ای اضافه می‌کند که از طریق `sys.inputs` قابل دسترسی است.
.TP
\fB\-\-font\-path\fR \fI<DIR>\fR
دایرکتوری‌های دیگری را اضافه می‌کند که قلم‌ها به‌صورت بازگشتی در آن‌ها جستجو می‌شوند.

اگر چند مسیر مشخص شده باشد، با جداکننده مسیر سیستم (در سیستم‌های شبه‌یونیکس `:` و در ویندوز `;`) از هم جدا می‌شوند.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBTYPST_FONT_PATHS\fR تعیین شود. 
.RE
.TP
\fB\-\-ignore\-system\-fonts\fR
تضمین می‌کند که قلم‌های سیستم جستجو نخواهند شد، مگر اینکه صریحاً از طریق `\-\-font\-path` وارد شده باشند.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBTYPST_IGNORE_SYSTEM_FONTS\fR تعیین شود. 
.RE
.TP
\fB\-\-ignore\-embedded\-fonts\fR
تضمین می‌کند که قلم‌های تعبیه‌شده در Typst در نظر گرفته نخواهند شد.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBTYPST_IGNORE_EMBEDDED_FONTS\fR تعیین شود. 
.RE
.TP
\fB\-\-package\-path\fR \fI<DIR>\fR
مسیر سفارشی برای بسته‌های محلی؛ به‌طور پیش‌فرض به مکانی وابسته به سیستم تعیین می‌شود.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBTYPST_PACKAGE_PATH\fR تعیین شود. 
.RE
.TP
\fB\-\-package\-cache\-path\fR \fI<DIR>\fR
مسیر سفارشی برای حافظه موقت (کَش) بسته‌ها؛ به‌طور پیش‌فرض به مکانی وابسته به سیستم تعیین می‌شود.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBTYPST_PACKAGE_CACHE_PATH\fR تعیین شود. 
.RE
.TP
\fB\-\-creation\-timestamp\fR \fI<UNIX_TIMESTAMP>\fR
تاریخ ایجاد سند در قالب برچسب زمانی یونیکس (UNIX timestamp).

برای اطلاعات بیشتر، <https://reproducible\-builds.org/specs/source\-date\-epoch> را ببینید.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBSOURCE_DATE_EPOCH\fR تعیین شود. 
.RE
.TP
\fB\-\-pretty\fR
خروجی تولیدشده زیبانگاری (pretty\-print) شود یا خیر.

این گزینه خروجی را به شیوه‌ای خواناتر برای انسان اما با بهره‌وری فضای کمتر قالب‌بندی می‌کند. بر صدور خروجی‌های HTML، SVG و PDF تأثیر می‌گذارد، اما بر صدور PNG بی‌تأثیر است.
.TP
\fB\-\-pages\fR \fI<PAGES>\fR
صفحاتی که باید صادر شوند. در صورت عدم تعیین، تمام صفحات صادر می‌شوند.

صفحات برای صدور با کاما از هم جدا می‌شوند و می‌توانند شماره صفحات ساده باشند (مانند \*(Aq2,5\*(Aq تنها برای صادر کردن صفحات ۲ و ۵) یا بازه‌ای از صفحات (مانند \*(Aq2,3\-6,8\-\*(Aq برای صادر کردن صفحه ۲، صفحات ۳ تا ۶ (شامل خود آن‌ها)، صفحه ۸ و تمام صفحات پس از آن).

شماره صفحات از یک شروع می‌شوند و متناظر با شماره صفحات فیزیکی در سند هستند (بنابراین تحت تأثیر شمارنده صفحه داخلی سند قرار نمی‌گیرند).
.TP
\fB\-\-pdf\-standard\fR \fI<PDF_STANDARD>\fR
یک یا چند استاندارد PDF (جداشده با کاما) که Typst مطابقت با آن‌ها را اعمال می‌کند.
.br

.br
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
1.4: PDF 1.4
.IP \(bu 2
1.5: PDF 1.5
.IP \(bu 2
1.6: PDF 1.6
.IP \(bu 2
1.7: PDF 1.7
.IP \(bu 2
2.0: PDF 2.0
.IP \(bu 2
a\-1b: PDF/A\-1b
.IP \(bu 2
a\-1a: PDF/A\-1a
.IP \(bu 2
a\-2b: PDF/A\-2b
.IP \(bu 2
a\-2u: PDF/A\-2u
.IP \(bu 2
a\-2a: PDF/A\-2a
.IP \(bu 2
a\-3b: PDF/A\-3b
.IP \(bu 2
a\-3u: PDF/A\-3u
.IP \(bu 2
a\-3a: PDF/A\-3a
.IP \(bu 2
a\-4: PDF/A\-4
.IP \(bu 2
a\-4f: PDF/A\-4f
.IP \(bu 2
a\-4e: PDF/A\-4e
.IP \(bu 2
ua\-1: PDF/UA\-1
.RE
.TP
\fB\-\-no\-pdf\-tags\fR
به‌طور پیش‌فرض، حتی زمانی که یک سند `PDF/UA\-1` تولید نمی‌شود، یک سند PDF برچسب‌دار (tagged) نوشته می‌شود تا پایه دسترسی‌پذیری فراهم گردد. در برخی شرایط (برای مثال هنگام تلاش برای کاهش حجم سند) ممکن است غیرفعال کردن PDF برچسب‌دار مطلوب باشد.
.TP
\fB\-\-ppi\fR \fI<PPI>\fR [پیش‌فرض: 144]
میزان PPI (پیکسل بر اینچ) برای صدور خروجی PNG.
.TP
\fB\-\-deps\fR \fI<PATH>\fR
مسیر فایلی که فهرستی از وابستگی‌های کامپایل فعلی در آن نوشته خواهد شد. برای نوشتن در stdout از `\-` استفاده کنید.
.TP
\fB\-\-deps\-format\fR \fI<DEPS_FORMAT>\fR [پیش‌فرض: json]
قالب فایل مورد استفاده برای وابستگی‌ها.
.br

.br
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
json: به‌صورت JSON کدگذاری می‌کند و برای مسیرهای غیر یونیکد با خطا متوقف می‌شود
.IP \(bu 2
zero: مسیرها را با بایت‌های NULL جدا می‌کند و می‌تواند تمام مسیرها را بیان کند
.IP \(bu 2
make: در قالب Make خروجی می‌دهد و از مسیرهای غیرقابل بیان صرف‌نظر می‌کند
.RE
.TP
\fB\-j\fR, \fB\-\-jobs\fR \fI<JOBS>\fR
تعداد پردازش‌های موازی ایجادشده در طول کامپایل. مقدار پیش‌فرض تعداد پردازنده‌ها (CPU) است. مقدار 1 پردازش موازی را غیرفعال می‌کند.
.TP
\fB\-\-features\fR \fI<FEATURES>\fR
قابلیت‌های در حال توسعه را فعال می‌کند که ممکن است در هر زمانی تغییر کرده یا حذف شوند.
.br

.br
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
html
.IP \(bu 2
bundle
.IP \(bu 2
a11y\-extras
.RE
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBTYPST_FEATURES\fR تعیین شود. 
.RE
.TP
\fB\-\-diagnostic\-format\fR \fI<DIAGNOSTIC_FORMAT>\fR [پیش‌فرض: human]
قالبی که خطایابی‌ها در آن ارائه می‌شوند.
.br

.br
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
human
.IP \(bu 2
short
.RE
.TP
\fB\-\-open\fR [\fI<VIEWER>\fR]
پس از کامپایل، فایل خروجی را با نمایش‌دهنده پیش‌فرض یا برنامه‌ای خاص باز می‌کند. اگر خروجی stdout باشد نادیده گرفته می‌شود.
.TP
\fB\-\-timings\fR \fI<OUTPUT_JSON>\fR
زمان‌بندی‌های کارایی فرایند کامپایل را تولید می‌کند. (آزمایشی)

فایل JSON حاصل را می‌توان در ابزارهای ردیابی مانند <https://ui.perfetto.dev> بارگذاری کرد. این فایل به جز نام فایل‌ها و شماره خطوط، حاوی هیچ اطلاعات حساسی نیست.
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش راهنما (مشاهده خلاصه با \*(Aq\-h\*(Aq).
.TP
<\fIINPUT\fR>
مسیر فایل ورودی Typst. برای خواندن ورودی از stdin از `\-` استفاده کنید.
.TP
[\fIOUTPUT\fR]
مسیر فایل خروجی (PDF، PNG، SVG، یا HTML). برای نوشتن خروجی در stdout از `\-` استفاده کنید.

برای قالب‌های خروجی که به ازای هر صفحه یک فایل تولید می‌کنند (PNG و SVG)، در صورتی که سند مبدأ به چندین صفحه تبدیل شود، باید یک الگوی شماره صفحه وجود داشته باشد. از `{p}` برای شماره صفحه، از `{0p}` برای شماره صفحه پر شده با صفر (zero padded) و از `{t}` برای تعداد کل صفحات استفاده کنید. برای مثال، `page\-{0p}\-of\-{t}.png` فایل‌های `page\-01\-of\-10.png`، `page\-02\-of\-10.png` و غیره را ایجاد می‌کند.