.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "AUTOINST 1" .TH AUTOINST 1 2026-02-10 fontools "Marc Penninga" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" autoinst \- پوسته‌ای برای LCDF TypeTools جهت نصب و استفاده از قلم‌های OpenType در LaTeX .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBautoinst\fR \fI\-help\fR .PP \&\fBautoinst\fR [\fIگزینه‌ها\fR] \fBقلم(ها)\fR .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" ابزارهای \fILCDF TypeTools\fR ادی کوهلر (Eddie Kohler) ابزارهایی فوق‌العاده برای نصب قلم‌های OpenType در LaTeX هستند، اما استفاده از آن‌ها می‌تواند دشوار باشد: آن‌ها نیازمند خط‌فرمان‌های متعدد و اغلب طولانی هستند و فایل‌های \fIfd\fR و \fIsty\fR مورد نیاز LaTeX را تولید نمی‌کنند. دستور \&\fBautoinst\fR با ایجاد و اجرای تمام دستورات برای \fIotftotfm\fR، و ایجاد و نصب تمامی فایل‌های \fIfd\fR و \fIsty\fR لازم، استفاده از \fITypeTools\fR را برای نصب قلم ساده می‌کند. .PP با دریافت یک خانواده از فایل‌های قلم (در قالب \fIotf\fR یا \fIttf\fR)، دستور \&\fBautoinst\fR چندین خانوادهٔ قلم LaTeX ایجاد خواهد کرد: .RS 2 .IP \- 3 چهار خانوادهٔ متنی (با ارقام تراز [lining] و کهن [oldstyle]، هرکدام در هر دو حالت جدول‌بندی‌شده [tabular] و متناسب [proportional])، همگی با شکل‌های زیر: .RS 3 .RS 2 .IP \fIn\fR 8 .IX Item "n" متن رومی (یعنی ایستاده / upright) .IP "\fIit\fR, \fIsl\fR" 8 .IX Item "it, sl" متن ایتالیک و مایل (گاهی خوابیده یا oblique نامیده می‌شود) .IP \fIsc\fR 8 .IX Item "sc" حروف کوچک‌بزرگ (Small caps) .IP "\fIscit\fR, \fIscsl\fR" 8 .IX Item "scit, scsl" حروف کوچک‌بزرگ ایتالیک و مایل .IP \fIsw\fR 8 .IX Item "sw" تزیینی (Swash) .IP \fInw\fR 8 .IX Item "nw" «تزیینی ایستاده» ("Upright swash") .RE .RS 2 .RE .RE .RS 3 .RE .IP \- 3 به ازای هر خانوادهٔ متنی با کدگذاری T1: یک خانواده از قلم‌های نماد با کدگذاری TS1، در شکل‌های رومی، ایتالیک و مایل. .IP \- 3 خانواده‌هایی با نویسه‌های بالاوند (superiors)، فروند (inferiors)، صورت (numerators) و مخرج (denominators)، در شکل‌های رومی، ایتالیک و مایل. .IP \- 3 خانواده‌هایی با نویسه‌های «عنوان‌بندی» (Titling)؛ این‌ها \fI«... جایگزین نویسه‌واره‌های پیش‌فرض با گونه‌های متناظری می‌شوند که مشخصاً برای عنوان‌بندی طراحی شده‌اند. این گونه‌ها ممکن است تماماً حروف بزرگ بوده و/یا روی بدنه بزرگ‌تر باشند، و برای نمایش در اندازه‌های بزرگ‌تر تنظیم شده باشند»\fR (بر اساس مشخصات OpenType). .IP \- 3 یک خانواده از نقوش تزیینی (ornament)؛ همچنین در شکل‌های رومی، ایتالیک و مایل. .RE .RS 2 .RE .PP بدیهی است اگر قلم‌های شما فاقد حروف ایتالیک، ارقام کهن، حروف کوچک‌بزرگ و غیره باشند، شکل‌ها و خانواده‌های متناظر با آن‌ها ایجاد نخواهند شد. علاوه بر این، ایجاد اکثر خانواده‌ها و شکل‌ها می‌تواند توسط کاربر کنترل شود (بخش «COMMAND\-LINE OPTIONS» را در ادامه ببینید). .PP این خانواده‌ها از طرح نام‌گذاری پروژهٔ \fIFontPro\fR استفاده می‌کنند: \&\fI\-\fR، که در آن \fI\fR عبارت است از: .IP \fILF\fR 8 .IX Item "LF" ارقام تراز متناسب (یعنی ارقام دارای عرض‌های متغیر هستند) .IP \fITLF\fR 8 .IX Item "TLF" ارقام تراز جدول‌بندی‌شده (یعنی تمام ارقام دارای عرض یکسانی هستند) .IP \fIOsF\fR 8 .IX Item "OsF" ارقام کهن متناسب .IP \fITOsF\fR 8 .IX Item "TOsF" ارقام کهن جدول‌بندی‌شده .IP \fISup\fR 8 .IX Item "Sup" نویسه‌های بالاوند (توجه داشته باشید که اکثر قلم‌ها تنها یک مجموعهٔ ناقص از نویسه‌های بالاوند دارند: ارقام، برخی علائم نگارشی و حروف \fIabdeilmnorst\fR؛ برای سایر نویسه‌ها از حالت‌های عادی استفاده می‌شود) .IP \fIInf\fR 8 .IX Item "Inf" نویسه‌های فروند؛ معمولاً فقط ارقام و برخی علائم نگارشی، و حالت‌های عادی برای سایر نویسه‌ها .IP \fITitl\fR 8 .IX Item "Titl" نویسه‌های عنوان‌بندی (Titling)؛ بالا را ببینید .IP \fIOrn\fR 8 .IX Item "Orn" نقوش تزیینی (ornaments) .IP "\fINumr\fR, \fIDnom\fR" 8 .IX Item "Numr, Dnom" صورت‌ها و مخرج‌ها .PP قلم‌های مجزا به صورت \fI\-\-\-\fR نام‌گذاری می‌شوند، که در آن \fI\fR همان موارد بالا است (اما با حروف کوچک)، \&\fI\fR خالی، "sc" یا "swash" است، و \fI\fR کدگذاری است (همچنین با حروف کوچک). یک نام نمونه در این طرح می‌تواند \fIFiraSans\-Light\-osf\-sc\-ly1\fR باشد..SS "استفاده از قلم‌ها در اسناد LaTeX (Using the fonts in your LaTeX documents)" .IX Subsection "Using the fonts in your LaTeX documents" \&\fBautoinst\fR یک فایل شیوه برای استفاده از قلم‌ها در اسناد LaTeX با نام \fI.sty\fR تولید می‌کند. این فایل شیوه همچنین در صورت نیاز، بسته‌های \fIfontenc\fR و \fItextcomp\fR را بارگذاری می‌کند. برای استفاده از قلم‌ها، دستور \f(CW\*(C`\eusepackage{\fR\f(CI\fR\f(CW}\*(C'\fR را به دیباچهٔ (preamble) سند خود بیفزایید. .PP این فایل شیوه دارای چند گزینه است: .ie n .IP """mainfont""" 4 .el .IP \f(CWmainfont\fR 4 .IX Item "mainfont" دستور \f(CW\*(C`\efamilydefault\*(C'\fR را بازتعریف می‌کند تا این قلم را به قلم اصلی سند تبدیل کند. اگر قلم به عنوان یک قلم serif نصب شده باشد، این یک عملیات بی‌اثر (no\-op) است؛ اما اگر قلم به عنوان قلم sanserif یا typewriter نصب شده باشد، این گزینه شما را از بازتعریف دستی \f(CW\*(C`\efamilydefault\*(C'\fR بی‌نیاز می‌کند. .ie n .IP """lining"", ""oldstyle"", ""tabular"", ""proportional""" 4 .el .IP "\f(CWlining\fR, \f(CWoldstyle\fR, \f(CWtabular\fR, \f(CWproportional\fR" 4 .IX Item "lining, oldstyle, tabular, proportional" انتخاب این‌که از کدام شیوهٔ ارقام (figure style) استفاده شود. حالت‌های پیش‌فرض، "oldstyle" و "proportional" هستند (در صورت موجود بودن). .ie n .IP """scale=\fI\fR"", ""scale=MatchLowercase""" 4 .el .IP "\f(CWscale=\fR\f(CI\fR\f(CW\fR, \f(CWscale=MatchLowercase\fR" 4 .IX Item "scale=, scale=MatchLowercase" مقیاس قلم را به میزان \fI\fR تغییر می‌دهد؛ به عنوان نمونه، \f(CW\*(C`\eusepackage[scale=1.05]{\fR\f(CI\fR\f(CW}\*(C'\fR اندازهٔ قلم را ۵٪ افزایش می‌دهد. مقدار ویژهٔ \f(CW\*(C`MatchLowercase\*(C'\fR می‌تواند برای مقیاس‌بندی قلم استفاده شود به گونه‌ای که x\-height (ارتفاع حروف کوچک) آن با قلم اصلی فعلی مطابقت پیدا کند (که معمولاً Computer Modern Roman است، مگر این‌که بستهٔ قلم دیگری را پیش از این بارگذاری کرده باشید). کلمهٔ "scale" همچنین می‌تواند به صورت "scaled" نیز نوشته شود. .ie n .IP """medium"", ""book"", ""text"", ""normal"", ""regular""" 4 .el .IP "\f(CWmedium\fR, \f(CWbook\fR, \f(CWtext\fR, \f(CWnormal\fR, \f(CWregular\fR" 4 .IX Item "medium, book, text, normal, regular" وزنی را که LaTeX به عنوان وزن "regular" استفاده خواهد کرد انتخاب می‌کند. .ie n .IP """heavy"", ""black"", ""extrabold"", ""demibold"", ""semibold"", ""bold""" 4 .el .IP "\f(CWheavy\fR, \f(CWblack\fR, \f(CWextrabold\fR, \f(CWdemibold\fR, \f(CWsemibold\fR, \f(CWbold\fR" 4 .IX Item "heavy, black, extrabold, demibold, semibold, bold" وزنی را که LaTeX به عنوان وزن "bold" استفاده خواهد کرد انتخاب می‌کند. .PP حالت پیش‌فرض در اینجا این است که پیش‌فرض LaTeX تغییر نکند، یعنی استفاده از وزن‌های "m" و "b". .PP فایل شیوه همچنین تلاش خواهد کرد بستهٔ \fIfigureversions\fR (در CTAN) را بارگذاری کند، که دسترسی آسان به شکل‌ها و سبک‌های مختلف قلم را فراهم می‌کند. با استفاده از سازوکار ارائه‌شده توسط \fIfigureversions\fR، فایل شیوهٔ تولیدشده تعدادی دستور (که متن مورد نظر برای حروف‌چینی را به عنوان آرگومان می‌گیرند) و اعلان (که آرگومانی نمی‌پذیرند، اما بر همهٔ متن تا انتهای گروه فعلی اثر می‌گذارند) برای دسترسی به نویسه‌های titling، superior و inferior تعریف می‌کند: .PP .Vb 1 \& DECLARATION COMMAND SHORT FORM OF COMMAND \& \& \etlshape \etexttitling \etexttl \& \esupfigures \etextsuperior \etextsup, \etextsu \& \einffigures \etextinferior \etextinf, \etextin .Ve .PP در نهایت، این فایل شیوه دستورهای \f(CW\*(C`\etextsuperscript\*(C'\fR و \&\f(CW\*(C`\etextsubscript\*(C'\fR در LaTeX را برای استفاده از ارقام superior و inferior قلم‌ها بازتعریف کرده و سازوکار پانویس LaTeX را تغییر می‌دهد تا به جای اعداد کوچک‌شده از قلم متن عادی، از \f(CW\*(C`\etextsuperscript\*(C'\fR استفاده کند. نسخه‌های قدیمی این دستورها همچنان به صورت \&\f(CW\*(C`\etextsuperscript*\*(C'\fR و \f(CW\*(C`\etextsubscript*\*(C'\fR در دسترس هستند. .PP هیچ دستوری برای دسترسی به قلم‌های numerator و denominator وجود ندارد؛ این قلم‌ها را می‌توان با استفاده از دستورهای استاندارد \fIfigureversions\fR انتخاب کرد، برای مثال: \f(CW\*(C`\efontfigurestyle{numerator}\eselectfont\*(C'\fR. .PP بار دیگر تأکید می‌شود: همهٔ این دستورها تنها برای شکل‌ها و سبک‌های اعداد موجود تولید می‌شوند؛ هیچ دستوری برای شکل‌ها و سبک‌هایی که در قلم‌های شما مفقود هستند تولید نمی‌شود. توجه داشته باشید که تمام این دستورها بر پایهٔ \fIfigureversions\fR ساخته شده‌اند؛ اگر آن بسته پیدا نشود، به استفاده از دستورهای سطح پایین‌تر از NFSS استاندارد (\f(CW\*(C`\efontfamily\*(C'\fR، \f(CW\*(C`\efontseries\*(C'\fR، \f(CW\*(C`\efontshape\*(C'\fR و غیره) محدود خواهید بود. .PP به‌طور پیش‌فرض، \fBautoinst\fR قلم‌های متنی را با کدگذاری‌های OT1، LY1 و T1 تولید می‌کند، و فایل‌های شیوهٔ تولیدشده از T1 به عنوان کدگذاری متن پیش‌فرض استفاده می‌کنند. کدگذاری‌های دیگر را می‌توان با استفاده از گزینهٔ \fI\-encoding\fR انتخاب کرد (بخش «گزینه‌های خط فرمان (COMMAND\-LINE OPTIONS)» در ادامه را ببینید)..SS "ریاضیات (Maths)" .IX Subsection "Maths" این یک ویژگی آزمایشی است؛ \fBمسئولیت استفاده کاملاً بر عهدهٔ خودتان است!\fR پیش از به‌کارگیری نتایج در اسناد واقعی، آن‌ها را به دقت آزمایش کنید، و آگاه باشید که نگارش‌های آیندهٔ \fBautoinst\fR ممکن است تغییرات ناسازگاری ایجاد کنند. .PP گزینهٔ \fI\-math\fR به \fBautoinst\fR می‌گوید قلم‌های ریاضی پایه را تولید کند. هنگام فعال بودن، فایل استایل تولیدشده چند گزینهٔ اضافی را برای دسترسی به این قلم‌های ریاضی تعریف می‌کند: .ie n .IP """math""" 4 .el .IP \f(CWmath\fR 4 .IX Item "math" استفاده از این قلم‌ها برای فرمول‌های ریاضی در سند شما. .ie n .IP """mathlining"", ""matholdstyle"", ""mathtabular"", ""mathproportional""" 4 .el .IP "\f(CWmathlining\fR, \f(CWmatholdstyle\fR, \f(CWmathtabular\fR, \f(CWmathproportional\fR" 4 .IX Item "mathlining, matholdstyle, mathtabular, mathproportional" انتخاب سبک و تراز ارقام برای استفاده در ریاضیات. مقادیر پیش‌فرض "mathlining" و "mathtabular" هستند. .ie n .IP """mathcal""" 4 .el .IP \f(CWmathcal\fR 4 .IX Item "mathcal" استفاده از نویسه‌های تزئینی (swash) این قلم‌ها به عنوان الفبای \f(CW\*(C`\emathcal\*(C'\fR. (این گزینه تنها زمانی وجود خواهد داشت که قلم‌های شما در عمل هم شامل نویسه‌های تزئینی و هم ویژگی \f(CW\*(C`swsh\*(C'\fR برای دسترسی به آن‌ها باشند). .ie n .IP """nomathgreek""" 4 .el .IP \f(CWnomathgreek\fR 4 .IX Item "nomathgreek" عدم تعریف دوبارهٔ حروف یونانی در ریاضیات. .ie n .IP """math\-style=\fI