h1. Setup Instructions

{{toc}}

h2. On Macs

These instructions were developed using a MacBook 13-inch Air Mid 2012 running OS X v 10.10.1.  They include all necessary steps to install and configure MacTex + SageTex + Minted

h3. Setting up LaTeX on Mac for use with SageTex and Minted

# Download and install "MacTex":http://tug.org/mactex/
Be sure to install detected updates for MacTex (instructions used v.3.48)
# Download and install "Sage":http://www.sagemath.org/download-mac.html (instructions used v.6.4.1)
# Configure SageTex (per "sagetextexshop.pdf":http://faculty.essex.edu/~bannon/sp/sagetextexshop.pdf in [[Resources]])
## Rename the Sage Application from /Applications/Sage-<version number>.app to /Applications/Sage.app
Note, in the Finder UI the .app is not shown
## Perform CLI steps
### Open Terminal
### cd ~/Library/TeXShop/Engines/
### cp ./Inactive/Sage/sage.engine ./
### cd /usr/local/texlive/texmf-local/tex/latex
### sudo ln -s /Applications/Sage.app/Contents/Resources/sage/data/texmf/tex/generic/sagetex/sagetex.sty sagetex.sty
### sudo mktexlsr
### Close the terminal
## Install minted
### Looks like minted is already installed with TexShop, but make sure Pygments is installed by running pygmentize from the terminal
### if it works, then proceed to next step; otherwise install with sudo easy_install Pygments
## Update TexShop settings to work with minted (aka, enable —shell-escape)
### Open TexShop Preferences (TexShop>Preferences)
### Select the Engines tab
### add --shell-escape as the first argument of the Tex and Latex settings
### close Preferences
### Edit ~/Library/TeXShop/Engines/sage.engine
### add --shell-escape as the first argument of each call to pdflatex (there are two places in the one on test machine)
### save and close the sage.engine file

h3. Adding Units Support with Pint

# Open Terminal
# /Applications/Sage.app/Contents/Resources/sage/sage --python -m easy_install pint
# Close the terminal

h3. Notes

* Be sure to run applications once by right-clicking and selecting run then approving the application to run (this is part of a security policy in OS X)
* Sage is a very large package, be patient running it for the first time.  It took 10+ minutes (and possibly one or more retries) to get it to run for the first time during initial setup.  After that it ran normally.

h2. On Linux

These instructions were developed using a PC laptop running Ubuntu 14.04 64-bit.

h3. Setting up LaTeX on Linux for use with SageTex and Minted

# Install "kile":http://kile.sourceforge.net/ from the repository
sudo apt-get install kile
# Download and install "Sage":http://www.sagemath.org/download-linux.html (instructions used v.6.4.1)