typst-query(1) General Commands Manual typst-query(1)

typst-query - یک فایل ورودی را برای استخراج فراداده‌های ارائه‌شده پردازش می‌کند (منسوخ شده، به‌جای آن از `eval` استفاده کنید)

typst-query [--field] [--one] [--format] [--pretty] [--target] [--root] [--input] [--font-path] [--ignore-system-fonts] [--ignore-embedded-fonts] [--package-path] [--package-cache-path] [--creation-timestamp] [-j|--jobs] [--features] [--diagnostic-format] [-h|--help] <INPUT> <SELECTOR>

یک فایل ورودی را برای استخراج فراداده‌های ارائه‌شده پردازش می‌کند (منسوخ شده، به‌جای آن از `eval` استفاده کنید).

تنها یک فیلد را از تمام عناصر بازیابی‌شده استخراج می‌کند
دقیقاً انتظار یک عنصر را دارد و آن را بازیابی می‌کند
قالب برای سریالی‌سازی

مقادیر ممکن:

  • json
  • yaml
آیا خروجی سریالی‌شده به‌صورت خوانا (pretty-print) چاپ شود یا خیر.

تنها برای قالب JSON اعمال می‌شود.

هدفی که کامپایل برای آن انجام می‌شود

مقادیر ممکن:

  • paged: قالب‌های تصویر و PDF
  • html: HTML
  • bundle: بسته (Bundle)
ریشه پروژه را (برای مسیرهای مطلق) پیکربندی می‌کند
همچنین می‌تواند با متغیر محیطی TYPST_ROOT مشخص شود.
یک جفت کلید-مقدار رشته‌ای که از طریق `sys.inputs` قابل مشاهده است اضافه می‌کند
پوشه‌های اضافی را اضافه می‌کند که به‌صورت بازگشتی برای یافتن قلم‌ها جستجو می‌شوند.

اگر چندین مسیر مشخص شده باشد، با جداکننده مسیر سیستم (در سیستم‌های شبه‌یونیکس `:` و در ویندوز `;`) از یکدیگر جدا می‌شوند.

همچنین می‌تواند با متغیر محیطی TYPST_FONT_PATHS مشخص شود.
تضمین می‌کند که قلم‌های سیستم جستجو نخواهند شد، مگر اینکه صراحتاً از طریق `--font-path` وارد شده باشند
همچنین می‌تواند با متغیر محیطی TYPST_IGNORE_SYSTEM_FONTS مشخص شود.
تضمین می‌کند که قلم‌های تعبیه‌شده در Typst در نظر گرفته نخواهند شد
همچنین می‌تواند با متغیر محیطی TYPST_IGNORE_EMBEDDED_FONTS مشخص شود.
مسیر سفارشی برای بسته‌های محلی، به‌طور پیش‌فرض به مکان وابسته به سیستم است
همچنین می‌تواند با متغیر محیطی TYPST_PACKAGE_PATH مشخص شود.
مسیر سفارشی برای حافظه پنهان بسته‌ها، به‌طور پیش‌فرض به مکان وابسته به سیستم است
همچنین می‌تواند با متغیر محیطی TYPST_PACKAGE_CACHE_PATH مشخص شود.
تاریخ ایجاد سند که به عنوان برچسب زمانی یونیکس (UNIX timestamp) قالب‌بندی شده است.

برای اطلاعات بیشتر، https://reproducible-builds.org/specs/source-date-epoch را ببینید.

همچنین می‌تواند با متغیر محیطی SOURCE_DATE_EPOCH مشخص شود.
تعداد وظایف موازی ایجادشده در حین کامپایل. پیش‌فرض برابر با تعداد پردازنده‌ها است. تنظیم آن روی 1 موازی‌سازی را غیرفعال می‌کند
ویژگی‌های در حال توسعه را فعال می‌کند که ممکن است در هر زمانی تغییر یابند یا حذف شوند

مقادیر ممکن:

  • html
  • bundle
  • a11y-extras
همچنین می‌تواند با متغیر محیطی TYPST_FEATURES مشخص شود.
قالبی که اطلاعات عیب‌یابی در آن خروجی داده می‌شوند

مقادیر ممکن:

  • human
  • short
چاپ راهنما (مشاهده خلاصه با '-h')
<INPUT>
مسیر فایل ورودی Typst. از `-` برای خواندن ورودی از stdin استفاده کنید
<SELECTOR>
عناصری که باید بازیابی شوند را تعیین می‌کند
typst-query