Introduces latexmkrc and moves files to subdir

.gitignore

@@ -49,6 +49,7 @@
 ## Build tool directories for auxiliary files
 # latexrun
 latex.out/
+build/
 
 ## Auxiliary and intermediate files from other packages:
 # algorithms

.gitlab-ci.yml

@@ -3,11 +3,11 @@ image: collaborating.tuhh.de:5005/e-4/utilities/docker-images/ci-latex
 build:
   stage: build
   script:
-    - latexmk -pdf demo_tuhh_presentation
+    - latexmk
   environment:
     name: demo_tuhh_presentation/$CI_COMMIT_REF_NAME
     url: $CI_PROJECT_URL/-/jobs/$CI_JOB_ID/artifacts/raw/demo_tuhh_presentation.pdf
   artifacts:
     paths:
-      - demo_tuhh_presentation.pdf
+      - build/demo_tuhh_presentation.pdf
 

README.md

 # The (unofficial) TUHH LaTeX Beamer Presentation Template Project
 The Hamburg University of Technology launched a new Brand Identity on 17.11.2021.  
-To unify the visual representation of the TUHH, a style guide, Powerpoint templates and additional materials were designed.  
-As LaTeX is still in heavy use for scientific typesetting and document creation, this project aims to translate the available Powerpoint templates to an equivalent Beamer class.  
+To unify the visual representation of the TUHH, a style guide, PowerPoint templates and additional materials were designed.  
+As LaTeX is still in heavy use for scientific typesetting and document creation, this project aims to translate the available PowerPoint templates to an equivalent Beamer class.  
 It has to be noted, that this project is conducted in a purely complementary nature.  
 Furthermore, LaTeX and in particular Beamer templates are complex, convoluted and delicate pieces of code.  
 Since we do not have any professional background in LaTeX template design, bugs, inconsistencies and errors might very well occur.
 
-Over the course of this project, we strive to implement all Powerpoint template features, improve consistency and fix reported template errors.  
+Over the course of this project, we strive to implement all PowerPoint template features, improve consistency and fix reported template errors.  
 However, even at this early stage, we are confident that the provided document class is able to typeset TUHH-styled presentations.   
 If you'd like to contribute, feel free to contact us, open issues, or implement features and create merge request.  
 
@@ -17,6 +17,8 @@ If you'd like to contribute, feel free to contact us, open issues, or implement
 2. Use `demo_tuhh_presentation.tex` as a starting point
 3. Adapt meta-data such as `\date`, `\author`, `\institute`, `\telephonenumber`
 4. Add your own slides
+5. Run latexmk in the root folder and it will do the job
+6. Run latexmk -c if you want to cleanup the build folder or generate the output files from scratch.
 
 
 # What you can expect:

latexmkrc

+# PDF-generating modes are:
+# 1: pdflatex, as specified by $pdflatex variable (still largely in use)
+# 2: postscript conversion, as specified by the $ps2pdf variable (useless)
+# 3: dvi conversion, as specified by the $dvipdf variable (useless)
+# 4: lualatex, as specified by the $lualatex variable (best)
+# 5: xelatex, as specified by the $xelatex variable (second best)
+$pdf_mode = 1;
+
+ensure_path('TEXINPUTS', './.style//');
+# [...] Other options goes here.
+# $pdf_update_method = 3;
+
+# --shell-escape option (execution of code outside of latex) is required for the
+#'svg' package.
+# It converts raw SVG files to the PDF+PDF_TEX combo using InkScape.
+$lualatex = "lualatex --shell-escape -interaction=nonstopmode --enable-write18";
+$pdflatex = "pdflatex --shell-escape -interaction=nonstopmode --enable-write18";
+
+$postscript_mode = $dvi_mode = 0;
+$bibtex_use = 2;    # use biber
+$out_dir = 'build'; # output files to folder