TREX Reports latex template

• Installation
  • List of required LaTex Packages
• Manual
  • Initialization
  • Meta-data
  • Title Page
  • The main document
  • Versioning
  • Abbreviations

Installation

To use this template, create a new GitHub repository by using this one as a template.

Make sure that both the draft and final branches are imported by checking the box when you create your repository.

In your new repository, start working on the draft branch. When you submit the pdf for review, create a pull request to the final branch from the draft branch.

The reviewers can then use the GitHub code-review system to make reviews of the document. When all the reviews are accepted, the pull request is accepted to the final branch.

When the versions of the file are changed, be sure that you create a git tag accordingly.

List of required LaTex Packages

• lastpage
• graphicx
• fancyhdr
• amsmath
• amssymb
• titlesec
• colortbl
• acronym
• tocloft
• hyperref
• xcolor
• xparse

Manual

Initialization

Edit the Makefile and provide:

• the Work Package (WP) number
• the NUMBER of the deliverable
• a TITLE

Create the main file with the adapted name:

make create

This will create a file named D$(WP).$(NUMBER)-$(TITLE).tex, which will be the main \LaTeX file.

Now, you can compile the example provided using

make

The output pdf file will contain a starting example of the report.

Meta-data

Open the main tex file (D$(WP).$(NUMBER)-$(TITLE).tex), and fill in the macros in the prepared block. This information will be re-used in multiple places in the document.

Title Page

Search for the string TODO in the 01-title.tex file. You will need to change the \Dissemination macro according to the chosen dissemination level. Default is PU.

You will also need to check the appropriate box of the front page. Use $\boxtimes$ for the checked box and $\Box$ for the empty boxes.

The main document

The main text of your report will be written in the 05-content.tex file.

The references can be handled with bibtex in the references.bib file.

The appendices should be written in the appendix.tex file.

The images and figures should be put in the images directory.

Versioning

When the version changes, please create a git tag associated with the commit containing the change.

Abbreviations

Every time you use an abbreviation, don't do it inline in the text. We use the acronym \LaTeX package which allows to define the acronym the 1st time it occurs in the text, and to create automatically a list of acronyms, keeping only the ones that were used in the text.

To add a new acronym, add it in the 04-abbreviations.tex file. For example:

\acro{QMC}{Quantum Monte Carlo}

and to use it in the text, use the \ac macro, for example

Thanks to the \ac{TREX} \ac{CoE}, \ac{QMC} methods will produce amazing results.