.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "LUAOTFLOAD-TOOL" 1 "2024-12-03" "3.29" "text processing"
.SH "نام (NAME)"
luaotfload-tool \- تولید و جست‌وجوی پایگاه‌داده نام‌های قلم در Luaotfload
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBluaotfload\-tool\fP [ \-bcDfFiIlLnpqRSuvVhw ]
.INDENT 0.0
.TP
.B \fBluaotfload\-tool\fP \-\-update [ \-\-force ] [ \-\-quiet ] [ \-\-verbose ]
[ \-\-prefer\-texmf ] [ \-\-dry\-run ]
[ \-\-formats=[+|\-]EXTENSIONS ]
[ \-\-no\-compress ] [ \-\-no\-strip ]
[ \-\-local ] [ \-\-max\-fonts=N ]
.TP
.B \fBluaotfload\-tool\fP \-\-find=FONTNAME [ \-\-fuzzy ] [ \-\-info ] [ \-\-inspect ]
[ \-\-no\-reload ]
.UNINDENT
.sp
\fBluaotfload\-tool\fP \-\-flush\-lookups
.sp
\fBluaotfload\-tool\fP \-\-cache=DIRECTIVE
.sp
\fBluaotfload\-tool\fP \-\-list=CRITERION[:VALUE] [ \-\-fields=F1,F2,...,Fn ]
.sp
\fBluaotfload\-tool\fP \-\-bisect=DIRECTIVE
.sp
\fBluaotfload\-tool\fP \-\-help
.sp
\fBluaotfload\-tool\fP \-\-version
.sp
\fBluaotfload\-tool\fP \-\-show\-blacklist
.sp
\fBluaotfload\-tool\fP \-\-diagnose=CHECK
.sp
\fBluaotfload\-tool\fP \-\-conf=FILE \-\-dumpconf
.SH "توضیحات (DESCRIPTION)"
.sp
ابزار luaotfload\-tool به پایگاه‌داده نام‌های قلم که برای بسته \fILuaotfload\fP مورد نیاز است دسترسی پیدا می‌کند. دو حالت کلی وجود دارد: \fBupdate\fP و \fBquery\fP\&.
.INDENT 0.0
.IP \(bu 2
\fBupdate\fP: به‌روزرسانی پایگاه‌داده یا بازسازی کامل آن؛
.IP \(bu 2
\fBquery\fP: تطبیق نام قلم یا نمایش نزدیک‌ترین موارد منطبق.
.UNINDENT
.SH "گزینه‌ها (OPTIONS)"
.SS "حالت به‌روزرسانی (update mode)"
.INDENT 0.0
.TP
.B  \-\-update\fP,\fB  \-u
به‌روزرسانی پایگاه‌داده؛ نمایه‌سازی قلم‌های جدید.
.TP
.B  \-\-force\fP,\fB  \-f
اجبار به بازسازی پایگاه‌داده؛ نمایه‌سازی مجدد تمام قلم‌ها.
.TP
.B  \-\-local\fP,\fB  \-L
شامل کردن فایل‌های قلم موجود در \fB$PWD\fP\&. این گزینه باعث بازسازی بخش‌های بزرگی از پایگاه‌داده می‌شود؛ بنابراین کاملاً ناکارآمد است. علاوه‌بر این، در صورت یافت شدن فایل‌های قلم محلی، از ذخیره شدن پایگاه‌داده روی دیسک جلوگیری می‌شود، بنابراین قلم‌های محلی باید با هر بار فراخوانی \fBluaotfload\-tool\fP مجدداً پردازش شوند.
.TP
.B  \-\-no\-reload\fP,\fB  \-n
جلوگیری از به‌روزرسانی‌های خودکار پایگاه‌داده (برای مثال زمانی که یک نام ناشناخته به \fB\-\-find\fP داده می‌شود).
.TP
.B  \-\-no\-compress\fP,\fB  \-c
فیلتر نکردن نسخه متنی ساده نمایه قلم از طریق gzip. در صورتی که ویرایشگر شما بدون پشتیبانی از zlib ساخته شده باشد، برای اشکال‌زدایی مفید است.
.TP
.B  \-\-prefer\-texmf\fP,\fB  \-p
سازماندهی پایگاه‌داده نام فایل‌ها به گونه‌ای که در صورت نصب بودن قلم‌ها در هر دو مسیر، قلم‌های موجود در درخت \fITEXMF\fP را به قلم‌های سیستمی ترجیح دهد.
.TP
.BI \-\-formats\fB= EXTENSIONS
پسوند فایل‌های قلم برای نمایه‌سازی.
در اینجا \fIEXTENSIONS\fP فهرستی جداشده با کاما از پسوندهای فایل پشتیبانی‌شده (otf, ttf, ttc) است.
اگر علامت \fB+\fP در ابتدای فهرست بیاید، موارد داده‌شده به فهرست فعال فعلی اضافه می‌شوند؛ \fB\-\fP آن‌ها را کسر می‌کند.
پیش‌فرض: \fIotf,ttf,ttc\fP\&.
مثال‌ها:
.INDENT 7.0
.IP 1. 3
\fB\-\-formats=\-ttc,ttf\fP از قلم‌های TrueType و بسته‌های مجموعه‌قلم صرف‌نظر می‌کند؛
.IP 2. 3
\fB\-\-formats=otf\fP فقط فایل‌های OpenType را پویش می‌کند؛
.IP 3. 3
\fB\-\-formats=+afm\fP فایل‌های باینری Postscript را که همراه با یک فایل AFM باشند شامل می‌شود.
.UNINDENT
.UNINDENT.SS "حالت پرس‌وجو (query mode)"
.INDENT 0.0
.TP
.BI \-\-find\fB= NAME
نام یک قلم را تطبیق می‌دهد؛ این گزینه <name> را در
پایگاه‌داده جست‌وجو کرده و نام فایلی را که به آن
نگاشت شده است چاپ می‌کند.
\fB\-\-find\fP همچنین ساختار درخواست (request syntax) را نیز درک می‌کند؛
برای نمونه \fB\-\-find=file:foo.otf\fP بررسی می‌کند که آیا
\fBfoo.otf\fP ایندکس شده است یا خیر.
.TP
.B  \-\-fuzzy\fP,\fB  \-F
در صورتی که جست‌وجو ناموفق باشد، مطابقت‌های تقریبی را برای
نام فایل نمایش می‌دهد (نیازمند \fB\-\-find\fP است).
.TP
.B  \-\-info\fP,\fB  \-i
اطلاعات پایه مربوط به فایل قلم تطبیق‌یافته را نمایش می‌دهد
(نیازمند \fB\-\-find\fP است).
.TP
.B  \-\-inspect\fP,\fB  \-I
اطلاعات تفصیلی را با بارگذاری قلم و تحلیل جدول قلم
نمایش می‌دهد؛ بسیار کُند است!
برای درک معنای فیلدهای بازگردانده‌شده، مستندات
LuaTeX را ببینید.
(نیازمند \fB\-\-find\fP است).
.TP
.BI \-\-list\fB= CRITERION
مدخل‌ها را نمایش می‌دهد، به طوری که \fICRITERION\fP یکی از
موارد زیر است:
.INDENT 7.0
.IP 1. 3
نویسهٔ \fB*\fP، که تمام مدخل‌ها را انتخاب می‌کند؛
.IP 2. 3
فیلدی از یک مدخل پایگاه‌داده، برای نمونه
\fIversion\fP یا \fIformat*\fP، که خروجی بر اساس آن
مرتب‌سازی خواهد شد.
اطلاعات در یک پایگاه‌داده پالایش‌نشده (گزینهٔ
\fB\-\-no\-strip\fP در بالا را ببینید) تو در تو است:
زیرفیلدهای یک رکورد را می‌توان با استفاده از جداکنندهٔ
\fB\->\fP آدرس‌دهی کرد؛ برای نمونه:
\fBfile\->location\fP، \fBstyle\->units_per_em\fP،
یا
\fBnames\->sanitized\->english\->prefmodifiers\fP\&.
توجه: ساختار پوسته (shell) ایجاب می‌کند که آرگومان‌های
حاوی \fB\->\fP به‌درستی داخل گیومه قرار گیرند!
.IP 3. 3
عبارتی به شکل \fBfield:value\fP برای محدود کردن خروجی
به مدخل‌هایی که در آن‌ها \fBfield\fP با \fBvalue\fP مطابقت
دارد. \fBvalue\fP می‌تواند حاوی \fB*\fP باشد تا با
تعداد دلخواهی از نویسه‌ها مطابقت یابد.
.UNINDENT
.sp
برای نمونه، جهت چاپ نام فایل‌ها و نسخه‌های متناظرشان،
مرتب‌شده بر اساس قالب قلم:
.INDENT 7.0
.INDENT 3.5
.sp
.nf
.ft C
\&./luaotfload\-tool.lua \-\-list="format" \-\-fields="file\->base,version"
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
این دستور چنین خروجی می‌دهد:
.INDENT 7.0
.INDENT 3.5
.sp
.nf
.ft C
otf latinmodern\-math.otf  Version 1.958
otf lmromancaps10\-oblique.otf 2.004
otf lmmono8\-regular.otf 2.004
otf lmmonoproplt10\-bold.otf 2.004
otf lmsans10\-oblique.otf  2.004
otf lmromanslant8\-regular.otf 2.004
otf lmroman12\-italic.otf  2.004
otf lmsansdemicond10\-oblique.otf  2.004
\&...
.ft P
.fi
.UNINDENT
.UNINDENT
.TP
.BI \-\-fields\fB= FIELDS
فهرست جداشده با کاما از فیلدهایی که باید چاپ شوند.
اطلاعات در یک پایگاه‌داده پالایش‌نشده (گزینهٔ
\fB\-\-no\-strip\fP در بالا را ببینید) تو در تو است:
زیرفیلدهای یک رکورد را می‌توان با استفاده از جداکنندهٔ
\fB\->\fP آدرس‌دهی کرد؛ برای نمونه:
\fBfile\->location\fP، \fBstyle\->units_per_em\fP،
یا \fBnames\->sanitized\->english\->subfamily\fP\&.
پیش‌فرض plainname,version* است.
(تنها همراه با \fB\-\-list\fP معنادار است.)
.UNINDENT.SS حافظه‌های موقت فونت و جست‌وجو (font and lookup caches)
.INDENT 0.0
.TP
.B  \-\-flush\-lookups
پاک‌سازی حافظهٔ موقت جست‌وجوی نام فونت (آزمایشی).
.TP
.BI \-\-cache\fB= DIRECTIVE
مدیریت حافظهٔ موقت، که در آن \fIDIRECTIVE\fP یکی از موارد زیر است:
.INDENT 7.0
.IP 1. 3
\fBpurge\fP \-> حذف فایل‌های Lua از حافظهٔ موقت؛
.IP 2. 3
\fBerase\fP \-> حذف فایل‌های Lua و Luc از حافظهٔ موقت؛
.IP 3. 3
\fBshow\fP  \-> چاپ آمار.
.UNINDENT
.UNINDENT
.SS روش‌های اشکال‌زدایی (debugging methods)
.INDENT 0.0
.TP
.B  \-\-show\-blacklist\fP,\fB  \-b
نمایش فایل‌های موجود در سیاههٔ سیاه (نه دایرکتوری‌ها).
.TP
.B  \-\-dry\-run\fP,\fB  \-D
هنگام به‌روزرسانی پایگاه‌داده فونت‌ها را بارگیری نکن؛ فقط دایرکتوری‌ها را پیمایش کن.
(برای اشکال‌زدایی مسائل مربوط به سیستم فایل.)
.TP
.B  \-\-no\-strip
پس از ساخت پایگاه‌داده، اطلاعات زائد را حذف نکن. هشدار: این کار نمایه را به حدود دو تا سه برابر اندازهٔ عادی متورم می‌کند.
.TP
.BI \-\-max\-fonts\fB= N
پردازش حداکثر \fIN\fP فایل فونت، شامل فونت‌هایی که پیش‌تر در شمارش نمایه شده‌اند.
.TP
.BI \-\-bisect\fB= DIRECTIVE
دوبخشی‌سازی (Bisection) پایگاه‌دادهٔ فونت.
این حالت به عنوان کمکی برای اشکال‌زدایی موتور Luatex در نظر گرفته شده است، به ویژه هنگام ردیابی نشت‌های حافظه یا فونت‌های دارای اشکال.
.sp
\fIDIRECTIVE\fP می‌تواند یکی از موارد زیر باشد:
.INDENT 7.0
.IP 1. 3
\fBrun\fP \-> واداشتن \fBluaotfload\-tool\fP به رعایت پیشرفت دوبخشی‌سازی هنگام اجرا. در ترکیب با \fB\-\-update\fP و احتمالاً \fB\-\-force\fP، این گزینه تنها فایل‌ها را از ابتدا تا نقطهٔ محوری (pivot) پردازش کرده و بقیه را نادیده می‌گیرد.
.IP 2. 3
\fBstart\fP \-> آغاز دوبخشی‌سازی: ایجاد فایل وضعیت دوبخشی‌سازی و مقداردهی اولیهٔ نمایه‌های پایین (low)، بالا (high) و محوری (pivot).
.IP 3. 3
\fBstop\fP \-> پایان دادن به نشست دوبخشی‌سازی کنونی با حذف فایل وضعیت.
.IP 4. 3
\fBgood\fP | \fBbad\fP \-> علامت‌گذاری آخرین بخش پردازش‌شده به ترتیب به عنوان \(lqgood\(rq یا \(lqbad\(rq. گام بعدیِ دوبخشی‌سازی با بخش خراب (bad) ادامه خواهد یافت.
.IP 5. 3
\fBstatus\fP \-> چاپ اطلاعات وضعیت دربارهٔ نشست دوبخشی‌سازی کنونی. نکته: برای خروجی بیشتر، با تنظیمات پرگویی (verbosity) بالاتر استفاده کنید.
.UNINDENT
.sp
یک نشست دوبخشی‌سازی با صدور دستورالعمل \fBstart\fP آغاز می‌شود. این کار نقطهٔ محوری (pivot) را در وسط فهرست فایل‌های فونت موجود قرار می‌دهد. اکنون \fIluaotfload\-tool\fP را با پرچم فعال \fB\-\-update\fP و همچنین \fB\-\-bisect=run\fP اجرا کنید: تنها فونت‌های تا نقطهٔ محوری در نظر گرفته خواهند شد. اگر آن وظیفه اشکالی را که ردیابی می‌کنید نشان داد، با استفاده از \fB\-\-bisect=bad\fP\& به Luaotfload اطلاع دهید. گام بعدی \fB\-\-bisect=run\fP دوبخشی‌سازی را با بخشی از فایل‌های پایین‌تر از نقطهٔ محوری ادامه خواهد داد. به همین ترتیب، با فرض اینکه بخش آزموده‌شده از فهرست باگ را تحریک نکرده باشد، \fB\-\-bisect=good\fP را صادر کنید تا کار با فونت‌های بالاتر از نقطهٔ محوری ادامه یابد.
.sp
پس از اینکه فونت معیوب ردیابی شد، \fBgood\fP یا \fBbad\fP دیگر هیچ اثری نخواهند داشت. \fBrun\fP در نهایت همیشه همان یک فایل فونت باقی‌مانده را پردازش خواهد کرد. از \fB\-\-bisect=stop\fP برای پاک‌سازی وضعیت دوبخشی‌سازی استفاده کنید.
.UNINDENT.SS "متفرقه (MISCELLANEOUS)"
.INDENT 0.0
.TP
.BI \-\-verbose\fB= N\fR,\fB \ \-v
تنظیم سطح پرگویی به \fIn\fP یا به تعداد
تکرارهای \fB\-v\fP\&.
.TP
.B  \-\-quiet
بدون خروجی پرگو (تنظیم سطح گزارش وقایع روی صفر).
.TP
.BI \-\-log\fB= CHANNEL
تغییر مسیر خروجی گزارش وقایع (برای عیب‌یابی
پایگاه داده)، که در آن \fICHANNEL\fP می‌تواند یکی از موارد زیر باشد:
.INDENT 7.0
.IP 1. 3
\fBstdout\fP \-> تمام خروجی در ترمینال
تخلیه خواهد شد (پیش‌فرض)؛ یا
.IP 2. 3
\fBfile\fP \-> نوشتن در فایلی در دایرکتوری موقت
(نام فایل به‌طور خودکار انتخاب
خواهد شد).
.UNINDENT
.TP
.B  \-\-version\fP,\fB  \-V
نمایش شماره نسخه مؤلفه‌ها به‌همراه
برخی اطلاعات پایه‌ای و خروج.
.TP
.B  \-\-help\fP,\fB  \-h
نمایش پیام راهنما و خروج.
.TP
.BI \-\-diagnose\fB= CHECK
اجرای فرایند خطایابی \fICHECK\fP\&. فرایندهای
موجود عبارتند از:
.INDENT 7.0
.IP 1. 3
\fBfiles\fP \-> بررسی فایل‌های \fILuaotfload\fP برای
تغییرات؛
.IP 2. 3
\fBpermissions\fP \-> بررسی دسترسی‌های
دایرکتوری‌ها و فایل‌های کَش؛
.IP 3. 3
.INDENT 3.0
.TP
.B \fBenvironment\fP \-> چاپ متغیرهای
محیطی و kpse مرتبط؛
.UNINDENT
.IP 4. 3
\fBrepository\fP \-> بررسی مخزن git
برای انتشارهای جدید،
.IP 5. 3
\fBindex\fP \-> بررسی پایگاه داده، نمایش
اطلاعات درباره آن.
.UNINDENT
.sp
می‌توان فرایندها را با متصل کردن توسط کاما زنجیر کرد،
مانند \fB\-\-diagnose=files,permissions\fP\&.
برای اجرای تمام بررسی‌ها \fBthorough\fP را مشخص کنید.
.TP
.BI \-\-conf\fB= FILE
خواندن پیکربندی از \fIFILE\fP\&. برای مستندات
مربوط به قالب و گزینه‌های موجود،
\fBluaotfload.conf\fP(%) را ببینید.
.TP
.B  \-\-dumpconf
چاپ پیکربندی در حال حاضر فعال؛ خروجی
می‌تواند در یک فایل ذخیره شده و برای راه‌اندازی اولیه
فایل‌های پیکربندی سفارشی استفاده شود.
.TP
.B  \-\-aliases
تخلیه پایگاه داده نام قلم به‌صورت یک فایل
نام‌های مستعار kpathsea. این گزینه آزمایشی است و
ممکن است در آینده حذف شود.
.UNINDENT
.SH "فایل‌ها (FILES)"
.sp
پایگاه داده نام قلم معمولاً در دایرکتوری
\fBtexmf\-var/luatex\-cache/generic/names/\fP (برابر با \fB$TEXMFCACHE\fP تنظیم‌شده در
\fBtexmf.cnf\fP) از توزیع \fITeX Live\fP شما به‌عنوان یک فایل فشرده‌شده با zlib
به نام \fBluaotfload\-names.lua.gz\fP قرار دارد\&.
کَش آزمایشی جستجو به‌صورت
\fBluaotfload\-lookup\-cache.lua\fP در همان دایرکتوری ایجاد خواهد شد.
با این حال، این جدول‌های Lua به‌طور مستقیم توسط Luaotfload استفاده نمی‌شوند.
در عوض، آن‌ها به بایت‌کد Lua کامپایل می‌شوند که در فایل‌های مربوطه
با پسوند \fB\&.luc\fP در همان دایرکتوری نوشته می‌شوند.
هنگام ویرایش دستی فایل‌ها در نظر داشته باشید تنها در صورتی که فایل‌های بایت‌کد
موجود نباشند، Luaotfload از نسخه متنی ساده استفاده خواهد کرد.
حذف هر دو نوع فایل بی‌خطر است، هرچند که در اجرای بعدی
\fILuaTeX\fP مجدداً تولید خواهند شد..SH "همچنین ببینید (SEE ALSO)"
.sp
\fBluaotfload.conf\fP(5), \fBluatex\fP(1), \fBlua\fP(1)
.INDENT 0.0
.IP \(bu 2
دستور \fBtexdoc luaotfload\fP برای نمایش راهنمای بستهٔ \fILuaotfload\fP
.IP \(bu 2
توسعهٔ Luaotfload \fI\%https://github.com/latex3/luaotfload\fP
.IP \(bu 2
فهرست پستی LuaLaTeX \fI\%http://tug.org/pipermail/lualatex\-dev\fP
.IP \(bu 2
LuaTeX \fI\%http://luatex.org\fP
.IP \(bu 2
ConTeXt \fI\%http://wiki.contextgarden.net\fP
.IP \(bu 2
Luaotfload در CTAN \fI\%http://ctan.org/pkg/luaotfload\fP
.UNINDENT
.SH "گزارش باگ‌ها (BUGS)"
.sp
احتمالاً خروارها.
.SH "نویسندگان (AUTHORS)"
.sp
\fILuaotfload\fP توسط تیم توسعهٔ LuaLaTeX
(\fI\%https://github.com/lualatex\fP) توسعه یافته است. در حال حاضر توسط تیم
پروژهٔ LaTeX در \fI\%https://github.com/latex3/luaotfload\fP نگهداری می‌شود.
کد fontloader توسط Hans Hagen از Pragma ADE، Hasselt
NL (\fI\%http://pragma\-ade.com\fP) ارائه شده است.
.sp
این صفحهٔ راهنما توسط Philipp Gesang <\fI\%phg@phi\-gamma.net\fP> نوشته شده است.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
GPL v2.0
.\" Generated by docutils manpage writer.
.