Direc­tory macros/latex/contrib/microtype

README.md

The microtype pack­age

Sublim­i­nal re­fine­ments to­wards ty­po­graph­i­cal per­fec­tion

(v2.7b – 2019/02/28)

Overview

The microtype pack­age pro­vides a LaTeX in­ter­face to the mi­cro-ty­po­graphic ex­ten­sions that were in­tro­duced by pdfTeX and have since also prop­a­gated to LuaTeX and XeTeX: most promi­nently, char­ac­ter pro­tru­sion and font ex­pan­sion, fur­ther­more the ad­just­ment of in­ter­word spac­ing and ad­di­tional kern­ing, as well as hy­phen­at­able let­terspac­ing (track­ing) and the pos­si­bil­ity to dis­able all or se­lected lig­a­tures.

Th­ese fea­tures may be ap­plied to cus­tomis­able sets of fonts, and all mi­cro-ty­po­graphic as­pects of the fonts can be con­fig­ured in a straight-for­ward and flex­i­ble way. Set­tings for var­i­ous fonts are pro­vided.

Note that char­ac­ter pro­tru­sion re­quires pdfTeX (ver­sion 0.14f or later), LuaTeX, or XeTeX (at least ver­sion 0.9997). Font ex­pan­sion works with pdfTeX (ver­sion 1.20 for au­to­matic ex­pan­sion) or LuaTeX. The pack­age will by de­fault en­able pro­tru­sion and ex­pan­sion if they can safely be as­sumed to work. Dis­abling lig­a­tures re­quires pdfTeX (at least ver­sion 1.30) or LuaTeX, while the ad­just­ment of in­ter­word spac­ing and of kern­ing only works with pdfTeX (at least 1.40). Let­terspac­ing is avail­able with pdfTeX (1.40) or LuaTeX (0.62).

The al­ter­na­tive pack­age letterspace, which also works with plain TeX, pro­vides the user com­mands for let­terspac­ing only, omit­ting sup­port for all other ex­ten­sions.

The doc­u­men­ta­tion can be found in microtype.pdf.

In­stal­la­tion

To in­stall the pack­age, use one of the fol­low­ing meth­ods (in de­creas­ing or­der of sim­plic­ity):

Down­load microtype.tds.zip from CTAN, ex­tract it in the root of one of your TDS trees, and up­date the file­name database.

Get the source (microtype.zip) from CTAN and ex­tract it, run latex on microtype.ins to gen­er­ate the pack­age and con­fig­u­ra­tion files, and move all gen­er­ated files into a di­rec­tory where LaTeX will find them, e.g., TEXMF/tex/latex/microtype/.

Li­cense

This work may be dis­tributed and/or mod­i­fied un­der the con­di­tions of the LaTeX Project Public Li­cense, ei­ther ver­sion 1.3c of this li­cense or (at your op­tion) any later ver­sion. The lat­est ver­sion of this li­cense is in: http://www.la­tex-project.org/lppl.txt, and ver­sion 1.3c or later is part of all dis­tri­bu­tions of LaTeX ver­sion 2005/12/01 or later.

This work has the LPPL main­te­nance sta­tus 'au­thor-main­tained'.

This work con­sists of the files microtype.dtx and microtype.ins and the de­rived files microtype.sty, microtype-pdftex.def, microtype-luatex.def, microtype-xetex.def, microtype.lua and letterspace.sty.

Mod­i­fied ver­sions of the con­fig­u­ra­tion files (*.cfg) may be dis­tributed pro­vided that: (1) the orig­i­nal copy­right state­ment is not re­moved, and (2) the iden­ti­fi­ca­tion string is changed.

The pack­age pro­vides a LaTeX in­ter­face to the mi­cro-ty­po­graphic
ex­ten­sions that were in­tro­duced by pdfTeX and have since also prop­a­gated
to XeTeX and LuaTeX: most promi­nently, char­ac­ter pro­tru­sion and font
ex­pan­sion, fur­ther­more the ad­just­ment of in­ter­word spac­ing and
ad­di­tional kern­ing, as well as hy­phen­at­able let­terspac­ing (track­ing)
and the pos­si­bil­ity to dis­able all or se­lected lig­a­tures.

Th­ese fea­tures may be ap­plied to cus­tomis­able sets of fonts, and all
mi­cro-ty­po­graphic as­pects of the fonts can be con­fig­ured in a
straight-for­ward and flex­i­ble way. Set­tings for var­i­ous fonts are pro­vided.

Note that char­ac­ter pro­tru­sion re­quires pdfTeX, LuaTeX, or XeTeX.
Font ex­pan­sion works with pdfTeX or LuaTeX. The pack­age will by de­fault
en­able pro­tru­sion and ex­pan­sion if they can safely be as­sumed to work.
Dis­abling lig­a­tures re­quires pdfTeX or LuaTeX, while the ad­just­ment of
in­ter­word spac­ing and of kern­ing only works with pdfTeX. Let­terspac­ing
is avail­able with pdfTeX or LuaTeX.

The al­ter­na­tive pack­age `let­terspace', which also works with plain TeX,
pro­vides the user com­mands for let­terspac­ing only, omit­ting sup­port for all
other ex­ten­sions.