README.md

LaTeX Styles

This repository contains LaTeX styles I find useful to write scientific papers along with common customizations. Everything here is built upon exsiting styles and packages found in most LaTeX suites (e.g., the excellent TeXLive distribution.) The basic style files must be downloaded from the publishers' website and placed somewhere where LaTeX can find them.

Installing

• If you don't want to read the two bullets below, simply run install.sh.

• Set the environment variable LATEX_STYLES to point to the top of this repository. E.g., if you cloned this repository to /some/dir/latex-styles then export LATEX_STYLES=/some/dir/latex-styles.

• Add $LATEX_STYLES to your $TEXINPUTS, $BIBINPUTS and $BSTINPUTS to ensure LaTeX will find the style and bibliography files:

  export TEXINPUTS=.:$LATEX_STYLES/styles//:$TEXINPUTS
  export BSTINPUTS=.:$LATEX_STYLES/styles/common::
  export BIBINPUTS=.:$LATEX_STYLES/share::

  Note the double slash symbols and double colons.

Basic Styles

• SIAM is the Society for Industrial and Applied Mathematics. The LaTeX style files for their journals may be downloaded from www.siam.org/journals/auth-info.php. The zip file contains all that is required. The main cls file is already included in $LATEX_STYLES/styles/siampaper.

• AMS is the American Mathematical Society. The style files for their journals is found in most LaTeX distributions. The class I use is amsart.

• LNCS is a style used for Springer's Lecture Notes on Computer Science collection. The LaTeX files may be downloaded from https://www.springer.com/gb/computer-science/lncs/conference-proceedings-guidelines. The file llncs2e.zip contains all that is required.

• Springer is the style used for journals such as Mathematical Programming and Mathematical Programming Computation. The LaTeX files may be downloaded from https://media.springer.com/full/springer-instructions-for-authors-assets/zip/468198_LaTeX_DL_468198_240419.zip. The main svjour3.cls is already included in $LATEX_STYLES/styles/springerpaper.

Editor Setup

Please see the wiki for instructions on how to set up your environment for an awesome LaTeX experience, including how to set up popular editors.

Customizations

The styles offer a number of standard customizations that I find useful across almost all scientific papers I write. Those include basic packages such as graphicx, tikz and others but also the following:

• the ability to add a table of contents, which is not supported by all styles by default (at least not without serious conflicts), and which I find very useful while writing the paper

• the inclusion of the todonotes package along with the ability to add a list of todo items, which is not supported by all styles either

• a few commands to produce boxed lemmas, theorems and corollaries so as to make them stand out. Some style files seem to go to great lengths to make lemmas, theorems and corollaries blend in so much with the text that you almost can't see them

• integration with git.

Some choices have been made that may not be to everybody's taste but that fit my needs and preferences best. Among them:

• the bibliography style is always natbib's abbrvnat style. Thus we never use \cite but only \citep and \citet. See the natbib reference sheet.

GitHub Actions

In order for GitHub Actions to work properly, set the following permissions in your repository's settings, under Actions > General:

• Check Action permissions > Allow all actions and reusable workflows.
• Check Workflow permissions > Read and write permissions.
• Check Allow GitHub Actions to create and approve pull requests.