نام (NAME)

luaotfload-tool - تولید و جست‌وجوی پایگاه‌داده نام‌های قلم در Luaotfload

خلاصه دستور (SYNOPSIS)

luaotfload-tool [ -bcDfFiIlLnpqRSuvVhw ]

luaotfload-tool --update [ --force ] [ --quiet ] [ --verbose ]: [ --prefer-texmf ] [ --dry-run ] [ --formats=[+|-]EXTENSIONS ] [ --no-compress ] [ --no-strip ] [ --local ] [ --max-fonts=N ]
luaotfload-tool --find=FONTNAME [ --fuzzy ] [ --info ] [ --inspect ]: [ --no-reload ]

luaotfload-tool --flush-lookups

luaotfload-tool --cache=DIRECTIVE

luaotfload-tool --list=CRITERION[:VALUE] [ --fields=F1,F2,...,Fn ]

luaotfload-tool --bisect=DIRECTIVE

luaotfload-tool --help

luaotfload-tool --version

luaotfload-tool --show-blacklist

luaotfload-tool --diagnose=CHECK

luaotfload-tool --conf=FILE --dumpconf

توضیحات (DESCRIPTION)

ابزار luaotfload-tool به پایگاه‌داده نام‌های قلم که برای بسته Luaotfload مورد نیاز است دسترسی پیدا می‌کند. دو حالت کلی وجود دارد: update و query.

update: به‌روزرسانی پایگاه‌داده یا بازسازی کامل آن؛
query: تطبیق نام قلم یا نمایش نزدیک‌ترین موارد منطبق.

گزینه‌ها (OPTIONS)

حالت به‌روزرسانی (update mode)

--update, -u: به‌روزرسانی پایگاه‌داده؛ نمایه‌سازی قلم‌های جدید.
--force, -f: اجبار به بازسازی پایگاه‌داده؛ نمایه‌سازی مجدد تمام قلم‌ها.
--local, -L: شامل کردن فایل‌های قلم موجود در $PWD. این گزینه باعث بازسازی بخش‌های بزرگی از پایگاه‌داده می‌شود؛ بنابراین کاملاً ناکارآمد است. علاوه‌بر این، در صورت یافت شدن فایل‌های قلم محلی، از ذخیره شدن پایگاه‌داده روی دیسک جلوگیری می‌شود، بنابراین قلم‌های محلی باید با هر بار فراخوانی luaotfload-tool مجدداً پردازش شوند.
--no-reload, -n: جلوگیری از به‌روزرسانی‌های خودکار پایگاه‌داده (برای مثال زمانی که یک نام ناشناخته به --find داده می‌شود).
--no-compress, -c: فیلتر نکردن نسخه متنی ساده نمایه قلم از طریق gzip. در صورتی که ویرایشگر شما بدون پشتیبانی از zlib ساخته شده باشد، برای اشکال‌زدایی مفید است.
--prefer-texmf, -p: سازماندهی پایگاه‌داده نام فایل‌ها به گونه‌ای که در صورت نصب بودن قلم‌ها در هر دو مسیر، قلم‌های موجود در درخت TEXMF را به قلم‌های سیستمی ترجیح دهد.
--formats=EXTENSIONS: پسوند فایل‌های قلم برای نمایه‌سازی. در اینجا EXTENSIONS فهرستی جداشده با کاما از پسوندهای فایل پشتیبانی‌شده (otf, ttf, ttc) است. اگر علامت + در ابتدای فهرست بیاید، موارد داده‌شده به فهرست فعال فعلی اضافه می‌شوند؛ - آن‌ها را کسر می‌کند. پیش‌فرض: otf,ttf,ttc. مثال‌ها:

1.: --formats=-ttc,ttf از قلم‌های TrueType و بسته‌های مجموعه‌قلم صرف‌نظر می‌کند؛
2.: --formats=otf فقط فایل‌های OpenType را پویش می‌کند؛
3.: --formats=+afm فایل‌های باینری Postscript را که همراه با یک فایل AFM باشند شامل می‌شود.

--find=NAME: نام یک قلم را تطبیق می‌دهد؛ این گزینه <name> را در پایگاه‌داده جست‌وجو کرده و نام فایلی را که به آن نگاشت شده است چاپ می‌کند. --find همچنین ساختار درخواست (request syntax) را نیز درک می‌کند؛ برای نمونه --find=file:foo.otf بررسی می‌کند که آیا foo.otf ایندکس شده است یا خیر.
--fuzzy, -F: در صورتی که جست‌وجو ناموفق باشد، مطابقت‌های تقریبی را برای نام فایل نمایش می‌دهد (نیازمند --find است).
--info, -i: اطلاعات پایه مربوط به فایل قلم تطبیق‌یافته را نمایش می‌دهد (نیازمند --find است).
--inspect, -I: اطلاعات تفصیلی را با بارگذاری قلم و تحلیل جدول قلم نمایش می‌دهد؛ بسیار کُند است! برای درک معنای فیلدهای بازگردانده‌شده، مستندات LuaTeX را ببینید. (نیازمند --find است).
--list=CRITERION: مدخل‌ها را نمایش می‌دهد، به طوری که CRITERION یکی از موارد زیر است:

1.: نویسهٔ *، که تمام مدخل‌ها را انتخاب می‌کند؛
2.: فیلدی از یک مدخل پایگاه‌داده، برای نمونه version یا format*، که خروجی بر اساس آن مرتب‌سازی خواهد شد. اطلاعات در یک پایگاه‌داده پالایش‌نشده (گزینهٔ --no-strip در بالا را ببینید) تو در تو است: زیرفیلدهای یک رکورد را می‌توان با استفاده از جداکنندهٔ -> آدرس‌دهی کرد؛ برای نمونه: file->location، style->units_per_em، یا names->sanitized->english->prefmodifiers. توجه: ساختار پوسته (shell) ایجاب می‌کند که آرگومان‌های حاوی -> به‌درستی داخل گیومه قرار گیرند!
3.: عبارتی به شکل field:value برای محدود کردن خروجی به مدخل‌هایی که در آن‌ها field با value مطابقت دارد. value می‌تواند حاوی * باشد تا با تعداد دلخواهی از نویسه‌ها مطابقت یابد.

برای نمونه، جهت چاپ نام فایل‌ها و نسخه‌های متناظرشان، مرتب‌شده بر اساس قالب قلم:

./luaotfload-tool.lua --list="format" --fields="file->base,version"

این دستور چنین خروجی می‌دهد:

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
...

--fields=FIELDS: فهرست جداشده با کاما از فیلدهایی که باید چاپ شوند. اطلاعات در یک پایگاه‌داده پالایش‌نشده (گزینهٔ --no-strip در بالا را ببینید) تو در تو است: زیرفیلدهای یک رکورد را می‌توان با استفاده از جداکنندهٔ -> آدرس‌دهی کرد؛ برای نمونه: file->location، style->units_per_em، یا names->sanitized->english->subfamily. پیش‌فرض plainname,version* است. (تنها همراه با --list معنادار است.)

--flush-lookups: پاک‌سازی حافظهٔ موقت جست‌وجوی نام فونت (آزمایشی).
--cache=DIRECTIVE: مدیریت حافظهٔ موقت، که در آن DIRECTIVE یکی از موارد زیر است:

1.: purge -> حذف فایل‌های Lua از حافظهٔ موقت؛
2.: erase -> حذف فایل‌های Lua و Luc از حافظهٔ موقت؛
3.: show -> چاپ آمار.

روش‌های اشکال‌زدایی (debugging methods)

--show-blacklist, -b: نمایش فایل‌های موجود در سیاههٔ سیاه (نه دایرکتوری‌ها).
--dry-run, -D: هنگام به‌روزرسانی پایگاه‌داده فونت‌ها را بارگیری نکن؛ فقط دایرکتوری‌ها را پیمایش کن. (برای اشکال‌زدایی مسائل مربوط به سیستم فایل.)
--no-strip: پس از ساخت پایگاه‌داده، اطلاعات زائد را حذف نکن. هشدار: این کار نمایه را به حدود دو تا سه برابر اندازهٔ عادی متورم می‌کند.
--max-fonts=N: پردازش حداکثر N فایل فونت، شامل فونت‌هایی که پیش‌تر در شمارش نمایه شده‌اند.
--bisect=DIRECTIVE: دوبخشی‌سازی (Bisection) پایگاه‌دادهٔ فونت. این حالت به عنوان کمکی برای اشکال‌زدایی موتور Luatex در نظر گرفته شده است، به ویژه هنگام ردیابی نشت‌های حافظه یا فونت‌های دارای اشکال.
DIRECTIVE می‌تواند یکی از موارد زیر باشد:

1.: run -> واداشتن luaotfload-tool به رعایت پیشرفت دوبخشی‌سازی هنگام اجرا. در ترکیب با --update و احتمالاً --force، این گزینه تنها فایل‌ها را از ابتدا تا نقطهٔ محوری (pivot) پردازش کرده و بقیه را نادیده می‌گیرد.
2.: start -> آغاز دوبخشی‌سازی: ایجاد فایل وضعیت دوبخشی‌سازی و مقداردهی اولیهٔ نمایه‌های پایین (low)، بالا (high) و محوری (pivot).
3.: stop -> پایان دادن به نشست دوبخشی‌سازی کنونی با حذف فایل وضعیت.
4.: good | bad -> علامت‌گذاری آخرین بخش پردازش‌شده به ترتیب به عنوان “good” یا “bad”. گام بعدیِ دوبخشی‌سازی با بخش خراب (bad) ادامه خواهد یافت.
5.: status -> چاپ اطلاعات وضعیت دربارهٔ نشست دوبخشی‌سازی کنونی. نکته: برای خروجی بیشتر، با تنظیمات پرگویی (verbosity) بالاتر استفاده کنید.

یک نشست دوبخشی‌سازی با صدور دستورالعمل start آغاز می‌شود. این کار نقطهٔ محوری (pivot) را در وسط فهرست فایل‌های فونت موجود قرار می‌دهد. اکنون luaotfload-tool را با پرچم فعال --update و همچنین --bisect=run اجرا کنید: تنها فونت‌های تا نقطهٔ محوری در نظر گرفته خواهند شد. اگر آن وظیفه اشکالی را که ردیابی می‌کنید نشان داد، با استفاده از --bisect=bad به Luaotfload اطلاع دهید. گام بعدی --bisect=run دوبخشی‌سازی را با بخشی از فایل‌های پایین‌تر از نقطهٔ محوری ادامه خواهد داد. به همین ترتیب، با فرض اینکه بخش آزموده‌شده از فهرست باگ را تحریک نکرده باشد، --bisect=good را صادر کنید تا کار با فونت‌های بالاتر از نقطهٔ محوری ادامه یابد.

پس از اینکه فونت معیوب ردیابی شد، good یا bad دیگر هیچ اثری نخواهند داشت. run در نهایت همیشه همان یک فایل فونت باقی‌مانده را پردازش خواهد کرد. از --bisect=stop برای پاک‌سازی وضعیت دوبخشی‌سازی استفاده کنید.

--verbose=N, -v: تنظیم سطح پرگویی به n یا به تعداد تکرارهای -v.
--quiet: بدون خروجی پرگو (تنظیم سطح گزارش وقایع روی صفر).
--log=CHANNEL: تغییر مسیر خروجی گزارش وقایع (برای عیب‌یابی پایگاه داده)، که در آن CHANNEL می‌تواند یکی از موارد زیر باشد:

1.: stdout -> تمام خروجی در ترمینال تخلیه خواهد شد (پیش‌فرض)؛ یا
2.: file -> نوشتن در فایلی در دایرکتوری موقت (نام فایل به‌طور خودکار انتخاب خواهد شد).

--version, -V: نمایش شماره نسخه مؤلفه‌ها به‌همراه برخی اطلاعات پایه‌ای و خروج.
--help, -h: نمایش پیام راهنما و خروج.
--diagnose=CHECK: اجرای فرایند خطایابی CHECK. فرایندهای موجود عبارتند از:

1.: files -> بررسی فایل‌های Luaotfload برای تغییرات؛
2.: permissions -> بررسی دسترسی‌های دایرکتوری‌ها و فایل‌های کَش؛
3.

environment -> چاپ متغیرهای: محیطی و kpse مرتبط؛

4.: repository -> بررسی مخزن git برای انتشارهای جدید،
5.: index -> بررسی پایگاه داده، نمایش اطلاعات درباره آن.

می‌توان فرایندها را با متصل کردن توسط کاما زنجیر کرد، مانند --diagnose=files,permissions. برای اجرای تمام بررسی‌ها thorough را مشخص کنید.

--conf=FILE: خواندن پیکربندی از FILE. برای مستندات مربوط به قالب و گزینه‌های موجود، luaotfload.conf(%) را ببینید.
--dumpconf: چاپ پیکربندی در حال حاضر فعال؛ خروجی می‌تواند در یک فایل ذخیره شده و برای راه‌اندازی اولیه فایل‌های پیکربندی سفارشی استفاده شود.
--aliases: تخلیه پایگاه داده نام قلم به‌صورت یک فایل نام‌های مستعار kpathsea. این گزینه آزمایشی است و ممکن است در آینده حذف شود.

فایل‌ها (FILES)

پایگاه داده نام قلم معمولاً در دایرکتوری texmf-var/luatex-cache/generic/names/ (برابر با $TEXMFCACHE تنظیم‌شده در texmf.cnf) از توزیع TeX Live شما به‌عنوان یک فایل فشرده‌شده با zlib به نام luaotfload-names.lua.gz قرار دارد. کَش آزمایشی جستجو به‌صورت luaotfload-lookup-cache.lua در همان دایرکتوری ایجاد خواهد شد. با این حال، این جدول‌های Lua به‌طور مستقیم توسط Luaotfload استفاده نمی‌شوند. در عوض، آن‌ها به بایت‌کد Lua کامپایل می‌شوند که در فایل‌های مربوطه با پسوند .luc در همان دایرکتوری نوشته می‌شوند. هنگام ویرایش دستی فایل‌ها در نظر داشته باشید تنها در صورتی که فایل‌های بایت‌کد موجود نباشند، Luaotfload از نسخه متنی ساده استفاده خواهد کرد. حذف هر دو نوع فایل بی‌خطر است، هرچند که در اجرای بعدی LuaTeX مجدداً تولید خواهند شد..SH "همچنین ببینید (SEE ALSO)"

luaotfload.conf(5), luatex(1), lua(1)

دستور texdoc luaotfload برای نمایش راهنمای بستهٔ Luaotfload
توسعهٔ Luaotfload https://github.com/latex3/luaotfload
فهرست پستی LuaLaTeX http://tug.org/pipermail/lualatex-dev
LuaTeX http://luatex.org
ConTeXt http://wiki.contextgarden.net
Luaotfload در CTAN http://ctan.org/pkg/luaotfload

گزارش باگ‌ها (BUGS)

احتمالاً خروارها.

نویسندگان (AUTHORS)

Luaotfload توسط تیم توسعهٔ LuaLaTeX (https://github.com/lualatex) توسعه یافته است. در حال حاضر توسط تیم پروژهٔ LaTeX در https://github.com/latex3/luaotfload نگهداری می‌شود. کد fontloader توسط Hans Hagen از Pragma ADE، Hasselt NL (http://pragma-ade.com) ارائه شده است.

این صفحهٔ راهنما توسط Philipp Gesang <phg@phi-gamma.net> نوشته شده است.

کپی‌رایت و تکثیر (COPYRIGHT)

GPL v2.0