This provides three LaTeX packages using the Solarized theme with the LaTeX listings package for code listings. It just defines Solarized color codes and provides two packages, solarized-light and solarized-dark, for changing the colors of the listings.

First off, fork and clone (or simply clone) the repository:

# If you forked:
$ git clone https://github.com/<your-username>/latex-solarized.git

# If you didn't
$ git clone https://github.com/jez/latex-solarized.git

This is entirely up to you, but I like to keep all my LaTeX files in one place, a folder called ~/programming/LaTeX/, so I'd clone into this folder. You should choose a location that make sense to you.

Next up, we need to tell LaTeX where it can find the files we just cloned. Normally, the process would be to copy these files into a specific folder for LaTeX. However, this has a couple disadvantages, most notably that it makes updating a pain. Instead, we're going to symlink these files into place. If you've never heard about symlinks, you may want to read up about them, and checkout man ln (the man page for the command used to create links).

LaTeX package files need to be placed in a machine-dependent location in order for them to be usable with \usepackage{}. This location varies, but you can use the command kpsewhich -var-value=TEXMFHOME to figure out what the root folder is for your machine. If this command didn't work, you might have a non-standard installation of LaTeX. Check here for more help.

Within the folder returned by kpeswhich, you'll need to create the folder tex/latex/, and then create the links with ln -s <path-to-your-clone>/*sty tex/latex/.

Note: the following example uses a) the path where I personally installed latex-solarized, and b) the command tree which just lists directory contents. This command might not be available, but it's not necessary.

Now you're all set! You should be able include \usepackage{solarized-light} or \usepackage{solarized-dark} to start using Solarized colors with your LaTeX code listings. You might also want to read up on LaTeX code listings here and here.

There are some examples in the examples/ folder.

When using the dark theme, if the line spacing isn't quite right, you will get thin lines of from the page background showing between the lines of the listing. There are some solutions outlined here, but none were easily incorporated into this package.

MIT License. See LICENSE.