From CommunityData
Jump to: navigation, search

Installing Dependencies[edit]

Debian/Ubuntu Installation Instructions[edit]

First, you'll want to install the following packages:

  • rubber
  • latexmk
  • texlive-latex-recommended
  • texlive-latex-extra
  • texlive-fonts-extra
  • texlive-fonts-recommended
  • texlive-bibtex-extra
  • moreutils
  • gawk

Also, to install Garamond grab and install the font from here through the following complicated process:

  • Download the file
  • Create ~/texmf if it does not exist yet
  • Unzip the file from the file into that ~/texmf/
  • Copy the other font files in the root directory of into ~/texmf/fonts/type1/
  • Run "texhash ~/texmf

Alternatively, if you want to install them system wide and have root credentials, you can also place them in /usr/local/share/texmf instead.

Using MacTeX on OSX[edit]

To install with MacTeX, you need to install the font:

texlua install-getnonfreefonts
sudo getnonfreefonts-sys garamond

Getting/Installing Templates[edit]

You can find the latest version of Mako's templates here:

To clone the public repository, you can do:

git clone git://

If you can clone them into the directory ~/tex/ (e.g., by doing mkdir ~/tex; cd ~/tex before running the clone command above) it will make things a bit easier.

If you want, you can copy the files new_tex_document new_tex_letter into your path (e.g., ~/bin) this will allow you to run new_tex_document documentname to create new documents from the template more easily. It's totally optional.

Using the Templates[edit]

The templates themselves use the LaTeX Memoir Class (warning that link is a ~1000 page PDF and the documentation). There are three styles that come with it and two basic layouts that are defined. To switch between them, you just edit the following line:


The first style article-1 is the most conservative. article-2 is great for papers (a perhaps dated example). The third style article-3 is more for shorter pieces and memos (a perhaps dated example). If you want to use the style, you might want to consider switching the pagestyle from mako-mem to memo by editing the following line:


Sending Patches[edit]

If you want to send patches, these currently should be sent over email to mako. Details on how to do this with the git format-patch command are online here: