.\" Manpage for luafindfont.
.\" Contact hvoss@tug.org to correct errors or typos.
.TH luafindfont 1 "4 july 2025" "0.16" "راهنمای luafindfont"
.SH "نام (NAME)"
luafindfont \- بازیابی اطلاعات همه قلم‌های نصب‌شده در سیستم و TeX
.SH "خلاصه دستور (SYNOPSIS)"
\fBluafindfont\fR [\fIگزینه‌ها\fR] <\fIfontname\fR>
.SH "توضیحات (DESCRIPTION)"
این دستور اطلاعات مربوط به قلم‌های otf|ttf|ttc نصب‌شده در سیستم و توزیع TeX را فهرست می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.IP "\-h, \-\-help"
بدیهی است... :-)
.IP "\-V, \-\-version"
بدیهی است... :-)
.IP "\-o, \-\-otfinfo (پیش‌فرض 0)"
استفاده از برنامه otfinfo برای قلم با شماره داده‌شده. می‌توان پس از این شماره یک آرگومان اختیاری برای otfinfo قرار داد؛ به عنوان نمونه \-o 2f همه ویژگی‌های قلم شماره ۲ را فهرست می‌کند. بدون نویسه اضافی، otfinfo با \-i فراخوانی می‌شود.
.IP "\-i, \-\-info (پیش‌فرض 0)"
فهرست کردن سبک‌های قلم داده‌شده (regular، bold، italic، bolditalic) برای قلم با شماره داده‌شده.
.IP "\-I, \-\-Info (پیش‌فرض 0)"
مشابه \-i، اما از برنامه mtxrun برای دریافت تمامی اطلاعات شامل ویژگی‌ها و زبان‌های مربوطه استفاده می‌کند. این فهرست می‌تواند بسیار طولانی باشد.
.IP "\-l, \-\-listonlynames"
خروجی یک فهرست مرتب‌شده و طولانی از نام‌های نمادین قلم‌های دردسترس است.
.IP "\-L, \-\-listonlyfiles"
مشابه حالت قبل، اما فقط با نام فایل‌ها (بدون مسیر!).
.IP "\-v, \-\-verbose سطح پرگویی"
ارائه اطلاعات بیشتر؛ در حال حاضر فقط \-v کار می‌کند.
.IP "\-x, \-\-xetex"
آزمایش اینکه آیا قلم توسط xetex از طریق kpsewhich یافت می‌شود یا خیر: 0 یعنی خیر؛ 1 یعنی بله.
.IP "\-m, \-\-max_string (پیش‌فرض 90)"
حداکثر طول رشته برای مسیر کامل قلم‌ها.
.IP "\-n, \-\-no\-symbolic\-names (به صورت جایگزین \-\-nosymbolicnames)"
فهرست قلم‌ها فقط شامل فایل قلم (fontfile) و مسیر قلم (fontpath) خواهد بود.
.IP "<\fIfontname\fR>"
می‌تواند یک زیررشته باشد (مانند times)، یا ترکیبی از دو زیررشته که مانند AND منطقی عمل می‌کنند (مانند "times & bold" که باید داخل نقل‌قول باشد). تمامی رشته‌ها به حروف بزرگ و کوچک حساس نیستند؛ حروف کوچک و بزرگ را می‌توان با هم ترکیب کرد.
.SH "مثال‌ها (EXAMPLES)"

$ luafindfont libertinussans

.Pp 
فهرست کردن تمامی قلم‌هایی که نام آن‌ها مانند libertinussans یا بخشی از آن است:

.nf
.ft CW
bash-3.2$ ./luafindfont.lua libertinussans
  No.                   Fontname  Symbolic Name                                                                        Path
   1.    LibertinusSans-Bold.otf libertinussans  /usr/local/texlive/2022/texmf-dist/fonts/opentype/public/libertinus-fonts/
   2.  LibertinusSans-Italic.otf libertinussans  /usr/local/texlive/2022/texmf-dist/fonts/opentype/public/libertinus-fonts/
   3. LibertinusSans-Regular.otf libertinussans  /usr/local/texlive/2022/texmf-dist/fonts/opentype/public/libertinus-fonts/

.ft R
.fi

.Pp
گزینه \-\-otfinfo:

$ luafindfont -o 3 libertinussans

.Pp
این دستور خروجی زیر را تولید می‌کند:

.nf
.ft CW
 1.    LibertinusSans-Bold.otf libertinussans                          /Users/voss/Library/Fonts/libertinus-fonts/LibertinusSans-Bold.otf
 2.    LibertinusSans-Bold.otf libertinussans  /usr/local/texlive/texmf-d...onts/opentype/public/libertinus-fonts/LibertinusSans-Bold.otf
 3.  LibertinusSans-Italic.otf libertinussans                        /Users/voss/Library/Fonts/libertinus-fonts/LibertinusSans-Italic.otf
 4.  LibertinusSans-Italic.otf libertinussans  /usr/local/texlive/texmf-d...ts/opentype/public/libertinus-fonts/LibertinusSans-Italic.otf
 5. LibertinusSans-Regular.otf libertinussans                       /Users/voss/Library/Fonts/libertinus-fonts/LibertinusSans-Regular.otf
 6. LibertinusSans-Regular.otf libertinussans  /usr/local/texlive/texmf-d...s/opentype/public/libertinus-fonts/LibertinusSans-Regular.otf

Running otfinfo on font no.3
Family:              Libertinus Sans
Subfamily:           Italic
Full name:           Libertinus Sans Italic
PostScript name:     LibertinusSans-Italic
Version:             Version 7.020;RELEASE
Unique ID:           1.000;QUE ;LibertinusSans-Italic
Designer:            Philipp H. Poll, Khaled Hosny
Manufacturer:        Caleb Maclennan
Vendor URL:          https://github.com/alerque/libertinus
Copyright:           Copyright © 2012-2020 The Libertinus Project Authors.
License URL:         https://scripts.sil.org/OFL
License Description: This Font Software is licensed under the SIL Open Font License, Version 1.1
Vendor ID:           QUE

.ft R
.fi

.Pp
گزینه \-\-no\-symbolic\-names:

$ luafindfont -n 

.Pp
این دستور خروجی زیر را تولید می‌کند:

.nf
.ft CW
bash-3.2$ luafindfont -n minion
 Nr.                 Fontname                                   Path
   1.      MinionMath-Bold.otf  /Users/voss/Library/Fonts/MinionMath/
   2.   MinionMath-Regular.otf  /Users/voss/Library/Fonts/MinionMath/
   3.       MinionPro-Bold.otf   /Users/voss/Library/Fonts/MinionPro/
   4.     MinionPro-BoldCn.otf   /Users/voss/Library/Fonts/MinionPro/
   5.   MinionPro-BoldCnIt.otf   /Users/voss/Library/Fonts/MinionPro/
   6.     MinionPro-BoldIt.otf   /Users/voss/Library/Fonts/MinionPro/
   7.       MinionPro-Capt.otf   /Users/voss/Library/Fonts/MinionPro/
   8.       MinionPro-Disp.otf   /Users/voss/Library/Fonts/MinionPro/
   9.         MinionPro-It.otf   /Users/voss/Library/Fonts/MinionPro/
  10.     MinionPro-Medium.otf   /Users/voss/Library/Fonts/MinionPro/
  11.   MinionPro-MediumIt.otf   /Users/voss/Library/Fonts/MinionPro/
  12.    MinionPro-Regular.otf   /Users/voss/Library/Fonts/MinionPro/
  13.   MinionPro-Semibold.otf   /Users/voss/Library/Fonts/MinionPro/
  14. MinionPro-SemiboldIt.otf   /Users/voss/Library/Fonts/MinionPro/
  15.       MinionPro-Subh.otf   /Users/voss/Library/Fonts/MinionPro/
.ft R
.fi

.SH "همچنین ببینید (SEE ALSO)"
برای جزئیات بیشتر به luafindfont-doc.pdf مراجعه کنید.
.SH "گزارش باگ‌ها (BUGS)"
هیچ باگ شناخته‌شده‌ای وجود ندارد.
.SH "نویسندگان (AUTHORS)"
Herbert Voß (hvoss@tug.org)
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
مجوز کپی، توزیع و/یا تغییر این نرم‌افزار تحت شرایط مجوز عمومی پروژه لایتک (LaTeX Project Public License)، نسخه ۱.۳ صادر شده است.