Introduction à LaTeX

Par le Louvain-li-Nux

Table des matières

1. Introduction
2. Structure générale
3. Composants du corps du document
4. Mise en page
5. Environement spéciaux
6. Bibiliographie
7. Compilation
8. Mathéatiques
9. Autres
10. Crédits

Introduction

Le mot du début

Cette présentation a été crée par le Louvain-li-Nux dans le but de vous faire découvrir le logiel de traitement de texte libre LaTeX.

Quelle que soient les raison qui vous on ammenée à ouvrir ce document vous avez bien fait. Installez vous confortablement et démarons la découverte ensemble.

Qu'est ce que latex

Avant toute choses vous devez savoir ce qu'est LaTeX et ce qu'il permet de faire que les autres logiciels de traitement de texte ne font pas. Voici un apperçu :

• Système de composition de documents de haute qualité (ex. mémoire, raport de projet...)
• Utilisé pour les documents scientifiques et techniques
• Gère les notations complexes (formules mathématique, code, molécules chimiques...)
• Automatisations diverse (table des matières, référencage...)
• Permet de se concentrer sur le contenu, pas la mise en forme
• Libre et open sourece

Le seul inconvénient est que LaTeX nécessite un peu d'apprentissage, mais ne vous inquitez pas à la fin de cette introduciton vous serez tout faire (ou presque).

Exemple de document LaTeX

Un document écrit en LaTeX ça ressemble à ça. C'est peut-être un peu déroutant au début, mais vous allez voir ce n'est pas très compliqué. Vous pouvez voir ce que ça donne en pdf avec le lien plus bas.

\documentclass{article}
\begin{document}
\title{Mon Premier Document LaTeX}
\author{Magali Nux}
\date{\today}
\maketitle

\section{Introduction}
Ceci est un exemple de document LaTeX.

\end{document}

Voir le résultat compilé

Commençons la découverte

Maintenant que vous savez ce qu'est LaTeX et à quoi ça ressemble, il va être temps de commencer à le prendre en main. Cette présentation est conçue pour vous donner toutes le notions nécessiaires à la bonne compréhension et prise en main. La plupart des exemples vus seront déjà compilés pour vous pour que vous puissiez voir dirrectement le résultat. On vous invite cepandant à essayer par vous même de refaire les parties qui vous semblent les plus compliquées. Pour cela, vous pouvez utiliser la plateforme Overleaf, qui est un compilateur LaTeX en linge.

Créer un compte Overleaf

Pour créer un compte Overleaf, rendez-vous sur overleaf.com et cliquez sur "Register" en haut à droite. Remplissez les informations requises et suivez les instructions pour activer votre compte.

Structure générale

Parties du document

Un document LaTeX est composé de trois parties :

1. Le type de document
2. Les packages
3. Le corps du document

Le type du document

Le type du document est défini en premier. C'est là qu'on va définir la forme générale qu'on veut donner au document :

• Le format (A4, A3...)
• La police principale du document (qui peut être modifée par section)
• L'orientation (portait ou paysage)
• Le type de document (article, livre, présentation...)

Exemple

\documentclass[a4paper,landscape]{article} 
% Défini un document de type article, au format A4 et en orientation paysage

Les packages

Les packages sont des additions aux fonctionalités de base de LaTeX qui vont nous permettre de réaliser le document comme on le souhaite.

Voici quelques exemples couramment utilisés :

\usepackage{graphicx} % Permet d'inclure des images

\usepackage{geometry} % Permet de modifier les marges du document

\usepackage{color} % Permet d'utiliser des couleurs dans le texte

On peut modifier les propriétés des packages pour obtenir le résulat que l'on souhaite :

\usepackage[margin=1cm]{geometry} % Défini des marges de 1cm

Corps du document

Dans le corps du document on va retrouver tout le contenu réel (textes, images, graphiques, table des matières...)

Composants du corps du document

Les commandes

Les commandes premettent de définir chacun des coposants du documents ainsi que certaines fonctionalités.

Exemples

\section{Titre de section} % Défini un titre pricipal

\textbf{Texte en gras} % Place une partie du texte en gras

% Inclut une image avec une largeur de 50% du texte
\includegraphics[width=0.5\textwidth]{chemin/vers/image.png} 

\large(Texte en grand) % Agrandi la taille de la police pour une partie du texte

Les environnements (1)

Les environnements définissent un ensemble de composants qui sont liés entre eux et sur lequels on peut, par exemple, appliquer une propriété commune.

Un environnement commence par la commande \begin{nomEnvironnemen} et se terminne par la commande end{nomEnvironnement}.

Exemple

% Environnement définissant une liste non-numérotée
\begin{itemize}
    \item Premier élément de la liste
    \item Deuxième élément de la liste
    \item Troisième élément de la liste
\end{itemize}

Les environnements (2)

Un environnement peut être imbriqué dans un autre environement, il hérite alors
des propriétés de celui-ci.

Exemple

% Premier environnement : centre les composants et environnements qui 
% se trouvent à l'intérieur
\begin{center}
    % Deuxième environnement : affiche une image avec sa légende
    % Cet environnement sera aussi centré
    \begin{figure}
        \includegraphics{mon-image.png}
        \caption{Description de mon image}
        \label{fig:mon-image}
    \end{figure}
\end{center}

Mise en page

Page de garde

La plupart des documents que vous serez amenés à écrire conteindront probablement une page de garde. LaTeX permet de créer une page de garde facilement.

Exemple

\documentclass{article}
% Ici vous définissez les valeurs dont vous avez besoin pour votre titre
\title{Titre du Document}
\author{Auteur1 \and Auteur2} % Les auteurs sont séparés par la commande \and
\date{\today}

\begin{document}
% La commande \maketitle affiche toutes les informations définies plus haut
\maketitle 
\end{document}

Voir le résultat compilé

Résumé

Sur votre page de garde, vous pouvez aussi décider d'ajouter un résumé, décrit ce dont va parler le document. En LaTeX, ceci ce fait de la manière suivante :

% Optionel : change le titre du résumé (par défaut : "Abstract")
\renewcommand{\abstractname}{Nouveau Titre du Résumé}

\begin{abstract}
    Ce document présente un exemple de résumé en LaTeX. Le résumé donne 
    un aperçu général du contenu du document, permettant aux lecteurs 
    de comprendre rapidement les points principaux abordés.
\end{abstract}

Voir le résultat compilé

Titres

Pour dénir des titres on utilise les commandes \section :

\section{Titre principal}

\subsection{Titre de sous-section}

\subsubsection{Titre de sous-sous-section}

Voir le résultat compilé

Table des matière

LaTeX complète automaiquement la table des matières pour le document en fonction des titres définis (voir section précédante).
Pour importer la table des matière, il suffit de placer cette fonction à l'endoit voulu :

% Optionel : change le titre de la table des matière (par défaut : "Contents")
\renewcommand{\contentsname}{Nouveau titre de la table des matières}

% Affiche la table de matière
\tableofcontents

Voir la table des matières générée pour l'exemple précédant

Notes de bas de page

Tout comme la table des matières, les notes de bas de page sont aussi générées automatiqument avec la commande \footnote.

Voici un exemple d'utilisation :

Voici un exemple de texte avec une note de bas de page
\footnote{Ceci est une note de bas de page.}. 
Vous pouvez ajouter autant de notes de bas de page que nécessaire
\footnote{Une autre note de bas de page.}.

Voir le résultat compilé

Style de la police d'écriture

Vous pouvez appliquer des styles à la police d'écriture avec les commandes suivantes :

\textbf{Texte en gras} % Texte en gras

\textit{Texte en italique} % Texte en italique

\underline{Texte souligné} % Texte souligné

\texttt{Texte en police à chasse fixe} % Texte en police à chasse fixe

\textsc{Texte en petites majuscules} % Texte en petites majuscules

\emph{Texte en emphase} % Texte en emphase (souvent italique)

Voir le résultat compilé

Taille de la police d'écriture

Vous pouvez chager la taille de la police d'écriture avec les fonctions suivantes :

\tiny{Texte en très petite taille} % Très petite taille

\scriptsize{Texte en petite taille} % Petite taille

\footnotesize{Texte en taille de note de bas de page} % Taille de note de bas de page

...

\huge{Texte en taille énorme} % Taille énorme

\Huge{Texte en très énorme taille} % Très énorme taille

Voir le résultat compilé

Voir le document .tex complet avec toutes les taille possibles

Alignement

Par défaut, l'alignement en LaTex est justifé. Vous pouvez chager l'alignment d'un paragraphe avec les environnements suivants :

Par défaut, le texte est justifié.

\begin{flushleft}
    Texte aligné à gauche
\end{flushleft}
\begin{center}
    Texte centré
\end{center}
\begin{flushright}
    Texte aligné à droite
\end{flushright}

Voir le résultat compilé

Environements spéciaux

Listes

Pour créer une liste à puce, il faut utiliser l'environnement itemsize :

\begin{itemize}
    \item Un chat
    \item Une poule
    \item Un chien
\end{itemize}

Pour créeer une liste numérotée, il faut utiliser l'environnement enumerate :

\begin{enumerate}
    \item Versez de l'eau dans une casserole.
    \item Faire boullir l'eau.
    \item Ajouter les pâtes dans l'eau bouillante.
\end{enumerate}

Voir le résultat compilé

Afficher une image

Pour ajouter une image, il faut utiliser le package graphicx. On peut ensuite afficher notre image avec la commande \includegraphics. Voici un exemple d'utilisation :

\begin{figure} % Création d'un environnement pour l'image
    \centering % Centre l'image
    \includegraphics{graph.png} % Affichage de l'image
    \caption{Voici un beau graphique} % Ajoute une description pour l'image
    % Référence l'image (pour pouvoir la lier à d'autres parties du document)
    \label{fig:graphique} 
\end{figure}

Voir le résult compilé

Changer la taille d'une image

Voici les options permettant d'ajuster la taille de l'image :

\includegraphics[width=0.7\textwidth]{graph.jpg} % Largeur dépendant du texte

\includegraphics[height=4cm]{graph.jpg} % Hauteur de 4cm

\includegraphics[scale=0.5]{graph.png} % taille de l'image / 2

Voir le résultat compilé

Tableaux (1)

La création de tableaux en LaTeX est assée compliquée. Pour vous illustrer cela, voici un exemple de tableau en LaTeX :

\begin{table} % Création d'un environnement pour le tableau
    \centering % Centre le tableau
    % Crée un nouveau tableau de 2 colones : la première est alignée à gauche (l) et la seconde est alignéé au centre (c)
    \begin {tabular}{|l||c|} 
        \hline % cette commande place une ligne verticale
        \textit{Inventaire} & \textbf{Nombre} \\
        \hline
        Chemises & 4 \\ % Les colones sont séparée par le symbole "&"
        Pulls & 12 \\ % Les lignes sont délimitée par "\\"
        Pantalons & 1 \\
        \hline
    \end{tabular}
    \caption{Tableau relatif a l'inventaire} % Légende du tableau
\end{table}

Voir le résultat compilé

Tableaux (2)

Heusement, il existe des resources qui simplifient la création de tableaux en LaTeX. Voici l'une d'entre elles : https://www.latex-tables.com/. Sur ce sitte vous pourrez créer votre tabeau sous forme visuelle et ensuite générer le code LaTeX correspondant.

Bibliographie

Ajouter une bilibiographie au document

Avec LaTeX, la bibliographie est séparée du reste dans un fichier .bib.

L’utilisation d’une bibliographie requièrent les paquets suivants : {biblatex}[backend=bibtex]et csquotes.

On importe le fichier .bib dans le document via la commande \bibliography{biblio.bib} (dans l’en-tête du document).

On cite un document avec la commande \cite{identifiant}. Cet identifiant est repris dans le fichier .bib. Il est aussi possible d'utiliser la commande noticepour inclure dans la bibliographie un élément qui n'a pas été cité dans le texte

Enfin, l'affichage de la bibliographie à l’endroit souhaité ce fait avec la commande
\printbibliography.

Exemple d'utilisation d'une bibilogrpahie

\documentclass{article}
\usepackage[backend=bibtex]{biblatex}
\usepackage{csquotes}
\addbibresource{biblio.bib} % Importer le fichier .bib

\begin{document}

Voici un exemple de citation \cite{identifiant1}.
Avec aussi un document non-cité, mais inclus dans la bibliographie
\nocite{identifiant2}

\printbibliography % Afficher la bibliographie

\end{document}

Voir le résultat compilé
Voir le fichier .bib

Strucuture d'un fichier .bib

Un fichier bib contient chacune des références à la suite. Voici un exemple de référence :

@inproceedings{ray2017challenges,
title={Challenges of monolithic integration for SiGe MEMS technology},
author={Ray Chaudhuri, Ashesh and Severi, S and Helin, P and Francis,
Laurent and Tilmans, HAC},
booktitle={15th IEEE Sensors Conference, SENSORS 2016},
year={2017}
}

ray2017challenges est l'identifiant de la référence. Il faudra l'utiliser pour citer l'article.

Ajouter une référence

Pour ajouter une référence dans votre fichier .bib le plus simple est d'utiliser Google Scholar ou un autre site de référencement.

Voici des exemple de sites de référencement :

• Google Scholar
• PubMed
• IEEE Xplore
• ACM Digital Library
• SpringerLink
• ScienceDirect

Style de bibiliographie

Le style est défini lors de l’appel du paquet \usepackage[style=ieee]{biblatex}

Les différents styles sont :

1. apa, American Psychological Association ;
2. chicago-authordate, Chicago Style ;
3. ieee, Institute of Electrical and Electronics Engineers (IEEE).

Pour plus de style de bibliographie, voir https://www.overleaf.com/learn/latex/Biblatex_citation_styles et Google.

Compilation

Séparer un projet en fichier

Vous l'avez remarqué une projet en LaTeX contient au moins un fichier principal avec le contenu en LaTeX (.tex), ainsi que souvent des fichiers annexes : images (.png, .jpg...).

Dès que le projet devient un peu gros, il faut souvent assez longtemps pour compiler. Pour éviter cela, il est utile de diviser son document en plusieurs fichier .tex (dont un pricipal qui contiendra les référence aux autres).

De cette manière, vous ne pouvez travailler que sur une certaine partie de votre travail (section, thème...) à la fois avant de tout combiner en un document.

Importer un fichier .tex

Pour importer un fichier .tex il faut utiliser la commande input.

\begin{document}

\input{page-de-garde.tex}
\input{introduction.tex}
... 

\end{document}

Compiler un projet LaTeX

Depuis le début de cette présentation nous utilisons Overleaf pour compiler nos documents. Cepandant, la version gratuite d'Overleaf possède quelques inconvéniants (impossible de partager l'éditions à plus de deux personne, limitation dans la tailel du projet...).

Pour éviter ces inconvéniants, il existe des solutions :

• Souscrire à la version pro d'Overleaf
• Compiler un projet localement (voir prochaine section)
• Si vous êtes étudiant à l'EPL, utiliser la version d'Overleaf hébergée sur les serveurs Ingi : https://overleaf.info.ucl.ac.be/project
• ... (d'autres solutions existent mais ne seront pas abordées ici).

Compiler un projet localement sur Linux ou macOS

Pour compiler un projet LaTeX localement sur Linux ou macOS, suivez ces étapes :

sudo apt-get install texlive-full # Installer LaTeX (Debian/Ubuntu)
brew install mactex # Installer LaTeX (macOS)

cd /chemin/vers/votre/projet # Aller au dossier contenant le projet

pdflatex document-principal.tex # Compiler le projet en pdf

# Si nécessaire : compiler la bibliographie, puis recompiler le projet
bibtex document-principal 
pdflatex document-principal.tex # Si référence croisée: recompiler un deuxième fois

Vous aurez maintement accès au fichier .pdf compilé et vous verrez aussi tous les fichiers auxiliaires générés par la compilation (vous pouvez les ingoner).

Compiler un projet localement sur Windows

1. Installer linux : https://wiki.louvainlinux.org/fr/install_linux/introduction
2. Suivre les instruction pour compiler sur Linux.

Mathématiques

Equations simples

Pour écrire une équation en LaTeX, placez la entre deux symbole $ :

x + 1 = 2

Les opérateurs de base (+, -, /, ^ et _) sont définis normalement. Il existe aussi beacoup de commandes représentatant des opérations, symboles et fonctions mathématiques (frac, sin, lim, beta...). Les packages amsmath et amssymb apportent beacoup d'autres syboles et opérations supplémentaires.

$a^{11}$
$\sin(x)$
$\frac{\Theta}{\sqrt{\beta}}$

Voir le résultat compilé

Equation centrée

Il est possible de définir un bloc d'équation centré sur la page avec la notation \[ \].

Exemple

L'expression $\sin(x)$ peut s'écrire de différents manières.
En effet, il a été démontré que
\[
    \sin(x) =
    \frac{e^{ix} - e^{-ix}}{2i}
\]
avec $i$ étant l'unité imaginaire.

Voir le résultat compilé

Matrices

Les matrices sont définies avec l'environnement matrix. Cet envirronement est décliné en plusieurs forme en fonction des délimiteurs que l'on veut (par défaut il n'y en a pas).

vmatrix : |    |             bmatrix : [    ]             pmatrix : (    )
Vmatrix : ‖    ‖             Bmatrix : {    }

\usepackage{amsmath}

\[
    \begin{pmatrix}
        a + b & c \\
        d & e + f \\
    \end{pmatrix}
\]

Voir le résultat compilé

Délimiteurs

Pour obtenir des délimiteurs qui s'adaptent à la taile de se qui se trouve à l'intérieur, il faut utilsier les commande left et right suivi du délimitueru choisi : (), []...

Exemple

\[ \left( \frac{x^2}{y^3} \right) \]

\[ \left\{ \frac{x^2}{y^3} \right\} \]

\[ \left[ \frac{x^2}{y^3} \right] \]

Voir le résultat compilé

Equation numérotées

Les environnements equation et align (définis dans asmmath) permettent de numéroter des équations. En plus de la numérotation, align aligne les équations autour du signe =. L'environnement align* aligne les équations sans les numéroter. La commande \nonumber à la fin d'une équation fait en sorte qu'elle ne soit pas numérotée.

\begin{equation} % Equations numérotées
    c^2 = a^2 + b^2 
\end{equation}
\begin{align} % Equations alignées et numérotées
    e^{i\pi} + 1 & = 0\\
    f(t) & = A\cos(\omega t + \phi) \nonumber % Cette équation ne sera pas numérotée
\end{align}
\begin{align*} % Equation numérotées
    1 + 1 & = 2\\
    2 + 3 & = 5
\end{align*}

Voir le résultat compilé

Système d'équations

Pour créer un système d'équation, on peut utiliser les commande left et right avec comme délimiteur {.

Notez qu'il faut utiliser l'evironement aligned et non aling.

\[\left\{
    \begin{aligned}
        x^2 + y &= 3 \\
        \frac{y}{x} &= 0.42
    \end{aligned}
\right.\]

Voir le résultat compilé

Noms de variables et ensemble

Pour définir des noms de variable comprenant plus d'une lettre vous pouvez utiliser la commande mathrm.

\usepackage{amsmath}

$\mathrm{Var}(x)$
$F_\mathrm{machine}$

Les ensemble s'écrivenet avec le fonction mathbb.

\usepackage{amssymb}

$\mathbb{N}$
$\mathbb{Q}$

Voir le résultat compilé

Opérateurs

Voici quelques exemples d'opérateurs courrant en LaTeX :

$\min_{x \in \mathbb{R}} f(x)$ % Minimum d'une fonction

$\lim_{x \to \infty} \frac{1}{x} = 0$ % Limite d'une fonction

$\sum_{i=1}^{n} i = \frac{n(n+1)}{2}$ % Somme d'une série

% Version alternative avec les bornes au-dessus et en-dessous du signe somme
$\overset{n}{\underset{i=1}\sum} = \frac{n(n+1)}{2}$ 

$\prod_{i=1}^{n} i = n!$ % Produit d'une série

Voir le résultat compilé

Autres

Informatique

Pour inclure du code le plus simple est d'utiliser le package minted. Si vous utilisez Overleaf vous ne devez rien faire de plus. Pour compiler en local, vous devez installer le package python Pygments et utiliser le flag -shell-escape lorsque vous compilez.

\begin{minted}{python} % Placer le langage comme seconde option (ici : python)
    def dummy_function(count):
        i = 0
        while i < count:
            print("Affiche du code de façon simple")
\end{minted}

Voir le résultat compilé

Chimie

Pour inclure des graphiques molculaires dans votre document vous pouvez utiliser le package chemfig :

\usepackage{chemfig}

\chemfig{*6(-=(-CH_2OH)-(-COOH)=-=)}

Pour des équations moléculaires, utilisez le package mhchem :

\usepackage[version=3]{mhchem}

\ce{3H2O + 1/2H2O -> AgCl2- + H2_{(aq)}}

Voir le résultat compilé

Electricité

Le package circuitikz permet de représenter des shémas électriques :

\usepackage{circuitikz}

\begin{circuitikz}
    \draw (0,0) to [sI, v=$V_2$] (0,-3);
    \draw (6,-3) to[short, i = $I_2$] (0,-3);
    \draw (0,0) to [R = R, v = $V_R$] (3,0);
    \draw (3,0) to [L = L, v = $V_L$] (6,0);
    \draw (6,0) to [C = C, v = $V_C$] (6,-3);
\end{circuitikz}

Voir le résultat compilé

Dessiner des shémas

Le package tikz permet de dessiner des schémas :

\usepackage{tikz}
\usetikzlibrary{shapes, positioning}

\begin{tikzpicture}[node distance=2.3cm, auto]
    \node (start) [circle, draw] {Start};
    \node (process1) [right of=start, rectangle, draw] {Process 1};
    ...
    \draw[->] (process2a) -| (process1);
    \draw[->] (process2b) -- (end);
\end{tikzpicture}

Voir le résultat compilé
Voir le fichier .tex complet

Utiliser des packages

Pour terminer cette introduction à LaTeX, sachez qu'il existe pas mal de templates que vous pouvez utiliser pour créer vos documents. Voici une liste d'endroits où les télécharger :

• https://www.latextemplates.com
• https://www.overleaf.com/latex/templates
• https://www.ctan.org/topic/doc-temp

Crédits

Le mot de la fin

Merci d'avoir suivit cette introduction à LaTeX. On espère qu'elle vous sera utile et que vous êtes maintenant près à créer de magnifiques documents professionels !

N'hésitez pas à la partager si c'est le cas, et à nous contacter si vous avez plus de questions. Vous trouverez tout nos réseaux sur notre site : louvainlinux.org.

Contributeurs

Nouvelle version

Pierre-Yves Haubruge

Ancienne version

Jolan Wolter, Thomas Vanzieleghem, David Ernst, Matthieu Baerts, Arnaud Cerckel, Benoît Legat, Mattéo Couplet, Geoffroy Jacquet, Xavier Lambein, Sébastien de Longueville, Gaëtan Cassiers, Louis Arys, Arnaud Couplet, Morgane Leclerc, Martin Vandenbussche, Nicolas Jeanmenne, Guillaume van der Rest, Adrien Giot, Vincent Higginson