TeX Live

TeX Live includes the tex(1) and pdftex(1) programs, the LaTeX and ConTeXt TeX macro packages and the XeTeX and LuaTeX TeX engines.

According to Wikipedia:

TeX Live is a free software distribution for the TeX typesetting system that includes major TeX-related programs, macro packages, and fonts.

Installation

• The texlive-most group contains most TeX Live packages.
  • texlive-core, the essential package, based on the medium upstream install scheme (all other packages are based on the upstream collections). The package includes pacman hooks to automate mktexlsr, fmtutil and updmap.
  • texlive-bin contains the binaries and libraries (it is a dependency of texlive-core).
  • contains many useful packages, such as polyglossia, and .
• The group contains packages providing character sets and features for languages with non-Latin characters.
  • texlive-langextra provides language support for African, Arabic, Armenian, Croatian, Hebrew, Indic, Mongolian, Tibetan and Vietnamese languages.
• texlive-bibtexextra contains additional BibTeX and BibLaTeX styles and bibliography databases.
• contains additional fonts, which can be viewed on the LaTeX Font Catalogue.
• provides an alternative bibliography processing backend for BibLaTeX.
• meta-package that provides all the dependencies needed to actually use latexindent.

To determine which CTAN packages are included in each texlive- package, look up the files .

tllocalmgr

The tllocalmgr utility, provided by , lets you install (and update) packages from CTAN as pacman packages. See its usage () for details.

tlmgr

The tlmgr utility is the standard way of installing and updating packages from CTAN. It requires minor fixes as follows:

First, edit TEXMFDIST/scripts/texlive/tlmgr.pl and replace with . The path prefix TEXMFDIST is not a predefined environment variable, it is defined below in this article. Replace it with the correct value.

Create an alias for the perl script (which you can add in your shell's init file).

alias tlmgr='TEXMFDIST/scripts/texlive/tlmgr.pl --usermode'

Now you can initialize it in user mode (which will use as install prefix):

$ tlmgr init-usertree

Set your preferred mirror, for example:

$ tlmgr option repository http://mirrors.rit.edu/CTAN/systems/texlive/tlnet

Now you can install CTAN packages as usual:

$ tlmgr install package_name

Package documentation

The packages in the official repositories do not contain the documentation or source files of font/macro packages.

For offline access with you can either install the whole TeX Live documentation and source files with or install documentation of specific packages with tllocalmgr.

You can also access the documentation online at:

• https://tug.org/texlive/Contents/live/doc.html
• https://ctan.org/ – the cen­tral place for all kinds of ma­te­rial around TeX
• https://texdoc.net/ ( directly yields the relevant PDF)

Manual installation

Alternatively you can install TeX Live with the upstream installer, which is packaged as . For more information, see the LaTeX Wikibook and the TeX Live Guide.

Usage

See the following resources:

• Wikibooks:LaTeX
• The Not So Short In­tro­duc­tion to LaTeX 2ε
• Getting to Grips with LaTeX – Andrew Roberts
• The TeX FAQ

texmf trees and Kpathsea

texmf trees (texmf stands for TeX and Metafont) should follow the TeX Directory Structure, or files may not be found.

TeX Live uses the Kpathsea library to lookup paths by filename across multiple texmf trees and the current working directory.

Kpathsea searches the following variables in the reverse order (later trees override earlier ones).

Variables	Arch default ^1)	Used by
TEXMFDIST		files of the original distribution
	/usr/local/share/texmf:/usr/share/texmf	administrators for system-wide installation of additional or updated macros, fonts, etc.
		updmap and fmtutil (user mode) to store (cached) runtime data
		updmap and fmtutil (user mode) to store modified configuration data
		users for their own individual installations of additional or updated macros, fonts, etc.
		updmap and fmtutil (sys mode) to store (cached) runtime data
TEXMFCONFIG		updmap and fmtutil (sys mode) to store modified configuration data
		ConTeXt MkIV and LuaLaTeX to store (cached) runtime data

Kpathsea provides the kpsewhich(1) command to lookup paths. When run with the argument it can also print the values of variables.

Kpathsea uses filename databases () to speed up searches in system-wide texmf trees (configured with the variable). This means that when system-wide file trees are changed, or texhash (a symlink) need to be run as root. Fortunately the texlive-core automates this with a pacman hook targeting all default system-wide texmf trees but . So as long as you install system-wide packages via pacman you should not need to run mktexlsr or texhash at all.

Important information

• The ConTeXt formats (for Mark II and IV) are not automatically generated upon installation. See the ConTeXT wiki for instructions on how to do this.
• TeX Live (upstream) now provides a tool for incremental updates of CTAN packages. On that basis, we also plan to update our packages on a regular basis (we have written tools that almost automate that task).
• The way to handle font mappings for was improved in September 2009, and installation should now be much more reliable than in the past. In the meantime, if you encounter error messages about unavailable map files, simply remove them by hand from the file (ideally using ). You can also run to automatically comment out outdated map lines from the configuration file.

Tips and tricks

Changing default paper size

It is currently impossible to set the default page size using the texlive tools, because they do not work with the standard Arch package.

Usually, you would run or tlmgr, which are also capable of changing other useful settings.

You can edit the configuration files as follows.

• To set the paper size for the pdftex family of commands (pdftex, pdflatex, etc) edit file.

which can also be discovered by running . Change the two lines that specify the and . For example, to use letter size, change

\pdfpageheight = 297 true mm
\pdfpagewidth  = 210 true mm

to

\pdfpageheight = 11 true in
\pdfpagewidth  = 8.5 true in

Unfortunately, this will not have any effect until the binary .fmt files are rebuilt. You can do this with . Re-installing texlive-bin with pacman will also do this for you.

• For dvips, you can use the option to specify the paper size: . To change the default, edit file.

which can also be discovered with kpsewhich config.ps. The end of this file has sections that list all the paper sizes that dvips knows about. The first listed paper size will be the default. Just move the one that you want to be the default to the top of the list. The behavior of dvips will be affected as soon as the file file is changed.

Making fonts available to Fontconfig

By default, the fonts that come with the various TeX Live packages are not automatically available to Fontconfig. If you want to use them with, say XeTeX or LibreOffice, the easiest approach is to make symlink the font directory to a subdirectory in your user's font path. Run the following for an OpenType font:

$ ln -s /usr/share/texmf-dist/fonts/opentype/public/some_fonts_you_want ~/font_path/OTF/

To make them available to fontconfig, run:

$ fc-cache ~/font_path
$ mkfontscale ~/font_path/OTF
$ mkfontdir ~/font_path/OTF

Similar steps follow for TrueType fonts and Type 1 fonts. In the lines above, substitute with or type1 and substitute with or .

Alternatively, texlive-core contains the file that contains a list of the font directories used by TeX Live. You can use this file with:

And then update fontconfig:

Updating babelbib language definitions

If you have the very specific problem of babelbib not having the latest language definitions that you need, and you do not want to recompile everything, you can get them manually from https://www.tug.org/texlive/devsrc/Master/texmf-dist/tex/latex/babelbib/ and put them in . For example:

Afterwards, you need to run texhash to update the TeX database:

# texhash

Troubleshooting

Error with "formats not generated" upon update

See . (Note that if you do not use the experimental engine LuaTeX, you can ignore this.) This situation typically occurs when the configuration files language.def and/or for hyphenation patterns contain references to files from earlier releases of texlive-core, in particular to the latest experimental hyphenation patterns for German, whose file name changes frequently. Currently they should point to .

To solve this, you need to either remove these files: or update them using the newest version under: and then run

# fmtutil-sys --missing

Getting tlmgr working with texliveonfly

The easiest way to get tlmgr working with texliveonfly is to make a script tlmgr in your (instead of making it an alias) containing:

#!/bin/sh
/usr/share/texmf-dist/scripts/texlive/tlmgr.pl --usermode "$@"

This is because textliveonfly is a Python script which cannot handle aliases.

Alternatives

Alternatives to TeX Live include MikTex and Tectonic, they come with a minimal install, downloading the necessary packages on the go.

See also

• TeX Live documentation
• The TeX Live Guide (not completely applicable)
• TeX - LaTeX Stack Exchange
• Detexify LaTeX handwritten symbol recognition