init

.gitignore

+main.*
+!main.tex
+__EXTERNAL_ASSETS__
+
+build
+*.zip
+
+*.png
\ No newline at end of file

.gitlab-ci.yml

+image: blang/latex
+
+building-latex-master:
+  stage: build
+  script:
+    - apt-get update --yes
+    - apt-get install imagemagick --yes
+    - apt-get install wget --yes
+    - bash build.sh get_assets
+    - bash build.sh make
+  artifacts:
+    paths:
+      - main.pdf
+      - latex-rapport-UTC.zip
+      - main-0.png
+      - main-1.png
+      
+    expire_in: 2 year
+  only:
+    - master
+  tags:
+    - docker
+
+
+building-latex-other-branch:
+  stage: build
+  script:
+    - apt-get update --yes
+    - apt-get install imagemagick --yes
+    - apt-get install wget --yes
+    - bash build.sh get_assets
+    - bash build.sh make
+  artifacts:
+    paths:
+      - main.pdf
+      - latex-rapport-UTC.zip
+      - main-0.png
+      - main-1.png
+      
+    expire_in: 2 week
+  except:
+    - master
+  tags:
+    - docker
\ No newline at end of file

.latexmkrc

+$latex = 'latex  -shell-escape';
+$pdflatex = 'pdflatex -shell-escape';
+

LICENSE

+BSD 2-Clause License
+
+Copyright (c) 2018, LaTeX-UTC
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
\ No newline at end of file

README.md

+Template LaTeX : rapport simple au format UTC
+=====
+
+- [Utilisation](#utilisation)
+- [Licence](#licence)
+- [Prévisualisation](#pr%C3%A9visualisation)
+- [Contribution](#contribution)
+
+
+## Utilisation
+
+:warning: **Pour une utilisation simple, ne téléchargez pas le _repo_ !** Téléchargez l'archive prête à être utilisée : [ici](/../builds/artifacts/master/raw/latex-rapport-UTC.zip?job=building-latex-master) ! :warning:
+
+🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝🔝
+
+💡 Cette archive peut être directement utilisée sur [Overleaf](https://www.overleaf.com/). :seedling:
+
+_Elle est systématiquement préparée en intégration continue à chaque commit ; si les liens venaient à périmer, n'hésitez pas à demander un renouvellement._
+
+
+## Licence
+
+Le contenu de ce _repo_ est distribué sous licence BSD-2. _Attention l'archive dont nous parlons au-dessus contient des éléments graphiques de [ce repo](https://gitlab.utc.fr/LaTeX-UTC/Graphismes-UTC) dont certains sont de la propriété de l'université de technologie de Compiègne. Plus d'informations sont disponibles sur le repo en question._
+
+
+
+## Prévisualisation 
+
+![Première page](/../builds/artifacts/master/raw/main-0.png?job=building-latex-master)
+
+
+![Deuxième page](/../builds/artifacts/master/raw/main-1.png?job=building-latex-master)
+
+
+[Lien vers le `PDF` généré](/../builds/artifacts/master/raw/main.pdf?job=building-latex-master).
+
+
+## Contribution
+
+Toute contribution est la bienvenue.
+
+Remarque : Ce projet fait un usage important de l'intégration continue. Des _assets_ d'autres projets sont récupérés lors de la compilation. Pour travailler en local, vous devez utilisez le script bash `build.sh` avec l'une des options suivantes :
+- `bash build.sh get_assets` : pour récupérer les assets extérieurs au repo.
+- `bash build.sh make` : pour compiler et générer l'archive.
+- `bash build.sh clean` : pour nettoyer le contenu du dossier de travail de tous les fichiers temporaires.
\ No newline at end of file

build.sh

+#!/bin/bash
+ 
+case "$1" in
+ 
+get_assets) echo "récupérération des assets"
+
+    # Création du dossier des assets externes s'il le faut
+    rm -rf __EXTERNAL_ASSETS__
+    mkdir __EXTERNAL_ASSETS__
+    cd ./__EXTERNAL_ASSETS__
+
+    # Récupération des assets
+
+    a="https://gitlab.utc.fr/LaTeX-UTC/Graphismes-UTC/raw/master/logos/UTC/logo_UTC.pdf "
+    b="https://gitlab.utc.fr/LaTeX-UTC/Graphismes-UTC/raw/master/logos/sigle_UTC/sigle_UTC.pdf "
+
+    for url in $a$b
+    do 
+    wget $url
+    if [[ $? -ne 0 ]]; then
+        echo "Erreure lors de la récupération des assets !"
+        echo "Problème de connexion ou les assets ont été déplassés !"    
+        exit 1; 
+    fi
+    done
+
+    cd ../
+
+    echo "Tous les assets extérieurs nécesssaires sont opérationnels."
+    ;;
+ 
+
+make) echo "Génération de l'archive"
+    rm -rf build;
+    mkdir build; 
+
+    cp report-UTC.cls ./build
+    cp main.tex ./build
+    cp -r src ./build
+    cp LICENSE ./build
+    cp README.md ./build
+    cp -r __EXTERNAL_ASSETS__ ./build
+    cp .gitignore ./build 
+    cp .latexmkrc ./build 
+
+    # copy for building
+    cp -rf ./build ./build_tmp
+
+    # try to build
+    cd ./build_tmp
+    latexmk -pdf main.tex
+
+    # if successfull
+    cd ../
+    cp build_tmp/main.pdf ./
+
+    rm -rf ./build_tmp
+    zip -r latex-rapport-UTC.zip ./build
+
+    # generate preview
+    convert -density 150 main.pdf -quality 90 main.png
+;;
+ 
+clean) echo "Nettoyage"
+    latexmk -C
+    rm -rf build __EXTERNAL_ASSETS__ *.png *.zip
+;;
+
+*) echo "Option $1 non reconnu"; exit 1;;
+ 
+esac
\ No newline at end of file

main.tex

+\documentclass{report-UTC}
+
+\title{UVXX : compte-rendu TP X} 
+\author{XXXXXX XXXXX et XXXXX XXXXX}
+
+
+\begin{document}
+\subfile{src/titlePage}
+
+\subfile{src/content}
+
+\[ \star \quad \star \quad \star \]
+\end{document}
\ No newline at end of file

report-UTC.cls

+\ProvidesClass{report-UTC}
+
+\LoadClass[a4paper,12pt,openright]{report}
+
+\usepackage[francais]{babel} % Package babel pour le français
+\usepackage[T1]{fontenc}    % Package pour les accentuations
+\usepackage[utf8]{inputenc}  % Français
+\usepackage{subfiles}
+\usepackage{titling}
+\usepackage{textcomp}
+\usepackage{lmodern}        % Pour avoir de bonnes polices en pdf
+\usepackage{graphicx}       % Indispensable pour les figures
+\usepackage{amsmath}        % Environnement pour les maths, permet du mettre du texte dans les équations
+\usepackage[headheight=61pt]{geometry}       % Utilisé pour les marges
+\usepackage{multicol}		% Pour les colonnes
+\usepackage{mathtools}  % Typographie pour les ensembles communs
+\usepackage{amssymb}    % Typographie pour les ensembles communs
+\usepackage{float}          % Pour bien placer les figures, scripts et tableaux
+\usepackage{xspace}         % for including spaces at the end of latex macros
+\usepackage{todonotes}
+\usepackage{xcolor}
+\usepackage{enumitem} %For custom itemize
+\usepackage{tikz}			%Pour les figures et graphes
+\usetikzlibrary{calc}		%Pour les figures et graphes
+\usepackage[cache=false]{minted}        % Utilisé pour les scripts
+\geometry{vmargin=3cm, textwidth=16cm} % Réglages des marges
+\usepackage{fancyhdr}		% Pour l'entête et les pieds de page
+\pagestyle{fancy}			% Pour l'entête et les pieds de page
+\usepackage[pagebackref]{hyperref}		% Pour les liens hypertext, sommaire et références
+\usepackage{url}            % For quickly inserting links
+\usepackage[final]{pdfpages} % Pour inclure des .pdf
+\usepackage[linesnumbered,ruled,vlined]{algorithm2e} % for cool loonking algorithm
+
+\renewcommand{\listoflistingscaption}{Liste des programmes} %Pour changer le titre de la liste des codes
+\renewcommand{\listingscaption}{Programme} %Pour changer la légende des codes
+
+\renewcommand{\headrulewidth}{0.5pt}
+  \lhead{\textsc{\leftmark }}
+  \chead{\includegraphics[height=1.5cm]{./__EXTERNAL_ASSETS__/sigle_UTC.pdf}}
+\rhead{ }  
+\cfoot{\thepage}
+
+\newenvironment{myabstract}{%
+\begin{quote} \begin{center}
+ \bf}
+{\end{center}
+ \end{quote}}
+
+

src/content.tex

+\chapter{Un chapitre}
+
+\section{Une section}
+
+\subsection{Une sous-section}
+
+\todo[inline]{Il serait bien d'inclure un peu plus d'exemples.}
\ No newline at end of file

src/titlePage.tex

+\thispagestyle{empty}
+
+\begin{figure}[H]
+\centering
+\includegraphics[height=3cm]{./__EXTERNAL_ASSETS__/logo_UTC.pdf}
+\end{figure}
+
+\vspace{3cm}
+
+\begin{center}
+\Huge{\textbf{\thetitle}} \\
+\vspace{0.5cm}
+\Large{\theauthor} \\
+\small{(Groupe XX)}\\
+\Large{\today}
+\end{center}
+ 
+\vspace{3cm}
+
+\begin{myabstract}
+Ce document synthétise le travail et la réflexion sur le TD de XXX ...
+\end{myabstract}
+
+\clearpage