.\" 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.CONF" 5 "2024-12-03" "3.29" "پردازش متن"
.SH "نام (NAME)"
luaotfload.conf \- فایل پیکربندی Luaotfload
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.IP \(bu 2
\fB\&./luaotfload{.conf,rc}\fP
.IP \(bu 2
\fBXDG_CONFIG_HOME/luaotfload/luaotfload{.conf,rc}\fP
.IP \(bu 2
\fB~/.luaotfloadrc\fP
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
فایل \fBluaotfload.conf\fP شامل گزینه‌های پیکربندی برای
\fILuaotfload\fP است که یک مؤلفه بارگذاری و مدیریت فونت برای LuaTeX به شمار می‌رود.
.SH "مثال (EXAMPLE)"
.sp
یک فایل پیکربندی کوچک Luaotfload با چند سفارشی‌سازی اندک می‌تواند به شکل زیر باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
[db]
    formats = afm,ttf
    compress = false

[misc]
    termwidth = 60

[run]
    log\-level = 6
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
این تنظیمات باعث می‌شود Luaotfload تمام فایل‌های فونت را نادیده بگیرد، به جز فونت‌های باینری پست‌اسکریپت (PostScript) دارای فایل AFM منطبق، و فونت‌های Truetype. همچنین یک فایل نمایه غیرفشرده ایجاد خواهد شد که به مراتب بزرگتر از نمایه پیش‌فرض فشرده‌شده با gzip است. عرض ترمینال به ۶۰ نویسه محدود می‌شود که بر خروجی پرگویی هنگام نمایه‌سازی تأثیر می‌گذارد. در نهایت، میزان جزئیات پیام‌ها به شدت افزایش می‌یابد: هر فایل فونتی که پردازش می‌شود روی یک خط جداگانه در stdout چاپ خواهد شد، به همراه انبوهی از اطلاعات دیگر.
.sp
برای مشاهده تفاوت رفتار، قطعه‌کد بالا را در \fB\&./luaotfload.conf\fP ذخیره کرده و نمایه فونت را به‌روزرسانی کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
luaotfload\-tool \-\-update \-\-force
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
پیکربندی فعلی را می‌توان با استفاده از \fBluaotfload\-tool\fP روی دیسک ذخیره کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
luaotfload\-tool \-\-dumpconf > luaotfload.conf
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
نتیجه حاصل خود می‌تواند به عنوان یک فایل پیکربندی استفاده شود.
.SH "ساختار نحوی (SYNTAX)"
.sp
ساختار فایل پیکربندی از قالب رایج INI پیروی می‌کند. برای توضیحات دقیق‌تر لطفاً به بخش "CONFIGURATION FILE" در \fBgit\-config\fP(1) مراجعه کنید. خلاصه قواعد در زیر آمده است:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
خطوط خالی و خطوطی که با نقطه ویرگول (\fB;\fP) آغاز می‌شوند نادیده گرفته می‌شوند.
.IP \(bu 2
یک فایل پیکربندی به بخش‌هایی تقسیم می‌شود که با مشخص کردن عنوان بخش درون براکت در یک خط جداگانه اعلان می‌شوند:
.INDENT 2.0
.INDENT 3.5
.sp
.nf
.ft C
[some\-section]
\&... محتوای بخش ...
.ft P
.fi
.UNINDENT
.UNINDENT
.IP \(bu 2
بخش‌ها از یک یا چند انتساب متغیر به صورت \fBvariable\-name = value\fP تشکیل می‌شوند؛ به عنوان مثال:
.INDENT 2.0
.INDENT 3.5
.sp
.nf
.ft C
[foo]
    bar = baz
    quux = xyzzy
    ...
.ft P
.fi
.UNINDENT
.UNINDENT
.IP \(bu 2
نام بخش‌ها و متغیرها فقط می‌توانند شامل حروف بزرگ و کوچک انگلیسی و همچنین خط تیره (\fB\-\fP) باشند.
.UNINDENT
.UNINDENT
.UNINDENT
.SH "متغیرها (VARIABLES)"
.sp
متغیرها متعلق به یک بخش پیکربندی هستند و مقادیر آن‌ها باید از نوع مشخصی باشد. برخی از آن‌ها محدودیت‌های بیشتری دارند. برای مثال، «کالبک رنگ» باید رشته‌ای از یکی از مقادیر \fBpost_linebreak_filter\fP، \fBpre_linebreak_filter\fP، یا \fBpre_output_filter\fP باشد که در بخش \fIrun\fP از فایل پیکربندی تعریف شده‌اند.
.sp
در حال حاضر، پیکربندی به چهار بخش سازماندهی شده است:
.INDENT 0.0
.TP
.B db
گزینه‌های مربوط به نمایه فونت.
.TP
.B misc
گزینه‌های بدون دسته‌بندی مشخص.
.TP
.B paths
تنظیمات مسیرها و نام فایل‌ها.
.TP
.B run
گزینه‌های کنترل‌کننده رفتار زمان اجرای Luaotfload.
.UNINDENT
.sp
فهرست متغیرهای معتبر، بخش‌هایی که در آن‌ها قرار دارند و نوع داده آن‌ها در زیر آورده شده است. نوع‌ها بیانگر انواع داده لواند که مقادیر باید قابل تبدیل به آن‌ها باشند؛ آن‌ها به صورت زیر خلاصه شده‌اند: \fBs\fP برای نوع \fIstring\fP (رشته)، \fBn\fP برای \fInumber\fP (عدد)، \fBb\fP برای \fIboolean\fP (بولی)\&. مقدار \fBnil\fP به معنای تنظیم‌نشده بودن متغیر است.
.SS "بخش db"
.TS
center;
|l|l|l|.
_
T{
متغیر
T}	T{
نوع
T}	T{
پیش‌فرض
T}
_
T{
compress
T}	T{
b
T}	T{
\fBtrue\fP
T}
_
T{
designsize\-dimen
T}	T{
b
T}	T{
\fBbp\fP
T}
_
T{
formats
T}	T{
s
T}	T{
\fB"otf,ttf,ttc"\fP
T}
_
T{
location\-precedence
T}	T{
s
T}	T{
\fB"system,texmf,local\fP
T}
_
T{
max\-fonts
T}	T{
n
T}	T{
\fB2^51\fP
T}
_
T{
scan\-local
T}	T{
b
T}	T{
\fBfalse\fP
T}
_
T{
skip\-read
T}	T{
b
T}	T{
\fBfalse\fP
T}
_
T{
strip
T}	T{
b
T}	T{
\fBtrue\fP
T}
_
T{
update\-live
T}	T{
b
T}	T{
\fBtrue\fP
T}
_
.TE
.sp
فلگ \fBcompress\fP مشخص می‌کند که آیا نمایه فونت (معمولاً \fBluaotfload\-names.lua[.gz]\fP) در قالب‌های فشرده ذخیره شود یا خیر. در صورت عدم تنظیم، معادل پاس دادن \fB\-\-no\-compress\fP به \fBluaotfload\-tool\fP است\&. از آنجا که این فایل صرفاً برای سهولت ایجاد می‌شود و هیچ تأثیری بر رفتار زمان اجرای Luaotfload ندارد، این فلگ باید روشن بماند. بیشتر ویرایشگرها در هر حال از zlib پشتیبانی می‌کنند.
.sp
تنظیم \fBdesignsize\-dimen\fP هنگام جستجوی فونت‌های خانواده‌های دارای ابعاد طراحی اعمال می‌شود. در OpenType، این موارد بر حسب «دسی‌پوینت» (decipoints) مشخص می‌شوند که هر دسی‌پوینت معادل ده «پوینت بزرگ» در DTP است. هنگام نمایه‌سازی فونت‌ها، این مقادیر به \fBsp\fP تبدیل می‌شوند. برای اینکه این مقادیر طوری در نظر گرفته شوند که گویی در پوینت‌های TeX یا پوینت‌های Didot مشخص شده‌اند، مقدار \fBdesignsize\-dimen\fP را روی \fBpt\fP یا \fBdd\fP تنظیم کنید.
.sp
فهرست \fBformats\fP باید دنباله‌ای از رشته‌های جداشده با کاما شامل یک یا چند مورد از این عناصر باشد:
.INDENT 0.0
.IP \(bu 2
\fBotf\fP (قالب OpenType)،
.IP \(bu 2
\fBttf\fP و \fBttc\fP (قالب TrueType)،
.IP \(bu 2
\fBafm\fP (معیارهای فونت ادوبی یا Adobe Font Metrics)،
.UNINDENT
.sp
این متغیر تقریباً متناظر با گزینه \fB\-\-formats\fP در \fBluaotfload\-tool\fP است\&. مقادیر نامعتبر یا تکراری نادیده گرفته می‌شوند؛ اگر فهرست شامل هیچ شناسه مفیدی نباشد، فهرست پیش‌فرض \fB"otf,ttf,ttc"\fP استفاده خواهد شد.
.sp
متغیر \fBlocation\-precedence\fP تعیین می‌کند که luaotfload در چه مکان‌هایی و با چه ترتیبی به دنبال فونت‌ها بگردد. فونت‌های موجود در مکان‌های ابتدایی‌تر ترجیح داده می‌شوند. سه مکان پشتیبانی‌شده عبارتند از \fBsystem\fP برای دایرکتوری‌های فونت ویژه سیستم، \fBtexmf\fP برای فونت‌هایی که بخشی از توزیع TeX{} هستند و \fBlocal\fP برای فونت‌های محلی.
.sp
متغیر \fBmax\-fonts\fP مشخص می‌کند که اسکنر فونت پس از پردازش چه تعداد فایل فونت، جستجو را متوقف کند. این متغیر برای رفع اشکال نمایه فونت مفید است و همان اثر گزینه \fB\-\-max\-fonts\fP در \fBluaotfload\-tools\fP را دارد.
.sp
فلگ \fBscan\-local\fP، در صورت تنظیم، دایرکتوری کاری فعلی را به عنوان مکانی برای جستجوی فونت لحاظ می‌کند. توجه: این کار به طور بالقوه پردازش سند را کند می‌کند زیرا نمایه فونت حاوی فونت‌های محلی روی دیسک ذخیره نمی‌شود، بنابراین هر بار که سند ساخته می‌شود، این فونت‌ها باید مجدداً نمایه‌سازی شوند. تنظیم \fBscan_local\fP روی \fBfalse\fP معادل حذف \fBlocal\fP از \fBlocation\-precedence\fP است.
.sp
فلگ \fBskip\-read\fP تنها برای اشکال‌زدایی کاربرد دارد: باعث می‌شود Luaotfload از خواندن فونت‌ها صرف‌نظر کند. اطلاعات فونت برای بازسازی نمایه از نمایه موجود فعلی گرفته می‌شود.
.sp
غیرفعال کردن فلگ \fBstrip\fP مانع از آن می‌شود که Luaotfload داده‌هایی را از نمایه حذف کند که فقط هنگام پردازش فایل‌های فونت کاربرد دارند. توجه: این کار می‌تواند اندازه فایل‌های نمایه را به میزان قابل توجهی افزایش دهد و هیچ تأثیری بر رفتار زمان اجرا ندارد.
.sp
اگر \fBupdate\-live\fP تنظیم شده باشد، در صورتی که Luaotfload نتواند فونت درخواستی را پیدا کند پایگاه داده را مجدداً بارگذاری خواهد کرد. کسانی که ترجیح می‌دهند به صورت دستی و با استفاده از \fBluaotfload\-tool\fP به‌روزرسانی کنند باید این فلگ را غیرفعال کنند. این گزینه بر بازسازی ناشی از عدم تطابق نسخه تأثیری ندارد.
.SS "بخش default\-features"
.sp
به طور پیش‌فرض Luaotfload حالت \fBnode\fP را فعال کرده و ویژگی‌های پیش‌فرض فونت را که در استاندارد OpenType تجویز شده‌اند انتخاب می‌کند. این رفتار ممکن است در بخش \fBdefault\-features\fP بازنویسی شود. پیش‌فرض‌های سراسری که برای تمامی اسکریپت‌ها اعمال می‌شوند را می‌توان از طریق گزینه \fBglobal\fP تنظیم کرد و سایر موارد را می‌توان بر اساس اسکریپتی که قرار است روی آن اعمال شوند تعیین نمود. برای مثال، تنظیمی مانند
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
[default\-features]
    global = mode=base,color=0000FF
    dflt   = smcp,onum
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
حالت \fIbase\fP را اجبار می‌کند، تمام فونت‌ها را به رنگ آبی درمی‌آورد و حروف کوچک کوچک (small capitals) و اعداد متنی را به صورت سراسری فعال می‌سازد. ویژگی‌ها به صورت فهرستی از متغیرها یا جفت‌های متغیر-مقدار جداشده با کاما مشخص می‌شوند. متغیرهای فاقد مقدار صریح، برابر با \fBtrue\fP تنظیم می‌شوند.
.SS "بخش misc"
.TS
center;
|l|l|l|.
_
T{
متغیر
T}	T{
نوع
T}	T{
پیش‌فرض
T}
_
T{
statistics
T}	T{
b
T}	T{
\fBfalse\fP
T}
_
T{
termwidth
T}	T{
n
T}	T{
\fBnil\fP
T}
_
T{
version
T}	T{
s
T}	T{
<نسخه Luaotfload>
T}
_
T{
keepnames
T}	T{
b
T}	T{
\fBtrue\fP
T}
_
.TE
.sp
با فعال بودن \fBstatistics\fP، آمارهای اضافی هنگام ایجاد نمایه جمع‌آوری شده و به فایل نمایه اضافه می‌شوند. سپس می‌توان آن را در بخش Lua پرس‌وجو کرد یا با خواندن خود فایل بررسی نمود.
.sp
مقدار \fBtermwidth\fP، در صورت تنظیم، مقداری را که از پرس‌وجوی ویژگی‌های ترمینال محل اجرای Luatex به دست می‌آید بازنویسی می‌کند. این در صورتی مفید است که موتور با غیرفعال بودن \fBshell_escape\fP اجرا شود و ابعاد واقعی ترمینال قابل بازیابی نباشد.
.sp
مقدار \fBversion\fP از رشته نسخه هاردکدشده در کد منبع Luaotfload گرفته می‌شود. با مسئولیت خودتان آن را تغییر دهید.
.sp
گزینه \fBkeepnames\fP تعیین می‌کند که آیا لودر فونت ConTeXt باید نام‌هایی را که بی‌استفاده می‌داند نگه دارد یا آن‌ها را دور بریزد. این گزینه تنها پس از بازسازی حافظه موقت (کش) فونت‌ها اعمال می‌شود.
.SS "بخش paths"
.TS
center;
|l|l|l|.
_
T{
متغیر
T}	T{
نوع
T}	T{
پیش‌فرض
T}
_
T{
cache\-dir
T}	T{
s
T}	T{
\fB"fonts"\fP
T}
_
T{
names\-dir
T}	T{
s
T}	T{
\fB"names"\fP
T}
_
T{
index\-file
T}	T{
s
T}	T{
\fB"luaotfload\-names.lua"\fP
T}
_
T{
lookups\-file
T}	T{
s
T}	T{
\fB"luaotfload\-lookup\-cache.lua"\fP
T}
_
.TE
.sp
مسیرهای \fBcache\-dir\fP و \fBnames\-dir\fP زیرپوشه‌ای درون درخت Luaotfload در پوشه \fBluatex\-cache\fP را تعیین می‌کنند که به ترتیب کش فونت و نمایه فونت در آن ذخیره می‌شوند.
.sp
درون پوشه نمایه، نام فایل‌های نمایه و کش جستجوی فونت از مقادیر متناظر \fBindex\-file\fP و \fBlookups\-file\fP مشتق خواهند شد. این پایه نام فایل برای نسخه کامپایل‌شده به بایت‌کد و همچنین \-\- برای نمایه \-\- نسخه فشرده‌شده با gzip است.
.SS "بخش run"
.TS
center;
|l|l|l|.
_
T{
متغیر
T}	T{
نوع
T}	T{
پیش‌فرض
T}
_
T{
anon\-sequence
T}	T{
s
T}	T{
\fB"tex,path,name"\fP
T}
_
T{
color\-callback
T}	T{
s
T}	T{
\fB"post_linebreak_filter"\fP
T}
_
T{
definer
T}	T{
s
T}	T{
\fB"patch"\fP
T}
_
T{
log\-level
T}	T{
n
T}	T{
\fB0\fP
T}
_
T{
resolver
T}	T{
s
T}	T{
\fB"cached"\fP
T}
_
T{
fontloader
T}	T{
s
T}	T{
\fB"default"\fP
T}
_
T{
default_dvi_driver
T}	T{
s
T}	T{
\fB"dvisvgm"\fP
T}
_
.TE
.sp
جستجوهای بدون شرط و مبهم فونت با سازوکار منعطف «ناشناس» (anonymous) مدیریت می‌شوند. این سازوکار شامل زنجیره‌ای از جستجوها است که به صورت متوالی اعمال می‌شوند تا زمانی که اولین مورد پاسخی در بر داشته باشد. به طور پیش‌فرض، جستجو ابتدا با استفاده از کتابخانه Kpathsea به دنبال فونت‌های TFM می‌گردد. اگر ناموفق بود، تلاشی صورت می‌گیرد تا درخواست به عنوان یک مسیر مطلق (مانند ساختار نحوی \fB[/path/to/font/foo.ttf]\fP) یا نام فایل (\fBfile:foo.ttf\fP) تفسیر شود. در نهایت، درخواست به عنوان نام فونت تفسیر شده و از نمایه بازیابی می‌شود (\fBname:Foo Regular\fP). این رفتار را می‌توان با مشخص کردن یک فهرست به عنوان مقدار \fBanon\-sequence\fP پیکربندی کرد. موارد مجاز عبارتند از \fBtex\fP، \fBpath\fP، \fBname\fP \-\- که به ترتیب نشان‌دهنده جستجوهای شرح‌داده‌شده در بالا هستند \-\- و \fBfile\fP برای جستجوی نام فایل بدون مسیر مطلق. همچنین جستجوهای \fBmy\fP مقادیر معتبری هستند اما تنها باید از درون اسناد TeX استفاده شوند، زیرا روشی برای سفارشی‌سازی جستجوهای \fBmy\fP در خط فرمان وجود ندارد.
.sp
گزینه \fBcolor\-callback\fP مرحله‌ای را تعیین می‌کند که در آن فونت‌های تعریف‌شده با ویژگی \fBcolor=xxyyzz\fP رنگ‌آمیزی می‌شوند. به طور پیش‌فرض این امر در \fBpost_linebreak_filter\fP اتفاق می‌افتد اما متناوباً می‌توان \fBpre_linebreak_filter\fP یا \fBpre_output_filter\fP را انتخاب کرد که سریع‌تر است اما ممکن است خروجی ناپایداری تولید کند. فیلتر \fBpre_output_filter\fP در سری 1.x از Luaotfload پیش‌فرض بود، در حالی که نسخه‌های بعدی تا نسخه 2.5 به \fBpre_linebreak_filter\fP متصل شدند که طبیعتاً بر هیچ نویسه‌ای که حین خط‌شکنی درج می‌شد تأثیر نمی‌گذاشت. هر دو به عنوان گزینه‌هایی برای بازگرداندن رفتار قبلی در صورت لزوم حفظ شده‌اند.
.sp
گزینه \fBdefiner\fP اجازه تعویض کالبک \fBdefine_font\fP را می‌دهد. جدا از مقدار پیش‌فرض \fBpatch\fP، می‌توان مقدار \fBgeneric\fP را که به همراه لودر پیش‌فرض ارائه می‌شود انتخاب کرد. توجه داشته باشید که این ممکن است ابزارهایی مانند Fontspec را که به کالبک \fBpatch_font\fP ارائه‌شده توسط Luaotfload برای اعمال اصلاحات مهم روی داده‌های فونت وابسته‌اند، دچار مشکل کند.
.sp
بک‌اند بارگذاری فونت می‌تواند با تنظیم مقدار \fBfontloader\fP انتخاب شود. مهم‌ترین گزینه‌ها عبارتند از \fBdefault\fP که فونت‌لودر اختصاصی Luaotfload را بارگذاری می‌کند، و \fBreference\fP که بسته بالادستی ارائه‌شده همراه با Luaotfload است. غیر از این موارد، می‌توان نام فایلی را که از طریق kpathsea قابل دسترس است تعیین نمود.
.sp
همچنین می‌توان فایل‌های منفرد تشکیل‌دهنده فونت‌لودر را مستقیماً بارگذاری کرد. هرچند کارایی کمتری دارد، اما به شدت به اشکال‌زدایی کمک می‌کند زیرا پیام‌های خطا به شماره خطوط واقعی فایل‌های سورس ارجاع می‌دهند و کامنت‌های توضیحی حذف نشده‌اند. در حال حاضر سه راهبرد مجزا برای بارگذاری در دسترس است: گزینه \fBunpackaged\fP دسته‌ای را که بخشی از Luaotfload است بارگذاری می‌کند. این‌ها حاوی همان کد منبعی هستند که فونت‌لودر مرجع از آن کامپایل شده است. گزینه دیگر، \fBcontext\fP تلاش خواهد کرد تا همان فایل‌ها را با نام‌هایشان در قالب Context از مسیر جستجو بارگذاری کند. در نتیجه این گزینه امکان استفاده از نسخه Context همراه با توزیع TeX را فراهم می‌کند. توزیع‌ها تمایل دارند نسخه پایدار این فایل‌ها را ترجیح دهند، بنابراین از برخی اشکالات موجود در نسخه‌های توسعه‌ای Luaotfload می‌توان از این طریق اجتناب کرد. گزینه سوم استفاده از \fBcontext\fP با دونقطه برای تعیین پیشوند دایرکتوری محل قرارگیری \fITEXMF\fP است که فایل‌ها باید از آنجا بارگذاری شوند، به عنوان مثال \fBcontext:~/context/tex/texmf\-context\fP. این را می‌توان هنگام ارجاع به توزیع دیگری مانند Context minimals استفاده کرد که در مسیر متفاوتی نصب شده و توسط kpathsea نمایه‌سازی نشده است.
.sp
مقدار \fBlog\-level\fP پرگویی پیش‌فرض پیام‌های چاپ‌شده توسط Luaotfload را تعیین می‌کند. فقط پیام‌هایی با میزان پرگویی کمتر یا مساوی با مقدار ارائه‌شده در ترمینال چاپ خواهند شد. در سطح لاگ ۵، Luaotfload می‌تواند بسیار پرحرف باشد. همچنین چاپ پیام‌های بیش از حد به دلیل غیرفعال بودن بافرینگ خطی، سرعت مفسر را کاهش می‌دهد (به \fBsetbuf\fP(3) مراجعه کنید).
.sp
تنظیم \fBresolver\fP امکان انتخاب تابع تفکیک نام فونت را می‌دهد: با مقدار پیش‌فرض \fBcached\fP، ابزار Luaotfload نتیجه یک درخواست موفق نام فونت را در یک فایل کش ذخیره می‌کند تا جستجوهای بعدی تسریع شوند. گزینه دیگر، \fBnormal\fP حافظه موقت را دور می‌زند و هر درخواست را جداگانه تفکیک می‌کند. (با توجه به بازسازی ساختار نمایه نام فونت در Luaotfload نسخه 2.4، تفاوت کارایی میان جستجوهای کش‌شده و کش‌نشده باید ناچیز باشد.)
.sp
هنگامی که luaotfload در حالت \fBDVI\fP استفاده می‌شود، گزینه \fBdefault_dvi_driver\fP نحوه بازنمایی فونت‌های OpenType را در خروجی DVI تعیین می‌کند. در بیشتر موارد باید از مقدار پیش‌فرض \fBdvisvgm\fP استفاده شود؛ این گزینه از قالبی استفاده می‌کند که توسط چندین بک‌اند شامل \fBdvipdfmx\fP و \fBdvisvgm\fP پشتیبانی شده و از GIDها برای شناسایی نویسه‌ها بهره می‌برد.
تنظیم این مقدار روی \fBxdvipsk\fP در عوض از یک قالب داخلی ناپایدار استفاده می‌کند که بسته به نسخه luaotfload، موتور یا فونت تغییر خواهد کرد. هیچ‌کس نباید در این حالت به نگاشت میان کدهای نویسه DVI و گلیف‌های فونت اتکا کند مگر اینکه تمام نسخه‌های دخیل را کاملاً کنترل کرده و با پیاده‌سازی آن آشنایی عمیق داشته باشد.
.SH "فایل‌ها (FILES)"
.sp
نرم‌افزار Luaotfload تنها اولین فایل پیکربندی را که در یکی از مکان‌های جستجو می‌یابد پردازش می‌کند. نام فایل ممکن است \fBluaotfload.conf\fP یا \fBluaotfloadrc\fP باشد، به جز فایل نقطه‌دار (dotfile) در دایرکتوری خانگی کاربر که به صورت \fB~/.luaotfloadrc\fP انتظار می‌رود.
.sp
فایل‌های پیکربندی پس از طی یک سری مراحل مکان‌یابی می‌شوند. جستجو به محض برخورد با فایلی مناسب متوقف می‌شود. توالی مکان‌هایی که Luaotfload بررسی می‌کند به شرح زیر است:
.INDENT 0.0
.IP i. 5
دایرکتوری کاری فعلی فرآیند LuaTeX.
.IP ii. 5
زیرپوشه \fBluaotfload/\fP درون درخت پیکربندی XDG، برای مثال \fB/home/oenothea/config/luaotfload/\fP.
.IP iii. 5
فایل نقطه‌دار در پوشه خانگی.
.IP iv. 5
پوشه \fITEXMF\fP (با استفاده از kpathsea).
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBluaotfload\-tool\fP(1), \fBluatex\fP(1), \fBlua\fP(1)
.INDENT 0.0
.IP \(bu 2
دستور \fBtexdoc luaotfload\fP برای نمایش راهنمای PDF بسته \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
صفحه Luaotfload در CTAN در نشانی \fI\%http://ctan.org/pkg/luaotfload\fP
.UNINDENT
.SH "مراجع (REFERENCES)"
.INDENT 0.0
.IP \(bu 2
مشخصات پایه XDG در نشانی
\fI\%http://standards.freedesktop.org/basedir\-spec/basedir\-spec\-latest.html\fP.
.UNINDENT
.SH "نویسندگان (AUTHORS)"
.sp
ابزار \fILuaotfload\fP توسط تیم توسعه LuaLaTeX توسعه یافته است (\fI\%https://github.com/lualatex\fP). در حال حاضر توسط تیم پروژه LaTeX در \fI\%https://github.com/latex3/luaotfload\fP نگهداری می‌شود.
.sp
این صفحه راهنما توسط Philipp Gesang <\fI\%phg@phi\-gamma.net\fP> نوشته شده است.
.SH "حق نشر (COPYRIGHT)"
GPL v2.0
.\" Generated by docutils manpage writer.
.