A LaTeX template for HES-SO//Master Computer Science Deepening Project (PA)
Authors:
- Sylvain Julmy sylvain.julmy@master.hes-so.ch
- Marc Demierre marc.demierre@master.hes-so.ch
- Nice title page with school logos and lab info
- Header and footer with lab information
- Code highlighting with minted
- Nice default typography settings (by default the template uses lmodern fonts, but you can easily change the fonts in the preamble if needed)
- A recent LaTeX distribution
- Biblatex with biber backend
- Python 2.7+ or 3+ and pygments (for the minted code highlighting package)
-
Install a LaTeX distribution, like MacTex (https://tug.org/mactex/). Make sure the bin directory is in your
PATH
. -
Upgrade your LaTeX distribution. With MacTex, this can be done using the built-in "TeXLive Utility" software.
-
Python is provided by default on OSX (we recommend using homebrew to get the latest version though), you just need to install the pygments package:
pip install pygments
-
Install a LaTeX distribution, like MiKTeX (http://miktex.org/). Make sure the bin directory is in your
PATH
. -
Install the biber package
-
Install Python from https://www.python.org/downloads/windows/. Be sure to check the PATH option in the installer.
-
Install the pygments package
pip install pygments
If you use Linux, you're used to not having precise instructions. Just do it!
More seriously, the only pain point is probably the old package versions if you use an inferior distribution whose repository has an old version of TeXLive. We recommend to install TexLive manually in this case, or to use Arch.
For Archlinux :
yaourt -S texlive-bin
yaourt -S texlive-core
yaourt -S texlive-latexextra
yaourt -S texlive-bibtexextra
For Ubuntu 12.04+ users, this repository might be useful:
https://github.com/scottkosty/install-tl-ubuntu/
- Install the dependencies (see previous section)
- Clone this repository, go to the directory where you want to create a report and use the
getreport.py
script to generate it. - Write your report
- Build the PDF (see below)
A Makefile is provided so you can just use make
to build the PDF. A make clean
command will delete all the pdflatex build files exept the pdf and the make clean_all
will delete all of them.
Use this configuration for the quick build:
pdflatex -shell-escape -synctex=1 -interaction=nonstopmode %.tex|pdflatex -shell-escape -synctex=1 -interaction=nonstopmode %.tex
Do not hesitate to make a pull request if you have useful additions/corrections for this template. You can also post an issue if you find a bug or want to suggest an improvement.
The followin contributions would be welcome:
- Separation in several files (WIP):
preamble.tex
: package imports and configuration- (done)
report.tex
: title page and content