AUTOINST(1) Marc Penninga AUTOINST(1) NAME autoinst - wrapper around the LCDF TypeTools, for installing and using OpenType fonts in LaTeX. SYNOPSIS autoinst -help autoinst [options] font(s) DESCRIPTION Eddie Kohler's LCDF TypeTools are superb tools for installing OpenType fonts in LaTeX, but they can be hard to use: they need many, often long, command lines and don't generate the fd and sty files LaTeX needs. autoinst simplifies the use of the TypeTools for font installation by generating and executing all commands for otftotfm, and by creating and installing all necessary fd and sty files. Given a family of font files (in otf or ttf format), autoinst will create several LaTeX font families: - Four text families (with lining and oldstyle digits, each in both tabular and proportional variants), all with the following shapes: n Roman (i.e., upright) text it, sl Italic and slanted (sometimes called oblique) text sc Small caps scit, scsl Italic and slanted small caps sw Swash nw "Upright swash" - For each T1-encoded text family: a family of TS1-encoded symbol fonts, in roman, italic and slanted shapes. - Families with superiors, inferiors, numerators and denominators, in roman, italic and slanted shapes. - Families with "Titling" characters; these "... replace the default glyphs with corresponding forms designed specifically for titling. These may be all-capital and/or larger on the body, and adjusted for viewing at larger sizes" (according to the OpenType Specification). - An ornament family; also in roman, italic and slanted shapes. Of course, if your fonts don't contain italics, oldstyle digits, small caps etc., the corresponding shapes and families are not created. In addition, the creation of most families and shapes can be controlled by the user (see "COMMAND-LINE OPTIONS" below). These families use the FontPro project's naming scheme: -, where is: LF proportional (i.e., figures have varying widths) lining figures TLF tabular (i.e., all figures have the same width) lining figures OsF proportional oldstyle figures TOsF tabular oldstyle figures Sup superior characters (note that most fonts have only an incomplete set of superior characters: digits, some punctuation and the letters abdeilmnorst; normal forms are used for other characters) Inf inferior characters; usually only digits and some punctuation, normal forms for other characters Titl Titling characters; see above Orn ornaments Numr, Dnom numerators and denominators The individual fonts are named ---, where is the same as above (but in lowercase), is either empty, "sc" or "swash", and is the encoding (also in lowercase). A typical name in this scheme would be FiraSans-Light-osf-sc-ly1. Using the fonts in your LaTeX documents autoinst generates a style file for using the fonts in LaTeX documents, named .sty. This style file also loads the fontenc and textcomp packages, if necessary. To use the fonts, add the command "\usepackage{}" to the preamble of your document. This style file has a few options: "mainfont" Redefine "\familydefault" to make this font the main font for the document. This is a no-op if the font is installed as a serif font; but if the font is installed as a sanserif or typewriter font, this option saves you from having to redefine "\familydefault" yourself. "lining", "oldstyle", "tabular", "proportional" Choose which figure style to use. The defaults are "oldstyle" and "proportional" (if available). "scale=", "scale=MatchLowercase" Scale the font by ; as an example, "\usepackage[scale=1.05]{}" will increase the font's size by 5%. The special value "MatchLowercase" may be used to scale the font so that its x-height matches that of the current main font (which is usually Computer Modern Roman, unless you have loaded another font package before this one). The word "scale" may also be spelled as "scaled". "medium", "book", "text", "normal", "regular" Select the weight that LaTeX will use as the "regular" weight. "heavy", "black", "extrabold", "demibold", "semibold", "bold" Select the weight that LaTeX will use as the "bold" weight. The last two groups of options will only work if you have the mweights package installed. The default here is not to change LaTeX's default, i.e. use the "m" and "b" weights. The style file will also try to load the fontaxes package (on CTAN), which gives easy access to various font shapes and styles. Using the machinery set up by fontaxes, the generated style file defines a number of commands (which take the text to be typeset as argument) and declarations (which don't take arguments, but affect all text up to the end of the current group) to access titling, superior and inferior characters: DECLARATION COMMAND SHORT FORM OF COMMAND \tlshape \texttitling \texttl \supfigures \textsuperior \textsup, \textsu \inffigures \textinferior \textinf, \textin In addition, the existing "\swshape" and "\textsw" commands are redefined to place swash on fontaxes' secondary shape axis (fontaxes places it on the primary shape axis) to make them behave properly when nested, so that "\swshape\upshape" will give upright swash. Finally, the style file redefines Latex's "\textsuperscript" and "\textsubscript" commands to use the fonts' superior and inferior figures, and modifies Latex's footnote mechanism to use "\textsuperscript" instead of reduced-size numerals from the regular text font. The old versions of these commands are still available as "\textsuperscript*" and "\textsubscript*". There are no commands for accessing the numerator and denominator fonts; these can be selected using fontaxes' standard commands, e.g., "\fontfigurestyle{numerator}\selectfont". Once again: all these commands are only generated for existing shapes and number styles; no commands are generated for shapes and styles that are missing from your fonts. Note that all these commands are built on top of fontaxes; if that package cannot be found, you're limited to using lower-level commands from standard NFSS ("\fontfamily", "\fontseries", "\fontshape" etc.). By default, autoinst generates text fonts with OT1, LY1 and T1 encodings, and the generated style files use T1 as the default text encoding. Other encodings can be chosen using the -encoding option (see "COMMAND-LINE OPTIONS" below). Maths This is an experimental feature; USE AT YOUR OWN RISK! Test the results thoroughly before using them in real documents, and be warned that future versions of autoinst may introduce incompatible changes. The -math option tells autoinst to generate basic math fonts. When enabled, the generated style file defines a few extra options to access these math fonts: "math" Use these fonts for the maths in your document. "mathlining", "matholdstyle", "mathtabular", "mathproportional" Choose which figure style and alignment to use in maths. The defaults are "mathlining" and "mathtabular". "mathcal" Use the swash characters from these fonts as the "\mathcal" alphabet. (This option will only exist if your fonts actually contain both swash characters and a "swsh" feature to access them). "nomathgreek" Don't redeclare greek letters in math. "math-style=