/trex_D1.3

Deliverable D1.3

Primary LanguageTeXCreative Commons Zero v1.0 UniversalCC0-1.0

TREX Reports latex template

Installation

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

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.

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.