| 1 |
.\" -*- mode: troff; coding: utf-8 -*- |
| 2 |
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) |
| 3 |
.\" |
| 4 |
.\" Standard preamble: |
| 5 |
.\" ======================================================================== |
| 6 |
.de Sp \" Vertical space (when we can't use .PP) |
| 7 |
.if t .sp .5v |
| 8 |
.if n .sp |
| 9 |
.. |
| 10 |
.de Vb \" Begin verbatim text |
| 11 |
.ft CW |
| 12 |
.nf |
| 13 |
.ne \\$1 |
| 14 |
.. |
| 15 |
.de Ve \" End verbatim text |
| 16 |
.ft R |
| 17 |
.fi |
| 18 |
.. |
| 19 |
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. |
| 20 |
.ie n \{\ |
| 21 |
. ds C` "" |
| 22 |
. ds C' "" |
| 23 |
'br\} |
| 24 |
.el\{\ |
| 25 |
. ds C` |
| 26 |
. ds C' |
| 27 |
'br\} |
| 28 |
.\" |
| 29 |
.\" Escape single quotes in literal strings from groff's Unicode transform. |
| 30 |
.ie \n(.g .ds Aq \(aq |
| 31 |
.el .ds Aq ' |
| 32 |
.\" |
| 33 |
.\" If the F register is >0, we'll generate index entries on stderr for |
| 34 |
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index |
| 35 |
.\" entries marked with X<> in POD. Of course, you'll have to process the |
| 36 |
.\" output yourself in some meaningful fashion. |
| 37 |
.\" |
| 38 |
.\" Avoid warning from groff about undefined register 'F'. |
| 39 |
.de IX |
| 40 |
.. |
| 41 |
.nr rF 0 |
| 42 |
.if \n(.g .if rF .nr rF 1 |
| 43 |
.if (\n(rF:(\n(.g==0)) \{\ |
| 44 |
. if \nF \{\ |
| 45 |
. de IX |
| 46 |
. tm Index:\\$1\t\\n%\t"\\$2" |
| 47 |
.. |
| 48 |
. if !\nF==2 \{\ |
| 49 |
. nr % 0 |
| 50 |
. nr F 2 |
| 51 |
. \} |
| 52 |
. \} |
| 53 |
.\} |
| 54 |
.rr rF |
| 55 |
.\" |
| 56 |
.\" Required to disable full justification in groff 1.23.0. |
| 57 |
.if n .ds AD l |
| 58 |
.\" ======================================================================== |
| 59 |
.\" |
| 60 |
.IX Title "AUTOINST 1" |
| 61 |
.TH AUTOINST 1 2026-04-22 fontools "Marc Penninga" |
| 62 |
.\" For nroff, turn off justification. Always turn off hyphenation; it makes |
| 63 |
.\" way too many mistakes in technical documents. |
| 64 |
.if n .ad l |
| 65 |
.nh |
| 66 |
.SH NAME |
| 67 |
autoinst \- wrapper around the LCDF TypeTools, |
| 68 |
for installing and using OpenType fonts in LaTeX. |
| 69 |
.SH SYNOPSIS |
| 70 |
.IX Header "SYNOPSIS" |
| 71 |
\&\fBautoinst\fR \fI\-help\fR |
| 72 |
.PP |
| 73 |
\&\fBautoinst\fR [\fIoptions\fR] \fBfont(s)\fR |
| 74 |
.SH DESCRIPTION |
| 75 |
.IX Header "DESCRIPTION" |
| 76 |
Eddie Kohler\*(Aqs \fILCDF TypeTools\fR are superb tools for installing |
| 77 |
OpenType fonts in LaTeX, but they can be hard to use: |
| 78 |
they need many, often long, command lines |
| 79 |
and don\*(Aqt generate the \fIfd\fR and \fIsty\fR files LaTeX needs. |
| 80 |
\&\fBautoinst\fR simplifies the use of the \fITypeTools\fR for font installation |
| 81 |
by generating and executing all commands for \fIotftotfm\fR, |
| 82 |
and by creating and installing all necessary \fIfd\fR and \fIsty\fR files. |
| 83 |
.PP |
| 84 |
Given a family of font files (in \fIotf\fR or \fIttf\fR format), |
| 85 |
\&\fBautoinst\fR will create several LaTeX font families: |
| 86 |
.RS 2 |
| 87 |
.IP \- 3 |
| 88 |
Four text families (with lining and oldstyle digits, |
| 89 |
each in both tabular and proportional variants), |
| 90 |
all with the following shapes: |
| 91 |
.RS 3 |
| 92 |
.RS 2 |
| 93 |
.IP \fIn\fR 8 |
| 94 |
.IX Item "n" |
| 95 |
Roman (i.e., upright) text |
| 96 |
.IP "\fIit\fR, \fIsl\fR" 8 |
| 97 |
.IX Item "it, sl" |
| 98 |
Italic and slanted (sometimes called oblique) text |
| 99 |
.IP \fIsc\fR 8 |
| 100 |
.IX Item "sc" |
| 101 |
Small caps |
| 102 |
.IP "\fIscit\fR, \fIscsl\fR" 8 |
| 103 |
.IX Item "scit, scsl" |
| 104 |
Italic and slanted small caps |
| 105 |
.IP \fIsw\fR 8 |
| 106 |
.IX Item "sw" |
| 107 |
Swash |
| 108 |
.IP \fInw\fR 8 |
| 109 |
.IX Item "nw" |
| 110 |
"Upright swash" |
| 111 |
.RE |
| 112 |
.RS 2 |
| 113 |
.RE |
| 114 |
.RE |
| 115 |
.RS 3 |
| 116 |
.RE |
| 117 |
.IP \- 3 |
| 118 |
For each T1\-encoded text family: |
| 119 |
a family of TS1\-encoded symbol fonts, in roman, italic and slanted shapes. |
| 120 |
.IP \- 3 |
| 121 |
Families with superiors, inferiors, numerators and denominators, |
| 122 |
in roman, italic and slanted shapes. |
| 123 |
.IP \- 3 |
| 124 |
Families with "Titling" characters; |
| 125 |
these \fI"... replace the default glyphs |
| 126 |
with corresponding forms designed specifically for titling. |
| 127 |
These may be all\-capital and/or larger on the body, |
| 128 |
and adjusted for viewing at larger sizes"\fR |
| 129 |
(according to the OpenType Specification). |
| 130 |
.IP \- 3 |
| 131 |
An ornament family; also in roman, italic and slanted shapes. |
| 132 |
.RE |
| 133 |
.RS 2 |
| 134 |
.RE |
| 135 |
.PP |
| 136 |
Of course, if your fonts don\*(Aqt contain italics, oldstyle digits, small caps |
| 137 |
etc., the corresponding shapes and families are not created. |
| 138 |
In addition, the creation of most families and shapes can be controlled |
| 139 |
by the user (see "COMMAND\-LINE OPTIONS" below). |
| 140 |
.PP |
| 141 |
These families use the \fIFontPro\fR project\*(Aqs naming scheme: |
| 142 |
\&\fI<FontFamily>\-<Suffix>\fR, where \fI<Suffix>\fR is: |
| 143 |
.IP \fILF\fR 8 |
| 144 |
.IX Item "LF" |
| 145 |
proportional (i.e., figures have varying widths) lining figures |
| 146 |
.IP \fITLF\fR 8 |
| 147 |
.IX Item "TLF" |
| 148 |
tabular (i.e., all figures have the same width) lining figures |
| 149 |
.IP \fIOsF\fR 8 |
| 150 |
.IX Item "OsF" |
| 151 |
proportional oldstyle figures |
| 152 |
.IP \fITOsF\fR 8 |
| 153 |
.IX Item "TOsF" |
| 154 |
tabular oldstyle figures |
| 155 |
.IP \fISup\fR 8 |
| 156 |
.IX Item "Sup" |
| 157 |
superior characters (note that most fonts have only an incomplete set of |
| 158 |
superior characters: digits, some punctuation and the letters \fIabdeilmnorst\fR; |
| 159 |
normal forms are used for other characters) |
| 160 |
.IP \fIInf\fR 8 |
| 161 |
.IX Item "Inf" |
| 162 |
inferior characters; usually only digits and some punctuation, |
| 163 |
normal forms for other characters |
| 164 |
.IP \fITitl\fR 8 |
| 165 |
.IX Item "Titl" |
| 166 |
Titling characters; see above |
| 167 |
.IP \fIOrn\fR 8 |
| 168 |
.IX Item "Orn" |
| 169 |
ornaments |
| 170 |
.IP "\fINumr\fR, \fIDnom\fR" 8 |
| 171 |
.IX Item "Numr, Dnom" |
| 172 |
numerators and denominators |
| 173 |
.PP |
| 174 |
The individual fonts are named \fI<FontName>\-<suffix>\-<shape>\-<enc>\fR, |
| 175 |
where \fI<suffix>\fR is the same as above (but in lowercase), |
| 176 |
\&\fI<shape>\fR is either empty, "sc" or "swash", |
| 177 |
and \fI<enc>\fR is the encoding (also in lowercase). |
| 178 |
A typical name in this scheme would be \fIFiraSans\-Light\-osf\-sc\-ly1\fR. |
| 179 |
.SS "Using the fonts in your LaTeX documents" |
| 180 |
.IX Subsection "Using the fonts in your LaTeX documents" |
| 181 |
\&\fBautoinst\fR generates a style file for using the fonts in LaTeX documents, |
| 182 |
named \fI<FontFamily>.sty\fR. This style file also loads the \fIfontenc\fR |
| 183 |
and \fItextcomp\fR packages, if necessary. |
| 184 |
To use the fonts, add the command \f(CW\*(C`\eusepackage{\fR\f(CI<FontFamily>\fR\f(CW}\*(C'\fR |
| 185 |
to the preamble of your document. |
| 186 |
.PP |
| 187 |
This style file has a few options: |
| 188 |
.ie n .IP """mainfont""" 4 |
| 189 |
.el .IP \f(CWmainfont\fR 4 |
| 190 |
.IX Item "mainfont" |
| 191 |
Redefine \f(CW\*(C`\efamilydefault\*(C'\fR to make this font the main font |
| 192 |
for the document. |
| 193 |
This is a no\-op if the font is installed as a serif font; |
| 194 |
but if the font is installed as a sanserif or typewriter font, |
| 195 |
this option saves you from having to redefine \f(CW\*(C`\efamilydefault\*(C'\fR |
| 196 |
yourself. |
| 197 |
.ie n .IP """lining"", ""oldstyle"", ""tabular"", ""proportional""" 4 |
| 198 |
.el .IP "\f(CWlining\fR, \f(CWoldstyle\fR, \f(CWtabular\fR, \f(CWproportional\fR" 4 |
| 199 |
.IX Item "lining, oldstyle, tabular, proportional" |
| 200 |
Choose which figure style to use. |
| 201 |
The defaults are "oldstyle" and "proportional" (if available). |
| 202 |
.ie n .IP """scale=\fI<factor>\fR"", ""scale=MatchLowercase""" 4 |
| 203 |
.el .IP "\f(CWscale=\fR\f(CI<factor>\fR\f(CW\fR, \f(CWscale=MatchLowercase\fR" 4 |
| 204 |
.IX Item "scale=<factor>, scale=MatchLowercase" |
| 205 |
Scale the font by \fI<factor>\fR; |
| 206 |
as an example, \f(CW\*(C`\eusepackage[scale=1.05]{\fR\f(CI<FontFamily>\fR\f(CW}\*(C'\fR |
| 207 |
will increase the font\*(Aqs size by 5%. |
| 208 |
The special value \f(CW\*(C`MatchLowercase\*(C'\fR may be used to scale the font |
| 209 |
so that its x\-height matches that of the current main font |
| 210 |
(which is usually Computer Modern Roman, unless you have loaded |
| 211 |
another font package before this one). |
| 212 |
The word "scale" may also be spelled as "scaled". |
| 213 |
.ie n .IP """medium"", ""book"", ""text"", ""normal"", ""regular""" 4 |
| 214 |
.el .IP "\f(CWmedium\fR, \f(CWbook\fR, \f(CWtext\fR, \f(CWnormal\fR, \f(CWregular\fR" 4 |
| 215 |
.IX Item "medium, book, text, normal, regular" |
| 216 |
Select the weight that LaTeX will use as the "regular" weight. |
| 217 |
.ie n .IP """heavy"", ""black"", ""extrabold"", ""demibold"", ""semibold"", ""bold""" 4 |
| 218 |
.el .IP "\f(CWheavy\fR, \f(CWblack\fR, \f(CWextrabold\fR, \f(CWdemibold\fR, \f(CWsemibold\fR, \f(CWbold\fR" 4 |
| 219 |
.IX Item "heavy, black, extrabold, demibold, semibold, bold" |
| 220 |
Select the weight that LaTeX will use as the "bold" weight. |
| 221 |
.PP |
| 222 |
The default here is not to change LaTeX\*(Aqs default, |
| 223 |
i.e. use the "m" and "b" weights. |
| 224 |
.PP |
| 225 |
The style file will also try to load the \fIfigureversions\fR package |
| 226 |
(on CTAN), which gives easy access to various font shapes and styles. |
| 227 |
Using the machinery set up by \fIfigureversions\fR, the generated style file |
| 228 |
defines a number of commands (which take the text to be typeset as argument) |
| 229 |
and declarations (which don\*(Aqt take arguments, but affect all text up to |
| 230 |
the end of the current group) to access titling, superior and inferior |
| 231 |
characters: |
| 232 |
.PP |
| 233 |
.Vb 1 |
| 234 |
\& DECLARATION COMMAND SHORT FORM OF COMMAND |
| 235 |
\& |
| 236 |
\& \etlshape \etexttitling \etexttl |
| 237 |
\& \esupfigures \etextsuperior \etextsup, \etextsu |
| 238 |
\& \einffigures \etextinferior \etextinf, \etextin |
| 239 |
.Ve |
| 240 |
.PP |
| 241 |
Finally, the style file redefines Latex\*(Aqs \f(CW\*(C`\etextsuperscript\*(C'\fR and |
| 242 |
\&\f(CW\*(C`\etextsubscript\*(C'\fR commands to use the fonts\*(Aq superior and inferior figures, |
| 243 |
and modifies Latex\*(Aqs footnote mechanism to use \f(CW\*(C`\etextsuperscript\*(C'\fR |
| 244 |
instead of reduced\-size numerals from the regular text font. |
| 245 |
The old versions of these commands are still available as |
| 246 |
\&\f(CW\*(C`\etextsuperscript*\*(C'\fR and \f(CW\*(C`\etextsubscript*\*(C'\fR. |
| 247 |
.PP |
| 248 |
There are no commands for accessing the numerator and denominator |
| 249 |
fonts; these can be selected using \fIfigureversions\fR\*(Aq standard commands, |
| 250 |
e.g., \f(CW\*(C`\efontfigurestyle{numerator}\eselectfont\*(C'\fR. |
| 251 |
.PP |
| 252 |
Once again: all these commands are only generated for existing shapes and number styles; |
| 253 |
no commands are generated for shapes and styles that are missing from your fonts. |
| 254 |
Note that all these commands are built on top of \fIfigureversions\fR; if that package |
| 255 |
cannot be found, you\*(Aqre limited to using lower\-level commands from |
| 256 |
standard NFSS (\f(CW\*(C`\efontfamily\*(C'\fR, \f(CW\*(C`\efontseries\*(C'\fR, \f(CW\*(C`\efontshape\*(C'\fR etc.). |
| 257 |
.PP |
| 258 |
By default, \fBautoinst\fR generates text fonts with OT1, LY1 and T1 |
| 259 |
encodings, and the generated style files use T1 as the default text encoding. |
| 260 |
Other encodings can be chosen using the \fI\-encoding\fR option |
| 261 |
(see "COMMAND\-LINE OPTIONS" below). |
| 262 |
.SS Maths |
| 263 |
.IX Subsection "Maths" |
| 264 |
This is an experimental feature; \fBUSE AT YOUR OWN RISK!\fR |
| 265 |
Test the results thoroughly before using them in real documents, |
| 266 |
and be warned that future versions of \fBautoinst\fR may introduce |
| 267 |
incompatible changes. |
| 268 |
.PP |
| 269 |
The \fI\-math\fR option tells \fBautoinst\fR to generate basic math fonts. |
| 270 |
When enabled, the generated style file defines a few extra options |
| 271 |
to access these math fonts: |
| 272 |
.ie n .IP """math""" 4 |
| 273 |
.el .IP \f(CWmath\fR 4 |
| 274 |
.IX Item "math" |
| 275 |
Use these fonts for the maths in your document. |
| 276 |
.ie n .IP """mathlining"", ""matholdstyle"", ""mathtabular"", ""mathproportional""" 4 |
| 277 |
.el .IP "\f(CWmathlining\fR, \f(CWmatholdstyle\fR, \f(CWmathtabular\fR, \f(CWmathproportional\fR" 4 |
| 278 |
.IX Item "mathlining, matholdstyle, mathtabular, mathproportional" |
| 279 |
Choose which figure style and alignment to use in maths. |
| 280 |
The defaults are "mathlining" and "mathtabular". |
| 281 |
.ie n .IP """mathcal""" 4 |
| 282 |
.el .IP \f(CWmathcal\fR 4 |
| 283 |
.IX Item "mathcal" |
| 284 |
Use the swash characters from these fonts as the \f(CW\*(C`\emathcal\*(C'\fR alphabet. |
| 285 |
(This option will only exist if your fonts actually contain |
| 286 |
both swash characters and a \f(CW\*(C`swsh\*(C'\fR feature to access them). |
| 287 |
.ie n .IP """nomathgreek""" 4 |
| 288 |
.el .IP \f(CWnomathgreek\fR 4 |
| 289 |
.IX Item "nomathgreek" |
| 290 |
Don\*(Aqt redeclare greek letters in math. |
| 291 |
.ie n .IP """math\-style=\fI<style>\fR""" 4 |
| 292 |
.el .IP \f(CWmath\-style=\fR\f(CI<style>\fR\f(CW\fR 4 |
| 293 |
.IX Item "math-style=<style>" |
| 294 |
Choose the "math style" to use. |
| 295 |
With \f(CW\*(C`math\-style=ISO\*(C'\fR, all latin and greek letters in math are italic; |
| 296 |
with \f(CW\*(C`math\-style=TeX\*(C'\fR (the default), uppercase greek is upright; |
| 297 |
with \f(CW\*(C`math\-style=french\*(C'\fR, all greek as well as uppercase latin is upright; |
| 298 |
and with \f(CW\*(C`math\-style=upright\*(C'\fR all letters are upright. |
| 299 |
.ie n .IP """scriptscale=\fI<scale>\fR""" 4 |
| 300 |
.el .IP \f(CWscriptscale=\fR\f(CI<scale>\fR\f(CW\fR 4 |
| 301 |
.IX Item "scriptscale=<scale>" |
| 302 |
By default, Latex loads fonts for the "script" and "scriptscript" styles |
| 303 |
at 70% and 50% of the text font size. For many text fonts, this is too small |
| 304 |
and hurts readability. |
| 305 |
This option scales the "script" style by a factor of \fIscale\fR and |
| 306 |
the "scriptscript" style by the square of that. |
| 307 |
The default value is 1.1, which loads the "script" and "scriptscript" styles |
| 308 |
at a more readable 77% and 60.5%, respectively. |
| 309 |
To use Latex\*(Aqs defaults, use \f(CW\*(C`scriptscale=1.0\*(C'\fR. |
| 310 |
.PP |
| 311 |
The style file also defines commands \f(CW\*(C`\eup...\*(C'\fR and \f(CW\*(C`\eit...\*(C'\fR to access upright |
| 312 |
and italic greek characters regardless of the chosen math style: |
| 313 |
\&\f(CW\*(C`\eupGamma\*(C'\fR, \f(CW\*(C`\eupalpha\*(C'\fR, \f(CW\*(C`\eitDelta\*(C'\fR, \f(CW\*(C`\eitbeta\*(C'\fR etc. |
| 314 |
.PP |
| 315 |
Note that this \f(CW\*(C`math\*(C'\fR option only affects digits, latin and greek letters, |
| 316 |
plus a few basic punctuation characters; all other mathematical symbols, |
| 317 |
operators, delimiters etc. are left as they were before. |
| 318 |
If you don\*(Aqt want to use TeX\*(Aqs default versions of those symbols, |
| 319 |
load another math package (such as \fImathdesign\fR or \fInewtxmath\fR) |
| 320 |
before loading the \fBautoinst\fR\-generated style file. |
| 321 |
.PP |
| 322 |
Finally, note that \fBautoinst\fR doesn\*(Aqt check if your fonts actually contains |
| 323 |
all of the required characters; |
| 324 |
it just assumes that they do and sets up the style file accordingly. |
| 325 |
Even if your fonts do contain greek, characters such as \f(CW\*(C`\evarepsilon\*(C'\fR |
| 326 |
may be missing. |
| 327 |
You may also find that some glyphs \fIare\fR present in your fonts, |
| 328 |
but don\*(Aqt work well in equations or don\*(Aqt match other symbols; |
| 329 |
edit the generated style file to remove the declarations of |
| 330 |
these offending characters. |
| 331 |
Once again: test the results before using them! |
| 332 |
If the characters themselves are fine but spaced too tightly, |
| 333 |
you may try increasing the side bearings in math fonts with |
| 334 |
the \fI\-mathspacing\fR option (see below), e.g. \f(CW\*(C`\-mathspacing=50\*(C'\fR. |
| 335 |
.SS "NFSS codes" |
| 336 |
.IX Subsection "NFSS codes" |
| 337 |
LaTeX\*(Aqs New Font Selection System (NFSS) |
| 338 |
identifies fonts by a combination of family, |
| 339 |
series (the concatenation of weight and width), shape and size. |
| 340 |
\&\fBautoinst\fR parses the font\*(Aqs metadata to determine these parameters. |
| 341 |
When this fails (usually because the font family contains uncommon weights, |
| 342 |
widths or shapes), |
| 343 |
\&\fBautoinst\fR ends up with multiple fonts having the same values |
| 344 |
for these font parameters; such fonts cannot be used in NFSS, |
| 345 |
since there\*(Aqs no way distinguish them. |
| 346 |
When \fBautoinst\fR detects such a situation, it will print an error message |
| 347 |
and abort. |
| 348 |
If that happens, either rerun \fBautoinst\fR on a smaller set of fonts, |
| 349 |
or add the missing widths, weights and shapes to the tables \f(CW@WIDTH\fR, |
| 350 |
\&\f(CW@WEIGHT\fR and \f(CW%SHAPE\fR in the source code. |
| 351 |
Please also send a bug report (see AUTHOR below). |
| 352 |
.PP |
| 353 |
The mapping of shapes to NFSS codes is done using the following table: |
| 354 |
.PP |
| 355 |
.Vb 5 |
| 356 |
\& SHAPE CODE |
| 357 |
\& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\- |
| 358 |
\& Roman, Upright n |
| 359 |
\& Italic it |
| 360 |
\& Oblique, Slant(ed), Incline(d) sl |
| 361 |
.Ve |
| 362 |
.PP |
| 363 |
(\fIException:\fR Adobe Silentium Pro contains two Roman shapes; |
| 364 |
we map the first of these to \f(CW\*(C`n\*(C'\fR, for the second one we (ab)use the \f(CW\*(C`it\*(C'\fR code |
| 365 |
as this family doesn\*(Aqt contain an Italic shape.) |
| 366 |
.PP |
| 367 |
For weights and widths, \fBautoinst\fR tries to the standard NFSS codes |
| 368 |
(ul, el, l, sl, m, sb, b, eb and ub for weights; |
| 369 |
uc, ec, c, sc, m, sx, x, ex and ux for widths) |
| 370 |
as much as possible. |
| 371 |
Of course, not all 81 combinations of these NFSS weights and widths will map |
| 372 |
to existing fonts; |
| 373 |
and conversely it may not be possible to assign every existing font |
| 374 |
a unique code in a sane way (especially for the weights, |
| 375 |
some font families offer more variants than NFSS\*(Aqs codes can handle; |
| 376 |
e.g., Fira Sans contains fifteen different weights!). |
| 377 |
Therefore every font is also assigned a "series" name that is |
| 378 |
the concatenation of its weight and width, |
| 379 |
after expanding any abbreviations and converting to lowercase. |
| 380 |
A font of "Cond" width and "Ultra" weight will then be known |
| 381 |
as "ultrablackcondensed". |
| 382 |
.PP |
| 383 |
The exact mapping between fonts and NFSS codes can be found |
| 384 |
in the log file and in the generated \fIfd\fR files |
| 385 |
(you may want to run \fBautoinst\fR with the \fI\-dryrun\fR option |
| 386 |
to check the chosen mapping beforehand). |
| 387 |
The \fI\-nfssweight\fR and \fI\-nfsswidth\fR command\-line options can be used |
| 388 |
to finetune the mapping between NFSS codes and fonts. |
| 389 |
.PP |
| 390 |
To access specific weights or widths, |
| 391 |
one can always use the \f(CW\*(C`\efontseries\*(C'\fR command with the full series name |
| 392 |
(i.e., \f(CW\*(C`\efontseries{demibold}\eselectfont\*(C'\fR). |
| 393 |
.PP |
| 394 |
\&\fBautoinst\fR will print a message for each weight and width that |
| 395 |
could not be mapped to a standard NFSS code. |
| 396 |
.SS Ornaments |
| 397 |
.IX Subsection "Ornaments" |
| 398 |
\&\fBautoinst\fR provides a best\-effort interface to access ornament characters. |
| 399 |
The OpenType specification offers two ways for fonts to implement ornaments: |
| 400 |
one way is to map them to the lowercase ASCII letters, the other is |
| 401 |
to define them as alternates for the "bullet" character. |
| 402 |
Ornaments of the first type can be used from Latex without problem, |
| 403 |
but ornaments implemented in the second way cannot easily be used from Latex |
| 404 |
(at least not generically; it may be done by creating font\-specific encoding files). |
| 405 |
.PP |
| 406 |
Unfortunately, there is no way to tell which of these alternatives a font uses; |
| 407 |
\&\fBautoinst\fR just assumes that the font maps ornaments to lowercase ASCII |
| 408 |
and creates an OT1\-encoded font that hopefully contains the ornaments, |
| 409 |
plus a \f(CW\*(C`\etextornament\*(C'\fR command to access them. |
| 410 |
That command takes one argument: the slot number of the ornament. |
| 411 |
E.g., to access the ornament at the position of "a" (hexadecimal 0x61), |
| 412 |
use \f(CW\*(C`\etextornament{"61}\*(C'\fR. |
| 413 |
.PP |
| 414 |
To see which ornaments a font contains (and at which positions), |
| 415 |
run LaTeX on the file \fInfssfont.tex\fR (which is included in any |
| 416 |
standard LaTeX installation), supply the name of the ornament font |
| 417 |
(i.e., \f(CW\*(C`Garamontio\-Regular\-orn\-u\*(C'\fR) and give the command \f(CW\*(C`\etable\ebye\*(C'\fR; |
| 418 |
this will create a table of all glyphs in that font. |
| 419 |
If this table shows no ornaments, your font unfortunately handles ornaments |
| 420 |
in a non\-Latex\-compatible (or at least non\-\fBautoinst\fR\-compatible) way. |
| 421 |
.PP |
| 422 |
As a final caveat, note that even when your font does handle ornaments in |
| 423 |
a Latex\-compatible way, it may very well map them to other characters |
| 424 |
(such as digits or punctuation) instead of lowercase ASCII. |
| 425 |
.SH "WARNINGS AND CAVEATS" |
| 426 |
.IX Header "WARNINGS AND CAVEATS" |
| 427 |
.SS "OpenType fonts and licensing issues" |
| 428 |
.IX Subsection "OpenType fonts and licensing issues" |
| 429 |
Since \fIpdfTeX\fR cannot subset otf\-flavoured OpenType fonts, |
| 430 |
\&\fIotftotfm\fR will convert such fonts to Type1 (pfb) format. |
| 431 |
However, many fonts (at least those licensed under the SIL Open Font License) |
| 432 |
do not allow redistributing such converted versions under their original name. |
| 433 |
.PP |
| 434 |
In order to try to meet such licensing requirements, \fBautoinst\fR provides |
| 435 |
a \fI\-t1suffix\fR command\-line option that appends a suffix to the names |
| 436 |
(both the file name and the internal font name) |
| 437 |
of all generated Type1 fonts; see "COMMAND\-LINE OPTIONS" below. |
| 438 |
.PP |
| 439 |
Please note that I am not a lawyer and do not guarantee that |
| 440 |
this suffix is sufficient to meet the license\*(Aqs requirements. |
| 441 |
When in doubt, consult a real lawyer! |
| 442 |
.SS "Sorry, LIGTABLE too long for me to handle" |
| 443 |
.IX Subsection "Sorry, LIGTABLE too long for me to handle" |
| 444 |
The LIGTABLE in TeX\*(Aqs \fItfm\fR files, which contains a font\*(Aqs ligatures |
| 445 |
and kerning pairs, is limited to about 32,500 entries (2^15 \- 256). |
| 446 |
If the number of ligatures plus kerns in a font is higher than that limit, |
| 447 |
\&\fIpltotf\fR and \fIvptovf\fR will complain loudly and ignore the excess entries. |
| 448 |
This happens at least with Adobe\*(Aqs Source Serif 4 and Minion 3 font families. |
| 449 |
Even when \fIpltotf\fR and \fIvptovf\fR don\*(Aqt warn about the LIGTABLE\*(Aqs size, |
| 450 |
you may still find that \fIpdftex\fR crashes with a |
| 451 |
\&\f(CW\*(C`Bad metric (TFM) file\*(C'\fR error. |
| 452 |
The best way to handle this situation is to use \fBautoinst\fR\*(Aqs \f(CW\*(C`\-extra\*(C'\fR option |
| 453 |
to raise \fIotftotfm\fR\*(Aqs value for the \f(CW\*(C`\-\-min\-kern\*(C'\fR parameter, which causes it |
| 454 |
to ignore small kerning pairs: \f(CW\*(C`\-extra=\*(Aq\-\-min\-kern=6.0\*(Aq\*(C'\fR. |
| 455 |
Finding a working value for the \f(CW\*(C`\-\-min\-kern\*(C'\fR parameter may require some |
| 456 |
trial and error. |
| 457 |
.SS "A note for MiKTeX users" |
| 458 |
.IX Subsection "A note for MiKTeX users" |
| 459 |
Automatically installing the fonts into a suitable TEXMF tree |
| 460 |
(as \fBautoinst\fR tries to do by default) only works for TeX\-installations |
| 461 |
that use the \fIkpathsea\fR library; with TeX distributions that implement |
| 462 |
their own directory searching, such as MiKTeX, \fBautoinst\fR will complain |
| 463 |
that it cannot find the \fIkpsewhich\fR program and move all generated files |
| 464 |
into a subdirectory \f(CW\*(C`autoinst_output/\*(C'\fR of the current directory. |
| 465 |
If you use such a TeX distribution, you should either move these files |
| 466 |
to their correct destinations by hand, or use the \fI\-target\fR option |
| 467 |
(see "COMMAND\-LINE OPTIONS" below) to manually specify a TEXMF tree. |
| 468 |
.PP |
| 469 |
Also, some OpenType fonts contain so many kerning pairs that the resulting |
| 470 |
\&\fIpl\fR and \fIvpl\fR files are too big for MiKTeX\*(Aqs \fIpltotf\fR and \fIvptovf\fR; |
| 471 |
the versions that come with W32TeX (\fIhttp://www.w32tex.org\fR) |
| 472 |
and TeXLive (\fIhttp://tug.org/texlive\fR) don\*(Aqt seem to have this problem. |
| 473 |
.SS "A note for MacTeX users" |
| 474 |
.IX Subsection "A note for MacTeX users" |
| 475 |
By default, \fBautoinst\fR will try to install all generated files into |
| 476 |
the \f(CW$TEXMFLOCAL\fR tree; when this directory isn\*(Aqt user\-writable, |
| 477 |
it will use the \f(CW$TEXMFHOME\fR tree instead. Unfortunately, MacTeX\*(Aqs version |
| 478 |
of \f(CW\*(C`updmap\-sys\*(C'\fR doesn\*(Aqt search in \f(CW$TEXMFHOME\fR, |
| 479 |
and hence MacTeX will not find the new fonts. |
| 480 |
.PP |
| 481 |
To remedy this, either run \fBautoinst\fR as root (so that it can install |
| 482 |
everything into \f(CW$TEXMFLOCAL\fR) or manually run \f(CW\*(C`updmap \-user\*(C'\fR to tell |
| 483 |
TeX about the files in \f(CW$TEXMFHOME\fR. |
| 484 |
This latter option does, however, come with some caveats; |
| 485 |
see \fIhttps://tug.org/texlive/scripts\-sys\-user.html\fR. |
| 486 |
.SH "COMMAND\-LINE OPTIONS" |
| 487 |
.IX Header "COMMAND-LINE OPTIONS" |
| 488 |
\&\fBautoinst\fR tries hard to do The Right Thing (TM) by default, |
| 489 |
so you usually won\*(Aqt need these options; |
| 490 |
but most aspects of its operation can be fine\-tuned if you want to. |
| 491 |
.PP |
| 492 |
You may use either one or two dashes before options, |
| 493 |
and option names may be shortened to a unique prefix |
| 494 |
(e.g., \fB\-encoding\fR may be abbreviated to \fB\-enc\fR or even \fB\-en\fR, |
| 495 |
but \fB\-e\fR is ambiguous (it may mean either \fB\-encoding\fR or \fB\-extra\fR)). |
| 496 |
.SS "General options" |
| 497 |
.IX Subsection "General options" |
| 498 |
.IP \fB\-help\fR 4 |
| 499 |
.IX Item "-help" |
| 500 |
Print a (relatively) short help text and exit. |
| 501 |
.IP \fB\-dryrun\fR 4 |
| 502 |
.IX Item "-dryrun" |
| 503 |
Don\*(Aqt generate output; just parse input fonts and write |
| 504 |
the results to the log file. |
| 505 |
.IP \fB\-verbose\fR 4 |
| 506 |
.IX Item "-verbose" |
| 507 |
Add more details to the log file. |
| 508 |
.IP \fB\-version\fR 4 |
| 509 |
.IX Item "-version" |
| 510 |
Print \fBautoinst\fR\*(Aqs version number and exit. |
| 511 |
.SS "Font creation options" |
| 512 |
.IX Subsection "Font creation options" |
| 513 |
.IP \fB\-encoding\fR=\fIencoding[,encoding]\fR 4 |
| 514 |
.IX Item "-encoding=encoding[,encoding]" |
| 515 |
Generate the specified encoding(s) for the text fonts. |
| 516 |
Multiple encodings may be specified as a comma\-separated list |
| 517 |
(without spaces!); the default choice of encodings is \f(CW\*(C`OT1,LY1,T1\*(C'\fR. |
| 518 |
.Sp |
| 519 |
For each encoding argument, \fBautoinst\fR will first check if it is |
| 520 |
the file name of an encoding file, and if found it will use that; |
| 521 |
otherwise the argument is assumed to be the name of one of |
| 522 |
the built\-in encodings. |
| 523 |
If the argument is a file name, |
| 524 |
\&\fBautoinst\fR will define the font with an NFSS encoding |
| 525 |
equal to the file name (minus a ".enc" extension), |
| 526 |
except when the file name starts with "U_"; |
| 527 |
in that case the NFSS encoding will be "U" |
| 528 |
and the part after "U_" will be used as the "enc" part |
| 529 |
of the name of the generated font. |
| 530 |
.Sp |
| 531 |
Currently \fBautoinst\fR comes with built\-in support for the OT1, T1/TS1, LY1, |
| 532 |
T2A/B/C, T3/TS3, T4, T5, LGR, CS, L7X and QX encodings. |
| 533 |
(The corresponding files are called \fIfontools_ot1.enc\fR etc., |
| 534 |
to avoid name clashes with other packages; |
| 535 |
the \fIfontools_\fR prefix may be omitted.) |
| 536 |
.IP \fB\-ts1\fR/\fB\-nots1\fR 4 |
| 537 |
.IX Item "-ts1/-nots1" |
| 538 |
Control the creation of TS1\-encoded fonts. The default is \fB\-ts1\fR |
| 539 |
if the text encodings (see \fI\-encoding\fR above) include T1, |
| 540 |
\&\fB\-nots1\fR otherwise. |
| 541 |
.IP \fB\-lining\fR/\fB\-nolining\fR 4 |
| 542 |
.IX Item "-lining/-nolining" |
| 543 |
Control the creation of fonts with lining figures. The default is |
| 544 |
\&\fB\-lining\fR. |
| 545 |
.IP \fB\-oldstyle\fR/\fB\-nooldstyle\fR 4 |
| 546 |
.IX Item "-oldstyle/-nooldstyle" |
| 547 |
Control the creation of fonts with oldstyle figures. The default is |
| 548 |
\&\fB\-oldstyle\fR. |
| 549 |
.IP \fB\-proportional\fR/\fB\-noproportional\fR 4 |
| 550 |
.IX Item "-proportional/-noproportional" |
| 551 |
Control the creation of fonts with proportional figures. The default is |
| 552 |
\&\fB\-proportional\fR. |
| 553 |
.IP \fB\-tabular\fR/\fB\-notabular\fR 4 |
| 554 |
.IX Item "-tabular/-notabular" |
| 555 |
Control the creation of fonts with tabular figures. The default is |
| 556 |
\&\fB\-tabular\fR. |
| 557 |
.IP \fB\-smallcaps\fR/\fB\-nosmallcaps\fR 4 |
| 558 |
.IX Item "-smallcaps/-nosmallcaps" |
| 559 |
Control the creation of small caps fonts. The default is |
| 560 |
\&\fB\-smallcaps\fR. |
| 561 |
.IP \fB\-swash\fR/\fB\-noswash\fR 4 |
| 562 |
.IX Item "-swash/-noswash" |
| 563 |
Control the creation of swash fonts. The default is \fB\-swash\fR. |
| 564 |
.IP \fB\-titling\fR/\fB\-notitling\fR 4 |
| 565 |
.IX Item "-titling/-notitling" |
| 566 |
Control the creation of titling families. The default is \fB\-titling\fR. |
| 567 |
.IP \fB\-superiors\fR/\fB\-nosuperiors\fR 4 |
| 568 |
.IX Item "-superiors/-nosuperiors" |
| 569 |
Control the creation of fonts with superior characters. |
| 570 |
The default is \fB\-superiors\fR. |
| 571 |
.IP "\fB\-inferiors\fR [ = \fBnone\fR | \fBauto\fR | \fBsubs\fR | \fBsinf\fR | \fBdnom\fR ]" 4 |
| 572 |
.IX Item "-inferiors [ = none | auto | subs | sinf | dnom ]" |
| 573 |
.PD 0 |
| 574 |
.IP \fB\-noinferiors\fR 4 |
| 575 |
.IX Item "-noinferiors" |
| 576 |
.PD |
| 577 |
The OpenType standard defines several kinds of digits that might be used |
| 578 |
as inferiors or subscripts: "Subscripts" (OpenType feature \f(CW\*(C`subs\*(C'\fR), |
| 579 |
"Scientific Inferiors" (\f(CW\*(C`sinf\*(C'\fR), and "Denominators" (\f(CW\*(C`dnom\*(C'\fR). |
| 580 |
This option allows the user to determine which of these styles \fBautoinst\fR |
| 581 |
should use for the inferior characters. |
| 582 |
Alternatively, the value "auto" tells \fBautoinst\fR to use the first value |
| 583 |
in \f(CW\*(C`sinf\*(C'\fR, \f(CW\*(C`subs\*(C'\fR or \f(CW\*(C`dnom\*(C'\fR that is supported by the font. |
| 584 |
Saying just \fB\-inferiors\fR is equivalent to \fB\-inferiors=auto\fR; |
| 585 |
otherwise the default is \fB\-noinferiors\fR. |
| 586 |
.Sp |
| 587 |
\&\fIIf you specify a style of inferiors that isn\*(Aqt present in the font, |
| 588 |
\&\fR\f(BIautoinst\fR\fI will fall back to its default behaviour of not creating fonts |
| 589 |
with inferiors at all; it won\*(Aqt try to substitute one of the other styles.\fR |
| 590 |
.IP \fB\-fractions\fR/\fB\-nofractions\fR 4 |
| 591 |
.IX Item "-fractions/-nofractions" |
| 592 |
Control the creation of fonts with numerators and denominators. |
| 593 |
The default is \fB\-nofractions\fR. |
| 594 |
.IP \fB\-ligatures\fR/\fB\-noligatures\fR 4 |
| 595 |
.IX Item "-ligatures/-noligatures" |
| 596 |
Some fonts contain glyphs for the standard f\-ligatures (ff, fi, fl, ffi, ffl), |
| 597 |
but don\*(Aqt provide a \f(CW\*(C`liga\*(C'\fR feature to access these. |
| 598 |
This option tells \fBautoinst\fR to add extra \f(CW\*(C`LIGKERN\*(C'\fR rules to |
| 599 |
the generated fonts to enable the use of these ligatures. |
| 600 |
The default is \fB\-ligatures\fR, except for typewriter fonts. |
| 601 |
.Sp |
| 602 |
Specify \fB\-noligatures\fR to disable generation of ligatures even for fonts |
| 603 |
that do contain a \f(CW\*(C`liga\*(C'\fR feature. |
| 604 |
.IP \fB\-ornaments\fR/\fB\-noornaments\fR 4 |
| 605 |
.IX Item "-ornaments/-noornaments" |
| 606 |
Control the creation of ornament fonts. The default is \fB\-ornaments\fR. |
| 607 |
.IP \fB\-serif\fR/\fB\-sanserif\fR/\fB\-typewriter\fR 4 |
| 608 |
.IX Item "-serif/-sanserif/-typewriter" |
| 609 |
Install the font as a serif, sanserif or typewriter font, respectively. |
| 610 |
This changes how you access the font in LaTeX: |
| 611 |
with \f(CW\*(C`\ermfamily\*(C'\fR/\f(CW\*(C`\etextrm\*(C'\fR, \f(CW\*(C`\esffamily\*(C'\fR/\f(CW\*(C`\etextsf\*(C'\fR |
| 612 |
or \f(CW\*(C`\ettfamily\*(C'\fR/\f(CW\*(C`\etexttt\*(C'\fR. |
| 613 |
.Sp |
| 614 |
Installing the font as a typewriter font will cause two further changes: |
| 615 |
it will \- by default \- turn off the use of f\-ligatures |
| 616 |
(though this can be overridden with the \fI\-ligatures\fR option), |
| 617 |
and it will disable hyphenation for this font. |
| 618 |
This latter effect cannot be re\-enabled in \fBautoinst\fR; |
| 619 |
if you want typewriter text to be hyphenated, use the \fIhyphenat\fR package. |
| 620 |
.Sp |
| 621 |
If none of these options is specified, \fBautoinst\fR tries to guess: |
| 622 |
if the font\*(Aqs file name contains the string "mono" |
| 623 |
or if the field \f(CW\*(C`isFixedPitch\*(C'\fR in the font\*(Aqs \f(CW\*(C`post\*(C'\fR table is True, |
| 624 |
it will select \fB\-typewriter\fR; |
| 625 |
else if the file name contains "sans" it will select \fB\-sanserif\fR; |
| 626 |
otherwise it will opt for \fB\-serif\fR. |
| 627 |
.IP \fB\-math\fR 4 |
| 628 |
.IX Item "-math" |
| 629 |
Tells \fBautoinst\fR to create basic math fonts (see above). |
| 630 |
.IP \fB\-mathspacing\fR=\fIamount\fR 4 |
| 631 |
.IX Item "-mathspacing=amount" |
| 632 |
Letterspace each character in the math fonts by \fIamount\fR units, |
| 633 |
where 1000 units equal one em. |
| 634 |
In my opinion, many text fonts benefit from letterspacing by 50 to 100 units |
| 635 |
when used in maths; some fonts need even more. Use your own judgement! |
| 636 |
.SS "Output options" |
| 637 |
.IX Subsection "Output options" |
| 638 |
.IP "\fB\-t1suffix\fR [ = \fISUFFIX\fR ]" 4 |
| 639 |
.IX Item "-t1suffix [ = SUFFIX ]" |
| 640 |
Tell \fBautoinst\fR to modify the font names of all generated Type1\-fonts, |
| 641 |
by adding \fISUFFIX\fR to the family name. |
| 642 |
If you use this option without specifying a \fISUFFIX\fR value, |
| 643 |
\&\fBautoinst\fR will use the value "PS". |
| 644 |
The default behaviour when this option is not given |
| 645 |
is to not modify font names at all. |
| 646 |
.Sp |
| 647 |
See also "OpenType fonts and licensing issues" in "WARNINGS AND CAVEATS" above. |
| 648 |
.IP \fB\-target\fR=\fIDIRECTORY\fR 4 |
| 649 |
.IX Item "-target=DIRECTORY" |
| 650 |
Install all generated files into the TEXMF tree at \fIDIRECTORY\fR. |
| 651 |
.Sp |
| 652 |
By default, \fBautoinst\fR searches the \f(CW$TEXMFLOCAL\fR and \f(CW$TEXMFHOME\fR trees |
| 653 |
and installs all files into the first user\-writable TEXMF tree it finds. |
| 654 |
If \fBautoinst\fR cannot find such a user\-writable directory |
| 655 |
(which shouldn\*(Aqt happen, since \f(CW$TEXMFHOME\fR is supposed to be user\-writable) |
| 656 |
it will print a warning message and put all files into the subdirectory |
| 657 |
\&\f(CW\*(C`autoinst_output/\*(C'\fR of the current directory. |
| 658 |
It\*(Aqs then up to the user to move the generated files to a better location |
| 659 |
and update all relevant databases |
| 660 |
(usually by calling \fItexhash\fR and \fIupdmap\fR). |
| 661 |
.IP \fB\-vendor\fR=\fIVENDOR\fR 4 |
| 662 |
.IX Item "-vendor=VENDOR" |
| 663 |
.PD 0 |
| 664 |
.IP \fB\-typeface\fR=\fITYPEFACE\fR 4 |
| 665 |
.IX Item "-typeface=TYPEFACE" |
| 666 |
.PD |
| 667 |
These options are equivalent to \fIotftotfm\fR\*(Aqs \fI \-\-vendor\fR and \fI \-\-typeface\fR |
| 668 |
options: they change the "vendor" and "typeface" parts of the names of the |
| 669 |
subdirectories in the TEXMF tree where generated files will be stored. |
| 670 |
The default values are "lcdftools" and the font\*(Aqs FontFamily name. |
| 671 |
These options change \fIonly\fR directory names, |
| 672 |
not the names of any generated files. |
| 673 |
.IP \fB\-logfile\fR=\fIfilename\fR 4 |
| 674 |
.IX Item "-logfile=filename" |
| 675 |
Write log data to \fIfilename\fR instead of the default \fI<fontfamily>.log\fR. |
| 676 |
If the file already exists, \fBautoinst\fR appends to it; |
| 677 |
it doesn\*(Aqt overwrite an existing file. |
| 678 |
.SS "Specialist options" |
| 679 |
.IX Subsection "Specialist options" |
| 680 |
.IP \fB\-defaultlining\fR/\fB\-defaultoldstyle\fR 4 |
| 681 |
.IX Item "-defaultlining/-defaultoldstyle" |
| 682 |
.PD 0 |
| 683 |
.IP \fB\-defaulttabular\fR/\fB\-defaultproportional\fR 4 |
| 684 |
.IX Item "-defaulttabular/-defaultproportional" |
| 685 |
.PD |
| 686 |
Tell \fBautoinst\fR which figure style is the current font family\*(Aqs default |
| 687 |
(i.e., which figures you get when you don\*(Aqt specify any OpenType features). |
| 688 |
.Sp |
| 689 |
\&\fIDon\*(Aqt use these options unless you are certain you need them!\fR |
| 690 |
They are only needed for fonts that don\*(Aqt provide OpenType features |
| 691 |
for their default figure style; and even in that case, |
| 692 |
\&\fBautoinst\fR\*(Aqs default values (\fB\-defaultlining\fR and \fB\-defaulttabular\fR) |
| 693 |
are usually correct. |
| 694 |
.IP "\fB\-nfssweight\fR=""\fIcode\fR=\fIweight\fR""" 4 |
| 695 |
.IX Item "-nfssweight=""code=weight""" |
| 696 |
.PD 0 |
| 697 |
.IP "\fB\-nfsswidth\fR=""\fIcode\fR=\fIwidth\fR""" 4 |
| 698 |
.IX Item "-nfsswidth=""code=width""" |
| 699 |
.PD |
| 700 |
Map the NFSS code \fIcode\fR to the given weight or width, |
| 701 |
overriding the built\-in tables. |
| 702 |
Each of these options may be given multiple times, |
| 703 |
to override more than one NFSS code. |
| 704 |
Example: to map the \f(CW\*(C`ul\*(C'\fR code to the "Thin" weight, |
| 705 |
use \f(CW\*(C`\-nfssweight="ul=thin"\*(C'\fR. |
| 706 |
To inhibit the use of the \f(CW\*(C`ul\*(C'\fR code completely, |
| 707 |
use \f(CW\*(C`\-nfssweight="ul="\*(C'\fR. |
| 708 |
.IP "\fB\-opticalsizes\fR=""\fIpattern\fR=\fImin\fR\-\fImax\fR [, \fIpattern\fR=\fImin\fR\-\fImax\fR ...]""" 4 |
| 709 |
.IX Item "-opticalsizes=""pattern=min-max [, pattern=min-max ...]""" |
| 710 |
Manually set or override the fonts\*(Aq optical size information. |
| 711 |
If a font\*(Aqs file name matches \fIpattern\fR, its optical size information |
| 712 |
will be set to the range \fImin\fR\-\fImax\fR (both given in points). |
| 713 |
The lower bound \fImin\fR is included in the range, the upper bound \fImax\fR isn\*(Aqt. |
| 714 |
Empty values for \fImin\fR and \fImax\fR are interpreted as zero and infinity, |
| 715 |
respectively. |
| 716 |
Multiple optical size range specifications must be separated by commas. |
| 717 |
.Sp |
| 718 |
Example: |
| 719 |
.Sp |
| 720 |
.Vb 5 |
| 721 |
\& autoinst \e |
| 722 |
\& \-opticalsizes="9pt=0\-25,72pt=25\-100,144pt=100\-" \e |
| 723 |
\& Fraunces9pt\-Regular.otf \e |
| 724 |
\& Fraunces72pt\-Regular.otf \e |
| 725 |
\& Fraunces144pt\-Regular.otf |
| 726 |
.Ve |
| 727 |
.Sp |
| 728 |
The \fIpattern\fR can be any string that is valid in file names |
| 729 |
and LaTeX font names. |
| 730 |
A default size range can be specified with an empty pattern: |
| 731 |
.Sp |
| 732 |
.Vb 1 |
| 733 |
\& \-opticalsize="Capt=\-8.4,=8.4\-13,Subh=13\-19.9,Disp=19.9\-" |
| 734 |
.Ve |
| 735 |
.Sp |
| 736 |
Patterns are tested in descending order of pattern length |
| 737 |
and the first match wins, though \fBautoinst\fR will warn if it finds |
| 738 |
multiple matching patterns (except for the empty pattern). |
| 739 |
.Sp |
| 740 |
If a font\*(Aqs file name does not contain any of the given patterns, |
| 741 |
the optical size data in the font\*(Aqs \f(CW\*(C`OS/2\*(C'\fR table (if any) will be used. |
| 742 |
.Sp |
| 743 |
\&\fBautoinst\fR will adjust size ranges so that there are no gaps; |
| 744 |
e.g. a set of ranges 5\-7, 9\-14 and 18\-72 will be adjusted to |
| 745 |
0\-7, 7\-14 and 14\-infinity. Empty or overlapping ranges are an error. |
| 746 |
.Sp |
| 747 |
In some font families, the optical size name is part of the family name; |
| 748 |
e.g., Fraunces in fact consists of three separate families |
| 749 |
"Fraunces 9pt", "Fraunces 72pt" and "Fraunces 144pt". |
| 750 |
When given the \fI\-opticalsizes\fR option, \fBautoinst\fR will try to remove |
| 751 |
the optical size names (i.e., \fIpattern\fR) from the family name, |
| 752 |
so that all fonts will be installed as a single LaTeX family. |
| 753 |
Note that Literata (and maybe other fonts as well) has file names |
| 754 |
like "Literata_24pt\-Regular.ttf" but family names like "Literata 24pt"; |
| 755 |
in this case the \fIpattern\fR "24pt" will be removed from the family name, |
| 756 |
but the \fIpattern\fR "_24pt" will not, since the underscore doesn\*(Aqt match. |
| 757 |
.Sp |
| 758 |
If the transition size between two fonts with design sizes \fIS\fR and \fIL\fR |
| 759 |
is unknown, sqrt(\fIS\fR * \fIL\fR) might be a good starting value. |
| 760 |
.IP "\fB\-extra\fR=\fIextra options\fR" 4 |
| 761 |
.IX Item "-extra=extra options" |
| 762 |
Pass \fIextra options\fR to the commands for \fIotftotfm\fR. |
| 763 |
To prevent \fIextra options\fR from accidentily being interpreted as |
| 764 |
options to \fBautoinst\fR, they should be properly quoted. |
| 765 |
.IP \fB\-manual\fR 4 |
| 766 |
.IX Item "-manual" |
| 767 |
Manual mode; for users who want to post\-process the generated files |
| 768 |
and commands. By default, \fBautoinst\fR immediately executes all |
| 769 |
\&\fIotftotfm\fR commands it generates; |
| 770 |
in manual mode, these are instead written to a file \fIautoinst.bat\fR. |
| 771 |
Furthermore it tells \fIotftotfm\fR to generate human readable (and editable) |
| 772 |
\&\fIpl/vpl\fR files instead of the default \fItfm/vf\fR ones, |
| 773 |
and to place all generated files in a subdirectory \f(CW\*(C`./autoinst_output/\*(C'\fR |
| 774 |
of the current directory, rather than install them into your TeX installation. |
| 775 |
.Sp |
| 776 |
When using this option, you need to execute the following manual steps after |
| 777 |
\&\fBautoinst\fR has finished: |
| 778 |
.RS 4 |
| 779 |
.IP "\- run \fIpltotf\fR and \fIvptovf\fR on the generated \fIpl\fR and \fIvf\fR files, to convert them to \fItfm/vf\fR format;" 2 |
| 780 |
.IX Item "- run pltotf and vptovf on the generated pl and vf files, to convert them to tfm/vf format;" |
| 781 |
.PD 0 |
| 782 |
.IP "\- move all generated files to a proper TEXMF tree, and, if necessary, update the file name database;" 2 |
| 783 |
.IX Item "- move all generated files to a proper TEXMF tree, and, if necessary, update the file name database;" |
| 784 |
.ie n .IP "\- tell TeX about the new \fImap\fR file (usually by running ""updmap"" or similar)." 2 |
| 785 |
.el .IP "\- tell TeX about the new \fImap\fR file (usually by running \f(CWupdmap\fR or similar)." 2 |
| 786 |
.IX Item "- tell TeX about the new map file (usually by running updmap or similar)." |
| 787 |
.PD |
| 788 |
.RE |
| 789 |
.RS 4 |
| 790 |
.Sp |
| 791 |
Note that some options (\fI\-target\fR, \fI\-vendor\fR and \fI\-typeface\fR) |
| 792 |
are meaningless, and hence ignored, in manual mode. |
| 793 |
.Sp |
| 794 |
Also note that font name modification doesn\*(Aqt happen in manual mode. |
| 795 |
.RE |
| 796 |
.IP \fB\-nofigurekern\fR 4 |
| 797 |
.IX Item "-nofigurekern" |
| 798 |
Some fonts provide kerning pairs for tabular figures. |
| 799 |
This is very probably not what you want |
| 800 |
(e.g., numbers in tables won\*(Aqt line up exactly). |
| 801 |
This option adds extra \fI \-\-ligkern\fR options |
| 802 |
to the commands for \fIotftotfm\fR to suppress such kerns. |
| 803 |
Note that this option leads to very long commands (it adds |
| 804 |
one hundred \fI \-\-ligkern\fR options), which may cause problems on some systems; |
| 805 |
hence it is not active by default. |
| 806 |
.SH "SEE ALSO" |
| 807 |
.IX Header "SEE ALSO" |
| 808 |
Eddie Kohler\*(Aqs \fBTypeTools\fR and \fBT1Utils\fR (\fIhttp://www.lcdf.org/type\fR). |
| 809 |
.PP |
| 810 |
\&\fBPerl\fR can be obtained from \fIhttp://www.perl.org\fR; |
| 811 |
it is included in most Linux distributions. |
| 812 |
For Windows, try ActivePerl (\fIhttp://www.activestate.com\fR) |
| 813 |
or Strawberry Perl (\fIhttp://strawberryperl.com\fR). |
| 814 |
.PP |
| 815 |
\&\fBLuaTeX\fR (\fIhttp://www.luatex.org\fR) and |
| 816 |
\&\fBXeTeX\fR (\fIhttp://www.tug.org/xetex\fR) |
| 817 |
are Unicode\-aware TeX engines that can use OpenType fonts directly, |
| 818 |
without any (La)TeX\-specific support files. |
| 819 |
.PP |
| 820 |
The \fBFontPro\fR project (\fIhttps://github.com/sebschub/FontPro\fR) |
| 821 |
offers very complete LaTeX support (even for typesetting maths) for |
| 822 |
Adobe\*(Aqs Minion Pro, Myriad Pro and Cronos Pro font families. |
| 823 |
.SH AUTHOR |
| 824 |
.IX Header "AUTHOR" |
| 825 |
Marc Penninga (\[email protected]\fR) |
| 826 |
.PP |
| 827 |
When sending a bug report, please give as much relevant information as |
| 828 |
possible; this usually includes (but may not be limited to) the log file |
| 829 |
(please add the \fI\-verbose\fR command\-line option, for extra info). |
| 830 |
If you see any error messages, please include these \fIverbatim\fR; |
| 831 |
don\*(Aqt paraphase. |
| 832 |
.SH COPYRIGHT |
| 833 |
.IX Header "COPYRIGHT" |
| 834 |
Copyright (C) 2005\-2026 Marc Penninga. |
| 835 |
.SH LICENSE |
| 836 |
.IX Header "LICENSE" |
| 837 |
This program is free software; you can redistribute it and/or modify |
| 838 |
it under the terms of the GNU General Public License as published |
| 839 |
by the Free Software Foundation, either version 2 of the License, |
| 840 |
or (at your option) any later version. |
| 841 |
A copy of the text of the GNU General Public License is included in |
| 842 |
the \fIfontools\fR distribution; see the file \fIGPLv2.txt\fR. |
| 843 |
.SH DISCLAIMER |
| 844 |
.IX Header "DISCLAIMER" |
| 845 |
This program is distributed in the hope that it will be useful, |
| 846 |
but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 847 |
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 848 |
GNU General Public License for more details. |
| 849 |
.SH VERSION |
| 850 |
.IX Header "VERSION" |
| 851 |
This document describes \fBautoinst\fR version 20260422. |
| 852 |
.SH "RECENT CHANGES" |
| 853 |
.IX Header "RECENT CHANGES" |
| 854 |
(See the source for the full story, all the way back to 2005.) |
| 855 |
.IP \fI2026\-04\-22\fR 12 |
| 856 |
.IX Item "2026-04-22" |
| 857 |
Several additions and bugfixes (reports and patches by Chris Spiel): |
| 858 |
.RS 12 |
| 859 |
.ie n .IP "\- Added the ""\-opticalsizes"" option" 2 |
| 860 |
.el .IP "\- Added the \f(CW\-opticalsizes\fR option" 2 |
| 861 |
.IX Item "- Added the -opticalsizes option" |
| 862 |
.PD 0 |
| 863 |
.IP "\- Log all weights and widths that could not be mapped to standard NFSS ""series"" codes" 2 |
| 864 |
.IX Item "- Log all weights and widths that could not be mapped to standard NFSS ""series"" codes" |
| 865 |
.IP "\- Bugfix: font names starting with ""ITC"" would be parsed as ""italic""" 2 |
| 866 |
.IX Item "- Bugfix: font names starting with ""ITC"" would be parsed as ""italic""" |
| 867 |
.PD |
| 868 |
.RE |
| 869 |
.RS 12 |
| 870 |
.RE |
| 871 |
.IP \fI2026\-04\-01\fR 12 |
| 872 |
.IX Item "2026-04-01" |
| 873 |
Added the "extlight" weight to the font info parsing |
| 874 |
(reported by Chris Spiel). |
| 875 |
.IP \fI2026\-02\-10\fR 12 |
| 876 |
.IX Item "2026-02-10" |
| 877 |
Generated style files now use the \fIfigureversions\fR package |
| 878 |
to access superior and inferior figures and fractions, |
| 879 |
instead of the (deprecated) \fIfontaxes\fR package. |
| 880 |
Added the \fIscriptscale\fR option to the generated style file. |
| 881 |
When creating math fonts, we use the font\*(Aqs "mgrk" feature, |
| 882 |
if present. |
| 883 |
Fixed a few obscure bugs. |
| 884 |
.IP \fI2025\-09\-09\fR 12 |
| 885 |
.IX Item "2025-09-09" |
| 886 |
Use the font\*(Aqs WeightClass if its weight cannot be determined |
| 887 |
from other metadata (suggested by Christoph L. Spiel). |
| 888 |
.IP \fI2025\-08\-25\fR 12 |
| 889 |
.IX Item "2025-08-25" |
| 890 |
Fixed a bug in the processing of the \f(CW\*(C`\-nfssweight\*(C'\fR and |
| 891 |
\&\f(CW\*(C`\-nfsswidth\*(C'\fR options. |
| 892 |
.IP \fI2025\-08\-19\fR 12 |
| 893 |
.IX Item "2025-08-19" |
| 894 |
Fixed a bug where any fonts with the word "Typewriter" |
| 895 |
in their name would be parsed as "Italic". |
| 896 |
.IP \fI2025\-07\-02\fR 12 |
| 897 |
.IX Item "2025-07-02" |
| 898 |
The hack in font metadata parsing for Source Serif 4 |
| 899 |
(See 2025\-01\-07) is also needed for other fonts; |
| 900 |
at least for Arno Pro, maybe some other Adobe fonts as well. |
| 901 |
So we changed the test again: we apply this hack by default, |
| 902 |
except for Libertinus. |
| 903 |
.IP \fI2025\-06\-23\fR 12 |
| 904 |
.IX Item "2025-06-23" |
| 905 |
Introduced the "U_" rule for encoding file names. |
| 906 |
.IP \fI2025\-04\-16\fR 12 |
| 907 |
.IX Item "2025-04-16" |
| 908 |
Don\*(Aqt load the \fImweights\fR package, as its functionality |
| 909 |
is now part of the LaTeX kernel |
| 910 |
(and, in fact, has been for a while ...). |
| 911 |
.IP \fI2025\-01\-07\fR 12 |
| 912 |
.IX Item "2025-01-07" |
| 913 |
The \*(Aqfix\*(Aq in font metadata parsing that we introduced |
| 914 |
for Source Serif 4 was biting Libertinus Serif Display |
| 915 |
(and maybe other fonts as well), |
| 916 |
so we now test if the family is actually Source Serif 4 |
| 917 |
before applying that fix. |