Debian Codegraph @

texmf-dist/doc/latex/microtype/README.md

raw
1
2 The `microtype` package
3 =======================
4
5 **Subliminal refinements towards typographical perfection**
6
7 (v3.2d -- 2026/03/01)
8
9
10 Overview
11 --------
12
13 The `microtype` package provides a LaTeX interface to the micro-typographic
14 extensions that were introduced by pdfTeX and some of which have since also
15 propagated to LuaTeX and XeTeX: most prominently, character protrusion and
16 font expansion, furthermore the adjustment of interword spacing and additional
17 kerning, as well as hyphenatable letterspacing (tracking) and the possibility
18 to disable all or selected ligatures.
19
20 These features may be applied to customisable sets of fonts, and all
21 micro-typographic aspects of the fonts can be configured in a straight-forward
22 and flexible way. Settings for various fonts are provided.
23
24 *Note that character protrusion requires pdfTeX (version 0.14f or later),
25 LuaTeX, or XeTeX (at least version 0.9997). Font expansion works with pdfTeX
26 (version 1.20 for automatic expansion) or LuaTeX. The package will by default
27 enable protrusion and expansion if they can safely be assumed to work.
28 Disabling ligatures requires pdfTeX (at least version 1.30) or LuaTeX, while
29 the adjustment of interword spacing and of kerning only works with pdfTeX
30 (at least 1.40). Letterspacing is available with pdfTeX (1.40), LuaTeX (0.62)
31 or XeTeX.*
32
33 The alternative package `letterspace`, which also works with plain TeX,
34 provides the user commands for letterspacing only, omitting support for all
35 other extensions.
36
37 The documentation can be found in `microtype.pdf` (User manual) and
38 `microtype-code.pdf` (Implementation).
39
40
41 Installation
42 ------------
43
44 To install the package, use one of the following methods
45 (in decreasing order of simplicity):
46
47 - Use the package manager of your TeX system
48 (TeXLive: `tlmgr install microtype`;
49 MiKTeX: MiKTeX Package Manager).
50
51 - Download `microtype.tds.zip` from CTAN,
52 extract it in the root of one of your TDS trees,
53 and update the filename database.
54
55 - Get the source (`microtype.zip`) from CTAN and extract it,
56 run `latex` on `microtype.ins` to generate the package and configuration files,
57 and move all generated files into a directory where LaTeX will find them,
58 e.g., `TEXMF/tex/latex/microtype/`.
59
60 - To use the latest development version, clone the github repository at
61 `https://github.com/schlcht/microtype` and run `make`
62 (or just `latex microtype.ins` to generate the run files).
63
64
65 License
66 -------
67
68 This work may be distributed and/or modified under the conditions of the
69 LaTeX Project Public License, either version 1.3c of this license or (at
70 your option) any later version. The latest version of this license is in:
71 https://www.latex-project.org/lppl.txt, and version 1.3c or later is part
72 of all distributions of LaTeX version 2005/12/01 or later.
73
74 This work has the LPPL maintenance status 'maintained'.
75
76 This work consists of the files `microtype.dtx`, `microtype-utf.dtx` and
77 `microtype.ins` and the derived files `microtype.sty`, `microtype-pdftex.def`,
78 `microtype-luatex.def`, `microtype-xetex.def`, `microtype.lua`, `letterspace.sty`
79 and `microtype-show.sty`.
80
81 Modified versions of the configuration files (`*.cfg`) may be distributed
82 provided that: (1) the original copyright statement is not removed, and
83 (2) the identification string is changed.
84
85 ------------------------------------------------------
86 Copyright (c) 2004--2026 R Schlicht `<[email protected]>`