.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH typst-query 1  "typst-query " 
.SH "نام (NAME)"
typst\-query \- یک فایل ورودی را برای استخراج فراداده‌های ارائه‌شده پردازش می‌کند (منسوخ شده، به‌جای آن از `eval` استفاده کنید)
.SH "خلاصه دستور (SYNOPSIS)"
\fBtypst\-query\fR [\fB\-\-field\fR] [\fB\-\-one\fR] [\fB\-\-format\fR] [\fB\-\-pretty\fR] [\fB\-\-target\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\-j\fR|\fB\-\-jobs\fR] [\fB\-\-features\fR] [\fB\-\-diagnostic\-format\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIINPUT\fR> <\fISELECTOR\fR> 
.SH "توضیحات (DESCRIPTION)"
یک فایل ورودی را برای استخراج فراداده‌های ارائه‌شده پردازش می‌کند (منسوخ شده، به‌جای آن از `eval` استفاده کنید).
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-\-field\fR \fI<FIELD>\fR
تنها یک فیلد را از تمام عناصر بازیابی‌شده استخراج می‌کند
.TP
\fB\-\-one\fR
دقیقاً انتظار یک عنصر را دارد و آن را بازیابی می‌کند
.TP
\fB\-\-format\fR \fI<FORMAT>\fR [پیش‌فرض: json]
قالب برای سریالی‌سازی
.br

.br
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
json
.IP \(bu 2
yaml
.RE
.TP
\fB\-\-pretty\fR
آیا خروجی سریالی‌شده به‌صورت خوانا (pretty\-print) چاپ شود یا خیر.

تنها برای قالب JSON اعمال می‌شود.
.TP
\fB\-\-target\fR \fI<TARGET>\fR [پیش‌فرض: paged]
هدفی که کامپایل برای آن انجام می‌شود
.br

.br
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
paged: قالب‌های تصویر و PDF
.IP \(bu 2
html: HTML
.IP \(bu 2
bundle: بسته (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\-j\fR, \fB\-\-jobs\fR \fI<JOBS>\fR
تعداد وظایف موازی ایجادشده در حین کامپایل. پیش‌فرض برابر با تعداد پردازنده‌ها است. تنظیم آن روی 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\-h\fR, \fB\-\-help\fR
چاپ راهنما (مشاهده خلاصه با \*(Aq\-h\*(Aq)
.TP
<\fIINPUT\fR>
مسیر فایل ورودی Typst. از `\-` برای خواندن ورودی از stdin استفاده کنید
.TP
<\fISELECTOR\fR>
عناصری که باید بازیابی شوند را تعیین می‌کند