# Installing lsst-texmf¶

You can get the LSST LaTeX classes and style files from GitHub:

git clone https://github.com/lsst/lsst-texmf


To enable LaTeX to find the style files the TEXMFHOME environment variable can be set to the texmf subdirectory. For example, the following can be used if you are in the directory from which you cloned the repository:

export TEXMFHOME=pwd/lsst-texmf/texmf


A single texmf directory can be reused for multiple documents, or else, it is possible to have separate texmf directories for each document, having the environment variable set by a make file. A particularly useful way of doing the latter is to install lsst-texmf as a git submodule. To do this, execute this within your document’s repository:

git submodule add https://github.com/lsst/lsst-texmf


Add and commit as usual. Later, when making a fresh clone of the repository, users will have to execute this within the repository:

git submodule init
git submodule update


If you do not want to override this environment setting but wish to have the files always available you can move the entire texmf tree to the default home location which can be found using:

kpsewhich -var-value TEXMFHOME


which on a Mac reports ~/Library/texmf.

Once this environment variable is set, xelatex and pdflatex will find the relevant files automatically.

Note

xelatex is the modern version of pdflatex that has support for more modern native fonts and Unicode. The lsstdoc.cls class and the LSST-beamer.sty adjust correctly when xelatex is being used. More information on xelatex can be found at https://en.wikipedia.org/wiki/XeTeX. Consider using xelatex for all documents. Use the -xelatex option for the latexmk command, rather than -pdf.