<figure><img src="image_1.png" /></figure>

HAL
open science

# Introduction par la pratique à LATEX pour les sciences historiques. Manuel de formation à destination des chercheurs et étudiants

Valentin De Craene, Valentin Mériaux

► To cite this version:

Valentin De Craene, Valentin Mériaux. Introduction par la pratique à LATEX pour les sciences historiques. Manuel de formation à destination des chercheurs et étudiants. Master. Université de Lille, France. 2025. hal-05059653

HAL Id: hal-05059653

https://hal.science/hal-05059653v1

Submitted on 7 May 2025

HAL is a multi-disciplinary open access
archive for the deposit and dissemination of sci-
entific research documents, whether they are pub-
lished or not. The documents may come from
teaching and research institutions in France or
abroad, or from public or private research centers.

L'archive ouverte pluridisciplinaire HAL, est
destinée au dépôt et à la diffusion de documents
scientifiques de niveau recherche, publiés ou non,
émanant des établissements d'enseignement et de
recherche français ou étrangers, des laboratoires
publics ou privés.

<figure><img src="image_2.png" /></figure>

Distributed under a Creative Commons Attribution 4.0 International License
Introduction par la pratique à
L'ATEXpour les sciences historiques.
Manuel de formation à destination des
chercheurs et étudiants

Valentin de Craene<fnref n="1" /> et Valentin Mériaux<fnref n="2" />

Date de dernière mise à jour :
7 mai 2025

<footnote n="1">1. Ingénieur d'études en humanités numériques - chargé du traitement des données scientifiques - MESH/S/CNRS (UAR 3185). ORCID : 0000-0002-6019-2572</footnote>

<footnote n="2">2. Doctorant en histoire - IRHiS (UMR 8529). ORCID : 0009-0004-7969-9009</footnote>
<figure><img src="image_3.png" /></figure>
# Avant-propos

Ce document est issu du cours d'introduction à LATEX donné pour les étudiantes et étudiants du master « Histoire Européenne » de l'université de Lille durant l'année universitaire 2024-2025. Il se présente comme un mo-deste manuel regroupant l'ensemble des commandes et environnements appris en cours, ainsi que quelques focus complémentaires sur les bonnes pratiques de balisage et gestion d'un projet. Il a vocation à être lu et exploré au sein d'un éditeur LATEXafin de pouvoir comprendre le code associé, tel qu'Overleaf.
Nous recommandons donc aux lecteurs de se munir du code disponible dans ce repository :

https://gitlab.huma-num.fr/vdecraene/manuel-latex-masters-histoire

Ce manuel numérique n'a nullement vocation à se substituer à la lecture consciencieuse de la documentation LATEXou à d'autres travaux plus complets (voir bibliographie). Il se présente simplement comme une approche du langage LATEX« par la pratique », pour un public d'historiens non spécialistes de l'édition numérique ou de l'encodage des textes.

Le présent document et le cours associé se fondent en grande partie sur une formation assurée par les auteurs, Valentin de Craene (ingénieur en humanités numériques - MESHS), Valentin Mériaux (doctorant en histoire à l'Institut de Recherches Historiques du Septentrion - IRHiS) et Ada Chmilevschi (ingénieure de la Plateforme Universitaire des Données de Lille - PUDL) en juin 2024 pour le public des chercheurs associés à la Maison Européenne des Sciences de l'Homme et de la Société (MESHS).
# Chapitre 1

# Commandes typographiques et gestion des envrionnements

## 1.1 Écrire en LATEX

Un document LATEX se présente en deux parties majeures : le préambule du texte et le texte lui-même. Le préambule sert à la déclaration de toutes les informations nécessaires au logiciel pour interpréter le texte qui suit ainsi que les métadonnées associées au document. Pour commencer et terminer la partie texte qui constitue notre document, on utilise :

```
\begin{document} --> Voici la commande de début
```

Notre texte s'écrit ici.

```
\end{document} --> Voici la commande de fin.
```

### 1.1.1 Commandes typographiques et d'emphase

#### Paragraphes, retour à la ligne et typographie

Pour créer un nouveau paragraphe, on effectue un saut de ligne.

Pour effectuer et forcer un saut de ligne, on utilise le double antislash (//) :
* Lorem ipsum dolor sit amet
* Lorem ipsum dolor sit amet

Observons le paragraphe suivant :
* Lorem ipsum dolor sit amet, ceci est un texte en gras, consectetur adipiscing
elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. ceci est un texte en italique orci porta non. Ceci est un texte souligné magna etiam tempor orci eu lobortis. On peut appliquer deux commandes de mises en forme en même temps, Risus viverra adipiscing at in tellus. Sit amet porttitor eget dolor morbi. Accumsan lacus vel facilisis volutpat, on peut faire cela aussi en indice est velit egestas dui en PETITES CAPITALES et même en exposant.

Nous avons utilisé ici quelques commandes typographiques classiques :

```
\textbf{texte} --> mise en gras (Ctrl+B)
\textit{texte} --> mise en italique (Ctrl+I)
\underline{texte} --> souligner (Ctrl+U). À utiliser avec parcimonie.
\textsubscript{texte} --> mise en l'indice
\textsuperscript{texte} --> mise en exposant
\textsc{texte} --> mise en petites capitales
```

### Mise en emphase

Ceci est une mise en emphase, traduite typographiquement par une mise en italique.

On préfère utiliser l'emphase en LATEX à la mise en forme typographique lorsque cela est possible car :

- cela permet d'indiquer un intention sémantique (mettre en valeur une chaîne de caractère) et non un simple style

- cela garantie une cohérence typographique puis LATEX gérera automatiquement l'apparence en fonction du contexte

La commande est la suivante :

```
\emph{texte en emphase}
```

### 1.1.2 Gestion de la typographie française et internationale

LATEX permet d'assurer une mise en conformité ortho-typographique du texte scientifique d'après les normes françaises (nous nous référons au Lexique des règles typographiques en usage à l'Imprimerie nationale) ou internationales. Nous listons ci-dessous quelques exemples couramment rencontrés en Histoire :

Pour les tirets : peut-être (quart de cadratin); 1880-1890 (demi-cadratin); Lorem ipsum dolor sit amet — une belle incise — lorem ipsum dolor sit amet.

```
Quart de cadratin (utilisés dans les mots composés par exemple) : -
Demi-cadratin (utilisés pour des plages de dates) : --
Cadratin (utilisés pour les incises) : ---
```

Pour appliquer des guillemets français (doubles chevrons), on utilise un pa-
ckage complémentaire nommé **babel** : « les beaux guillemets français »
## 1.2. ENVIRONNEMENTS DE BASE EN LATEX : LISTE, CITATION ET VERBATIM

La numérotation française s'effectue via ce même package babel. :
1re, 2e
1o, 2o
n°, n°s, N°, N°s

Les commandes utilisées sont les suivantes :

1\iere{}, 2\ieme{}
\primo, \secundo
\no, \nos, \No, \Nos

# 1.2 Environnements de base en LATEX : liste, citiation et verbatim

Jusqu'à présent, nous avons utilisé des **commandes** permettant d'effectuer des actions ponctuelles et spécifiques. Les **environnements** permettent quant à eux de regrouper un passage cohérent du texte pour lui appliquer un même comportement, tel qu'une mise en page particulière. Un environnement est délimité par une commande de début et de fin comme dans l'exemple qui suit :

\begin{quotation}
Ceci est une citation relativement
longue qui se détache du corps du texte
et qu'on souhaite mettre en exergue
\end{quotation}

Cette commande déclare un environnement cohérent, en l'occurrence une citiation longue (plus de 2 lignes), qui sera mise en forme via une marge plus importante.

### 1.2.1 Les environnements de liste

Deux types de listes sont disponibles en LATEX. La première génère une liste ordonnée et numérotée de 1 à n avec la commande

\begin{enumerate}

1. élément 1

2. élément 2

3. élément 3

La seconde commande crée une liste non ordonnée via la commande

\begin{itemize}

— élément 1

— élément 2
# 4 CHAPITRE 1. COMMANDES TYPOGRAPHIQUES ET GESTION DES ENVRIONNEMENTS

— élément 3

Il est aussi possible d'imbriquer les listes et les types de listes (une liste ordonnée dans une liste non ordonnée) :

— Item 1 :

1. Sous-item 1

2. Sous-item 2

— Item 2

Il est également possible d'établir des listes descriptives (adaptées aux chronologies en Histoire) avec l'environnement *description* :

1453 Prise de Constantinople

1515 Marignan

14 Juillet 1789 Prise de la Bastille

## 1.2.2 Les environnements de citations et verbatim

Comme nous l'avons vu précédemment, les citations courtes peuvent être mises en entre « guillemets français » avec les commandes

```
\og{} et \fg{}
```

du package Babel ou avec la commande *enquote* du package csquotes. Les citations longues (supérieures à plusieurs lignes) doivent être insérées dans l'environnement quotation :

```
\begin{quotation}
```

Ceci est une citation relativement longue.

Elle se détache du corps du texte.

Ce qui permet de la mettre en exergue.

```
\end{quotation}
```

Avec le package *csquotes*, on peut également intégrer des commandes pour indiquer dans un environnement quotation quand une citation est tronquée ou modifiée avec les commandes *textelp* et *textins*.

Ceci est une citation [...] [Là on peut décrire le contenu de la troncature] tronquée. Ceci est une citation [modifiée], mais qui reprend son cours.

L'environnement verbatim (largement utilisé dans ce manuel pour présenter les commandes) permet d'afficher le code informatique (dont un encodage LATEX) sans l'interpréter et l'exécuter :

```
\usepackage{ babel} (n'éxecute pas l'import du package Babel car la commande se trouve dans l'environnement verbatim)
```
### 1.2.3 Les environnements de tables

Les tableaux sont eux aussi des environnements spécifiques qu'il faut déclarer avec la commande

\begin{tabular}

<table><thead><tr><th>première colonne</th><th>deuxième colonne</th></tr></thead><tbody><tr><td>donnée 1</td><td>donnée 2</td></tr><tr><td>données 3</td><td>données 3</td></tr></tbody></table>

Ceci est un tableau généré via l'ajout rapide d'Overleaf (Insert Table). Si l'on veut faire apparaître le tableau dans la table des matières, il est nécessaire de déclarer un environnement <empty citation>table spécifique, contenant lui-même tabular :

Documentation Overleaf. URL: https://www.overleaf.com/learn (visité le 03/04/2025)

Première colonne | Deuxième colonne | 3e colonnes
1 | 2 | 3
4 | 5 | 6

<caption>TABLE 1.1 – Exemple d'un tableau</caption>

Il est possible d'ajouter des bordures horizontales en précisant la commande hline à la fin de chaque ligne, d'ajouter une légende :

<table><caption>TABLE 1.2 – Exemple d'un tableau avec bordures horizontales</caption><tr><td>a</td><td>a</td><td>a</td><td>a</td></tr><tr><td>b</td><td>b</td><td>b</td><td>b</td></tr><tr><td>c</td><td colspan="3">texte</td></tr></table>

Avec le package *longtable*, on peut gérer des tableaux créés sur plusieurs pages.

## 1.3 Gestion des images et paramètres

L'insertion de figures (images) s'effectue par la déclaration d'un environnement spécifique nommé *figure* :

\begin{figure}

Avec Overleaf, il faut d'abord téléverser l'image au format jpeg ou png dans le gestionnaire de fichiers (voir ci-dessous pour les bonnes pratiques), puis déclarer l'environnement et indiquer l'emplacement (le chemin de fichier) de l'image dans la commande
<figure><img src="image_4.png" /><figcaption>FIGURE 1.1 – Registre du bailliage de Lille (ADN B 6234, f°5)</figcaption></figure>

\includegraphics{}

L'environnement *figure* contient :

- un paramètre de positionnement (voir focus ci-dessous)

- la commande principale d'import de l'image : includegrapics. La taille de l'image est gérée de plusieurs manières :

- En précisant une largeur et une hauteur spécifique en centimètre (ex : [width=5cm, height=4cm])

- En utilisant un paramètre de mise à l'échelle avec [scale=0.5] (de 0.01 à n) en valeur absolue.

- la commande *caption* permettant d'ajouter une légende

- la commande *label* permettant de créer un lien vers l'image

Focus sur les paramètres de positionnement :

- h : place la figure approximativement à cet endroit

- t : place la figure en haut de page

- b : place la figure en bas de page

- p : place la figure sur une page à part entière

- H : place la figure exactement à l'endroit indiqué. Nécessite le package float.
# Chapitre 2

## De la gestion à la structuration des documents

### 2.1 Structuration d'un projet dans Overleaf

Il est recommandé d'adopter une gestion des fichiers modulaire par arborescence, en créant des sous-dossiers spécifiques pour les images et la bibliographie.

<figure><img src="image_5.png" /><figcaption>FIGURE 2.1 – Gestion de l'arborescence des fichiers dans Overleaf</figcaption></figure>

De même, il est possible et souhaitable d'écrire son texte en plusieurs fichiers. Cela a l'avantage de pouvoir suivre la structuration de la pensée. Par exemple, une thèse sera divisée en parties, elles-mêmes divisées en chapitres, eux-mêmes en sous-parties et ainsi de suite. Or, tout écrire dans un seul et même fichier pourra rendre peu pratique l'éditeur de texte de LATEX.

On peut donc rédiger par exemple chaque chapitre dans des fichiers .tex
## 8 CHAPITRE 2. DE LA GESTION À LA STRUCTURATION DES DOCUMENTS

séparés; ou bien chaque sous-partie de chapitres. Se pose alors le problème de la réunion de tous les fichiers. C'est pourquoi on utilise un main.tex qui est le fichier principal. Pour ajouter le contenu d'un autre fichier dans le fichier principal, on utilise les commandes *include* ou *input*.

```
\include{nom_du_chapitre.tex} -- > insère directement le contenu d'un fichier externe dans le document principal, comme s'il faisait partie du fichier source initial. Ne commence pas une nouvelle page avant ou après l'insertion.
```

```
\input{nom_du_chapitre.tex} --> ajoute automatiquement un saut de page et ne peut s'utiliser que dans le corps du texte.
```

## 2.2 Gestion des packages

Comme évoqué précédemment, les packages sont des modules spécifiques et complémentaires à LaTeX qu'il est possible d'importer dans le préambule en déclarant la commande `\usepackage{nomdupackage}` avec de possibles paramètres. Overleaf utilise une distribution en ligne nommée TeX Live, mise régulièrement à jour, qui recense et met à disposition les packages des utilisateurs. Ces packages sont donc maintenus et validés par la communauté des utilisateurs. Pour plus d'information, voir https://www.overleaf.com/blog/tex-live-2022-now-available. Par exemple :

```
\usepackage{babel}[french]
```

Dans la pratique, il est courant d'avoir sa propre liste de packages que l'on copie-colle dans le préambule de chaque nouveau document. Voici une brève liste de quelques packages courant en SHS et particulièrement en Histoire :
- **fontspec**: paquet d'encodage permettant la gestion de commandes typographiques et des fontes modernes

- **babel**: paquet de gestion des langues avec déclaration des langues utilisées en paramètre entre crochets. Permet d'utiliser certaines commandes de typographie française (iere, ieme, ...)

- **graphicx**: gestion approfondie des images (paramètres supplémentaires à la commande includegraphics)

- **float**: permet de gérer avec plus finesse le positionnement des images

- **fontenc**: gestion des caractères accentués

- **csquotes**: gestion des citations et mise en forme (fonctionne avec babel pour les guillemets français)

- **lscape**: environnement de mode paysage

- **pdflscape**: paysage dans le PDF

- **appendix**: permet de générer des tables des matières en annexes

- **imakeidx**: génération des indexes

- **tocbibind**: ajout de l'index dans la table des matières

- **hyperref**: Toujours en fin d'appel des packages pour éviter les conflits, package de génération des hyperliens et liens internes au document

## 2.3 Structurer un document en LATEX

### 2.3.1 Arborescence du document scientifique

#### De la partie d'un ouvrage au paragraphe

Avec la classe de document **book**, le fichier peut se structurer en 6 niveaux principaux d'arborescence, de la partie d'un ouvrage au paragraphe :

- La **partie** d'ouvrage :

```
\part{}
```

- Le **chapitre** :

```
\chapter{Titre du premier chapitre}
```

- Par défaut, la numérotation des chapitres est automatique, de 1 à n. On peut souhaiter faire apparaître un chapitre sans le numéroter tout en lui donnant un titre avec
\chapter*{Introduction}

— La (ou parties d'un chapitre) :
\section{}

— La sous-section (sous-partie d'un chapitre) :
\subsection{}

— La sous-sous-section (sous-sous-partie d'un chapitre) :
\subsubsection{}

— Le paragraphe :
\paragraph{}

(Il s'agit d'un niveau spécifique, et assez rare, d'arborescence, à ne pas confondre avec la rédaction d'un paragraphe via le double retour chariot)

2.3.2 Les spécificités de la classe book : frontmatter, main-matter, backmatter

Le *frontmatter* contient l'ensemble des pages avant le début de l'introduction,
à savoir le résumé et les remerciements au sein d'un livre ou d'une thèse. Pour
cela, on déclare avec la commande du même nom cet environnement, constitué
de chapitres non numérotés :

\frontmatter

\chapter{Résumé}
Ceci est le résumé

\chapter{Remerciements}

\lettrine{M}es remerciements vont tout d'abord à ...

Divers modèles proposent une mise en page du *frontmatter*, à l'instar de
celui proposé par l'École nationale des Chartes (voir https://github.com/
Jean-Baptiste-Camps/biblatex-enc). Une fois le *frontmatter* terminé, on dé-
clare le début du corps du texte avec la commande *mainmatter* :

\mainmatter

\part{Première partie du l'ouvrage}

\chapter{Premier chapitre de l'ouvrage}

Finalement, le *backmatter* contient l'ensemble des tables et des index per-
mettant de naviguer dans le document. Il se situe traditionnellement après les
annexes :

\backmatter
\printindex

\printglossaries

\listoffigures

\listoftables

\tableofcontents

\end{document}

Ces commandes frontmatter, mainmatter, backmatter ne sont pas obligatoires. Il est néanmoins recommandé de les utiliser, notamment avec la classe book pour ajouter une couche sémantique à la structure logique du document.

### 2.3.3 Focus : les différents types de documents

La toute première ligne de code du document est

\documentclass{book}

Il s'agit de la commande de déclaration de type de document qui détermine le comportement et l'apparence générale du document. Un document dont la classe est *article* n'aura pas exactement le même comportement qu'un livre (book). Par exemple, un article aura son titre sur la même page que le début du texte et des marges plus restreintes. Les principales classes sont les suivantes :

- **article**: articles destinés à la publication et ne contenant que quelques pages

- **report**: pour des documents un peu plus longs contenant plusieurs chapitres, comme des mémoires de thèse

- **book**: pour des livres (classe la plus englobante et la plus répandue)

- **beamer**: pour générer des slides en LATEX (il s'agit d'une extension contemnue dans la plupart des distributions contemporaines)

- **lettre**: lettres officielles au format français (développé par l'Observatoire de Genève).

La commande de déclaration de la classe peut prendre plusieurs paramètres déterminant la taille de la police principale ([10pt]), la taille du papier([a4paper]) ou l'orientation ([landscape]). Par exemple :

\documentclass[12pt, a4paper]{book}

déclare un document livre dont la police est de 12 points et au format A4 (paramètres par défaut).
## 2.4 Métadonnées du document et page de titre

On entend par métadonnées l'ensemble des informations décrivant le document et permettant d'indexer son contenu. Ce sont des données décrivant des données. Il s'agit principalement dans notre cas du titre, de l'auteur et de la date. Nous pouvons donc remonter dans le préambule de notre document, préciser les métadonnées et régénérer la page de titre avec les commandes suivantes :

```
\title{Introduction à \LaTeX pour les Sciences Humaines et Sociales}
\author{Valentin de Craene et Valentin Mériaux}
\date{\today}
\begin{document}
\maketitle
```

La commande *maketitle* permet de générer la page de titre automatiquement à partir de ces métadonnées. La commande *today* permet d'indiquer automatiquement la date du jour. Cependant, il est possible de créer sa propre page de titre en déclarant un environnement *titlepage* :

```
\begin{titlepage}
```

## 2.5 Gestion des liens internes et externes du document

Il est possible de renvoyer à une figure déjà insérée dans le corps du texte en indiquant son label via la commande *ref*. Par exemple : « Se référer à l'image 1.1 » crée un lien vers la première image insérée plus haut, dans le chapitre 1, première section.

Le package *hyperref* permet de gérer la navigation avec plus de finesse, en faisant porter le lien sur une chaîne de caractères. Ex : Voir l'image *ci-dessus*.

Bien évidemment, il est possible d'insérer des liens *url* via la commande *url* : https://www.meshs.fr La commande *href* fonctionne de la même manière : lien vers le site de la MESHs.

En outre, il est possible de renvoyer à des niveaux de titre spécifiques ou des passage du document en déclarant au préalable un label avec la commande *label* (déjà présenté pour le cas des images). Par exemple *ci-dessous* nous avons créé tout d'abord un label pour la sous-section 2.1.2 concernant les spécificités de la classe *book*, puis nous générons le lien avec la commande *ref* ou *href* :

Voir 2.3.2
```
\printindex[lieux]
```

Ces glossaires, listes d'acronymes et index sont généralement insérés dans les annexes.

## 2.7 Les annexes

Il est nécessaire d'ajouter l'ensemble des annexes à la fin du document via la commande *appendix*. Cela génère un nouvel environnement séparé du corps du texte dans lequel on vient placer l'index, le glossaire et les tables des matières. Il est nécessaire de déclarer une nouvelle commande pour que les appendices soient renommés « annexes » en français :

```
\renewcommand{\appendixpagename}{Annexes}
```

De même, il est préférable de faire apparaître les annexes dans la table des matières. Pour cela, nous pouvons utiliser la commande suivante :

```
\renewcommand{\appendixtocname}{Annexes}
```

```
\appendix
```

```
\renewcommand{\appendixpagename}{Annexes}
```

```
\renewcommand{\appendixtocname}{Annexes}
```

```
\appendixpage
```

```
\addcontentsline{toc}{part}{Annexes}
```
# Chapitre 3

# Bibliographie et apparat
critique du document

## 3.1 Automatiser la génération de la bibliographie : de Zotero à LaTeX

### 3.1.1 Paramétrage et principes généraux de biblatex

En premier lieu, on privilégie l'utilisation et l'usage de *biblatex* dans le cas d'une utilisation avec Overleaf. Il s'agit d'un système et programme moderne de gestion des données bibliographiques. On appelle donc le package dans le préambule puis on indique le fichier au format .bib que le processeur doit traiter :

```
\usepackage{biblatex}
\addbibresource{fichier.bib}
```

En LATEX, la gestion de la bibliographie se fait donc à partir d'un fichier .bib séparé du reste du document qui sert de « base de données bibliographiques ». Le fichier est structuré sous forme d'une succession d'entrées définies par un type (book, article etc.), une clé unique qui lui sert d'identifiant et enfin des métadonnées qui décrivent la référence en question (title, author etc.).

### 3.1.2 Produire et structurer un fichier .bib

Il y a plusieurs manières de gérer, structurer et produire ce type de fichier :

- en le rédigeant « manuellement » en respectant la syntaxe et l'encodage du format biblatex

- en utilisant un gestionnaire de données bibliographiques adapté à LATEX comme Zotero ou JabRef qui sont plus ergonomiques. Il existe un plugin Zotero qui permet d'exporter sa bibliographie Zotero en la convertissant en .bib : BetterBibTex.
### 3.1.3 Remplir son fichier .bib : la clef, les entrées et les champs

Chaque entrée se définit par 3 éléments : un type d'entrées, une clef unique et les champs. Les types d'entrées (comprennons de documents dans la bibliographie) acceptés par le package *biblatex* sont nombreux, diversifiés et bien adaptés aux besoins des sciences historiques. Ceux-ci sont recensés dans la documentation officielle de biblatex : https://bibtex.eu/types/.

La clef sert d'identifiant unique de la référence bibliographique. C'est cette clé qui est utilisée dans l'éditeur pour appeler la référence bibliographique en note de bas de page par exemple. Il est primordial que la clé soit unique et non nulle. Les types d'entrées les plus utilisés en SHS sont les suivants :

- article : pour les articles scientifiques.

- book : pour les livres avec un seul auteur

- incollection : pour citer seulement des chapitres ou des parties d'un livre, en particulier dans les ouvrages collectifs où les auteurs ne se confondent pas avec les directeurs d'ouvrage.

- collection : ouvrage collectif mais avec des parties distinctes par auteur

- phdthesis : mémoire de thèse (existe aussi une version pour les mémoires de master)

- proceedings et inproceedings : pour citer des actes de colloque en général, ou une partie des actes de colloque.

Il en existe beaucoup d'autres pour des usages spécifiques, comme par exemple les brevets d'invention, des ouvrages non publiés, ect. Pour tout élément ne rentrant pas dans ces catégories, il existe un type d'entrée misc.

Les champs (métadonnées) les plus communs sont les suivants : author, title, booktitle, publisher, year, editor, volume et number, pages, address. Chaque type d'entrée a son lot de champs considérés comme obligatoires, et d'autres facultatifs.

Pour remplir son fichier .bib, on rédige de la manière suivante :

```
@article{CléUnique,
nomDuChamp = {valeur}
author = {Jean Exemple and John Example and Jean de Lille}
}
```

On voit dans l'exemple ci-dessus que dans le cas où on aurait des auteurs multiples, il suffit d'ajouter le mot clé *and* entre chaque auteur. De même on peut ajouter des particules mais celles-ci doivent obligatoirement être mises en minuscule avant le nom de famille.

## 3.2 Les commandes de gestion bibliographique

### 3.2.1 Les styles bibliographiques

LATEX intègre en son sein divers styles bibliographiques. Dans le cadre d'une recherche en sciences humaines et sociales, les styles à privilégier sont ceux de la
famille verbose (verbose, verbose-trad1, verbose-trad2, verbose-trad3, verbose- note, verbose-ibid). Il est donc nécessaire d'ajouter dans l'appel du *package* dans le préambule l'argument « citestyle=verbose » :

```
\usepackage[citesyle=verbose-trad2]{biblatex}
```

### 3.2.2 La commande printbibliography

Pour afficher la bibliographie, on utilise :

```
\printbibliography
```

Cette commande permet d'afficher la bibliographie sous forme de chapitres, en ne prenant que les références qui sont citées dans le document. Si on veut que la totalité des références du fichier .bib soit affichée, il faut ajouter :

```
\nocite{*}
```

On peut noter également qu'il est possible d'indiquer en champs *options* dans la base bibliographique un *skipbib = true*. Cette option permet de passer sous silence la référence indiquée dans l'impression finale de la bibliographie. Il est aussi possible d'ajouter diverses paramètres dans la commande *printibibliography*, comme le type (permettant de générer une ou plusieurs bibliographies en respectant la typologie bibliographique) :

```
\printbibliography[type=article, title={Articles}]
```

Supposons que l'on veuille une bibliographie thématique. Pour cela, on va utiliser le champ keyword à préciser dans les entrées :

```
\printbibliography[keyword=general, title={Ouvrages généraux}]
```

La commande précédente permet de n'imprimer que les ouvrages dont la valeur du champ keyword est « general ».

### 3.2.3 Les commandes de citation

On peut trouver trois grandes commandes de citations : *cite*, *parencite*, *foot-cite* :

1. *cite* imprime la référence brute, sauf dans certains styles où cela imprime avec des crochets.

2. *parencite* affiche la référence en la mettant entre parenthèse dans le corps du texte.

3. *footcite* imprime la référence dans une note de bas de page. Dans le cadre d'un manuscrit de thèse en français, c'est la commande à favoriser. Il existe même d'autres commandes de citation comme *autocite*, qu'il est déconseillé d'utiliser. En argument de ces commandes, on mettra la clé *biblatex* de la référence.
# 18 CHAPITRE 3. BIBLIOGRAPHIE ET APPARAT CRITIQUE DU DOCUMENT

En argument de ces commandes, on mettra la clé biblatex de la référence.
Exemple :

Dans le fichier .bib, on a :

```tex
@book{Exemple2024,
    title = {Un titre en exemple}
    author = {Jean-Michel Exemple}
    date = {2024}
}
```

Dans le fichier .tex, on a :

```
Lorem ipsum dolor sit amet, consectetur adipiscing elit\footcite{Exemple2024}.
```

On peut aussi ajouter un « prénote » et un « postnote » dans une note de bas de page. Pour cela on rédige de la manière suivante :

```
\footcite[texte de prenote][texte de postnote]{Exemple24}
```

On peut également citer plusieurs entrées pour une seule note :

```
\footcite{Exemple24, Exemple23}
```

Il est possible, en indiquant simplement un chiffre en argument de postnote, d'indiquer la ou les pages citées.

Pour ajouter une note de bas de page sans citation, on utilisera seulement

```
\footnote{Un exemple de note de bas de page.}
```

Il est possible d'aller plus loin encore avec notamment la commande footcites pour citer plusieurs éléments en mettant plusieurs textes entre chaque entrée.

```
\footcites[prenote 1][postnote 1]{Clé 1}[prenote 2][postnote 2]{Clé 2} etc.
```
# Chapitre 4

## Séance 4 : Bonnes pratiques de rédaction en LATEX

### 4.1 Focus : bonnes pratiques en LATEX

#### 4.1.1 Bonnes pratiques de rédaction

##### Préférer la mise en sens que la mise en forme pure

Bien qu'il existe de nombreuses commandes de mise en forme du texte, il est recommandé de privilégier des commandes de mise en sens, comme *emph*, plutôt que *textit*, qui ont pourtant le même effet graphique. On pourra également se reporter à la création de commandes pour mettre en forme de manière automatisée. L'avantage de ce genre de pratiques est justement de gagner du temps et d'automatiser des tâches, particulièrement dans le cas où on aimerait modifier la mise en forme d'une commande en fonction d'un usage.

Supposons qu'il soit nécessaire que la commande *emph* ne mette plus en italique le texte, mais au contraire qu'elle le mette en gras. Si j'ai écrit en utilisant la commande *textit*, je suis coincé et je dois tout reprendre à la main. Si j'ai utilisé la commande *emph*, au contraire, je peux la modifier pour qu'elle se conforme à mes nouvelles attentes, et toutes les expressions mises dans cette commande s'en trouveront modifiées également dans le rendu final.

##### Rédiger

L'écriture dans un éditeur de texte n'est pas la même que dans un traitement de texte. Il est recommandé d'écrire en respectant dans la mesure du possible : une ligne de l'éditeur = une phrase. Cela a le mérite d'être plus simple pour se relire lors de la rédaction et de garder une approche modulaire de l'écriture scientifique. Passer une ligne en LATEXn'équivaut pas à un passage de ligne dans le .pdf final. Pour passer une ligne il faut laisser une ligne blanche dans
l'interpréteur, pour marquer le changement de paragraphe. Si on veut ajouter un saut de ligne, il faut utiliser les doubles backslash : \\

Également, utiliser LATEX oblige à connaître les règles de typographie française au maximum. Par exemple, il faut penser à insérer soi-même des espaces insécables quand cela est nécessaire. Le (tilde) est le caractère interprété par LaTeX en un espace insécable :

On écrit Louis~XIV et non Louis XIV.

On l'ajoute également avant certaines ponctuations~: ici, ou encore ici~?

## 4.2 Créer ses propres commandes

En LATEX, il est possible de créer ses propres commandes (et d'ailleurs de modifier des commandes déjà existantes) pour automatiser l'écriture, la mise en sens et la mise en forme.

Par exemple, en Histoire, il est très courant de devoir mobiliser les siècles. Or, leur mise en forme est particulièrement pénible et rébarbative, multipliant les commandes pour respecter la typographie française. Cela a donc du sens de créer une commande visant à automatiser leur rédaction.

Pour cela on peut créer une nouvelle commande via la commande suivante :

\newcommand{\siecle}[1]{\textsc{#1}\textsuperscript{e} siècle}

[Dans le corps du texte]

Le \siecle{xix} est le siècle de l'industrialisation.

Le \siecle{xviii} est le siècle des Lumières.

Bien entendu, il est possible de modifier le comportement de commandes ou d'environnements déjà existants. Observons l'exemple suivant :

[Dans le préambule]

\usepackage{pifont} % Permet de modifier les puces des listes

\newenvironment{maListe}

{\renewcommand{\labelenumi}{\ding{47}}\begin{enumerate}}{\end{enumerate}}}

[Dans le corpus du texte]

\begin{maListe}

\item Test %Produit une puce sous forme d'un crayon

\end{maListe}

On appelle dans un premier temps un package nommé *pifont* utilisé pour ajouter d'autres puces et éléments graphiques aux listes. Ensuite, on créé un nouvel environnement nommé « *maListe* », qui applique une modification de comportement à l'environnement *enumerate*.
## 4.3 Caractères réservés et documentation du code

LaTeX utilise donc un ensemble de caractère au sein de ses commandes et de ses environnement pour permettre leur interprétation et compilation. Ces caractères sont dits « réservés ». Pour les faire apparaître dans le corps du texte, il faut soit les échapper (ajouter un anti-slash devant) soit utiliser des commande spécifique :

- Le dièse : #

- Les accolades : {}

- L'anti-slash :\

- La tilde : ~

Par défaut LaTeX gère automatiquement les espaces insécables après la ponctuation, en français, grâce au package babel. Il peut néanmoins être nécessaire d'ajouter des espaces insécables avec la tilde : (qui est un caractère réservé!)

### La programmation lettrée

Le principe de *literate programming* ou « programmation lettrée » a été énoncé par Donald E. Knuth dans les années 1990. Il s'agit d'un paradigme de programmation qui consiste à « expliquer à des êtres humains ce que nous voulons que l'ordinateur fasse ». Cela s'applique notamment par l'explication et le commentaire du code en langage naturel.

Voir Donald E. Knuth (1992). *Literate Programming*. California : Stanford University Center for the Study of Language and Information. http://www.literateprogramming.com/knuthweb.pdf

Pour commenter son code en LaTeX, la manière la plus courante est d'ajouter le signe % devant chaque ligne. Cela indique au processeur LaTeX de ne pas exécuter la commande ou de ne pas prendre en compte la chaîne de caractères concernée. Par exemple :

```% Ceci est un commentaire```

Il est aussi possible, bien que plus rare, de passer en commentaire un vaste ensemble de ligne via le package *comment* et son environnement correspondant :

```\usepackage{comment}
\begin{comment}
Ceci est un passage entier mis en commentaire
\end{comment}
```
## 4.4 Formules mathématiques et codes informatiques

Il est courant de mettre en forme les expressions mathématiques en les enca drant par des anti-slashs et des parenthèses : $x^2+y^2 = z^2$. La formule est ici bien mise en forme au sein du paragraphe. Nous avons donc utilisé l'échappement suivant :

$$ \text{\(x^2 + y^2 = z^2\)} $$

Deux modes pour la mise en forme des expressions mathématiques existent : inline (dans un paragraphe) et display (hors d'un paragraphe).

### 4.4.1 Le mode inline

Le mode inline peut-être utilisé des trois manières différentes :

$$ \text{\(\dots\)} \qquad \text{\$\dots\$} \qquad \text{\begin{math}\dots\end{math}} $$

Cela donne donc bien $E = mc^2$ (échappement par parenthèses), $E = mc^2$ (échappement par le signe dollars) et $E = mc^2$ (échappement par l'environnement math).

### 4.4.2 Le mode display

De la même manière, le mode display peut-être utilisé des trois façons :

$$ \text{\[\dots\]} \qquad \text{\begin{displaymath}\dots\end{displaymath}} \qquad \text{\begin{equation}\dots\end{equation}} $$

Voici une expression séparée du reste du texte avec l'échappement par cro chets :

$$ \sqrt{x^2 + 1} $$

Cela permet de mettre en évidence une formule mathématique particulière. Uti lisé par les statisticiens.

Ceci est la même chose mais avec l'environnement displaymath

$$ \sqrt{x^2 + 1} $$

...que cela avec l'environnement equation :

$$ \sqrt{x^2 + 1} $$
Annexes
<figure><img src="image_6.png" /></figure>
Bibliographie

BOUZIGUES, Adrien. *Initiation à LaTeX*. 2016. URL : https://mirrors.ibiblio.org/CTAN/info/guide-latex-fr/guide-latex-fr.pdf.

*Documentation Overleaf*. URL : https://www.overleaf.com/learn (visité le 03/04/2025).

GUICHARD, Éric. *LATEX pour littéraires, éditeurs et designers*. 2024. URL : https://www.ericguichard.fr/LaTeX-pour-litteraires-etc.pdf.

HOUDAYER, Aurélia et Éric GUICHARD. *Du papier au numérique : quels changements pour les archives ? : L'édition d'un livre avec LaTeX*. Villeurbanne, Rhône, France, 2013. 124 p.

IMPRIMERIE NATIONALE. Lexique des règles typographiques en usage à l'Impprimerie nationale. - 3e édition. Paris, France : Imprimerie nationale, 2002. 196 p. ISBN : 978-2-7433-0482-9.

LEHMAN, Philipp, Philip KIME et Moritz WEMHEUER. *The Biblatex Package*. 2024. URL : https://ctan.math.illinois.edu/macros/latex/contrib/biblatex/doc/biblatex.pdf.

NINJA, Latex. *How to Write (Ancient) Greek in LaTeX*. LaTeX Ninja'ing et the Digital Humanities. 16 jan. 2022. URL : https://latex-ninja.com/2022/01/16/how-to-write-ancient-greek-in-latex/ (visité le 03/04/2025).

NINJA, Latex. *The LaTeX Newbie's Guide to Using Overleaf for Conference Paper Submissions*. LaTeX Ninja'ing et the Digital Humanities. 9 jan. 2022. URL : https://latex-ninja.com/2022/01/09/the-latex-newbies-guide-to-using-overleaf-for-conference-paper-submissions/ (visité le 03/04/2025).

PROJECT, The LaTeX. *LaTeX - A Document Preparation System*. URL : https://www.latex-project.org/ (visité le 03/04/2025).

ROUQUETTE, Maïeul. (*Xe*)LaTeX appliqué aux sciences humaines. Atramenta, 2012, p. 268. URL : https://shs.hal.science/halshs-00924546 (visité le 03/04/2025).
# Annexe A

## Ma première annexe

### A.1 Première sous section d'annexe

Au sein des annexes, il est possible de structurer le contenu de la même manière que dans le corpus du texte mais au niveau maximal du chapitre.

### A.2 Seconde sous-section de l'annexe

Seconde sous section de l'annexe
# Annexe B

## Ma deuxième annexe

<figure><img src="image_7.png" /><figcaption>FIGURE B.1 – Exemple d’un schéma inséré en annexe</figcaption></figure>
# Glossaire

**métadonnée** donnée servant à définir ou décrire une autre donnée quel que soit son support. 12
# Acronymes

**MESHS** Maison Européenne des Sciences de l'Homme et de la Société. 13
Index des noms de lieux

Université de Lille, 13
Table des figures

<table><tr><td>1.1 Registre du bailliage de Lille (ADN B 6234, f°5)</td><td>6</td></tr><tr><td>2.1 Gestion de l'arborescence des fichiers dans Overleaf</td><td>7</td></tr><tr><td>B.1 Exemple d'un schéma inséré en annexe</td><td>29</td></tr></table>
# Liste des tableaux

<table><tr><td>1.1</td><td>Exemple d'un tableau</td><td>5</td></tr><tr><td>1.2</td><td>Exemple d'un tableau avec bordures horizontales</td><td>5</td></tr></table>
# Table des matières

<table><tr><td>Avant-propos</td><td>i</td></tr><tr><td>1 Commandes typographiques et gestion des envrionnements</td><td>1</td></tr><tr><td>1.1 Écrire en LATEX</td><td>1</td></tr><tr><td>1.1.1 Commandes typographiques et d'emphase</td><td>1</td></tr><tr><td>1.1.2 Gestion de la typographie française et internationale</td><td>2</td></tr><tr><td>1.2 Environnements de base en LATEX : liste, citation et verbatim</td><td>3</td></tr><tr><td>1.2.1 Les environnements de liste</td><td>3</td></tr><tr><td>1.2.2 Les environnements de citations et verbatim</td><td>4</td></tr><tr><td>1.2.3 Les environnements de tables</td><td>5</td></tr><tr><td>1.3 Gestion des images et paramètres</td><td>5</td></tr><tr><td>2 De la gestion à la structuration des documents</td><td>7</td></tr><tr><td>2.1 Structuration d'un projet dans Overleaf</td><td>7</td></tr><tr><td>2.2 Gestion des packages</td><td>8</td></tr><tr><td>2.3 Structurer un document en LATEX</td><td>9</td></tr><tr><td>2.3.1 Arborescence du document scientifique</td><td>9</td></tr><tr><td>2.3.2 Les spécificités de la classe book : frontmatter, mainmatter, backmatter</td><td>10</td></tr><tr><td>2.3.3 Focus : les différents types de documents</td><td>11</td></tr><tr><td>2.4 Métadonnées du document et page de titre</td><td>12</td></tr><tr><td>2.5 Gestion des liens internes et externes du document</td><td>12</td></tr><tr><td>2.6 Enrichir le document : index, glossaire(s)</td><td>13</td></tr><tr><td>2.6.1 Générer un glossaire</td><td>13</td></tr><tr><td>2.6.2 Générer un index</td><td>13</td></tr><tr><td>2.7 Les annexes</td><td>14</td></tr><tr><td>3 Bibliographie et apparat critique du document</td><td>15</td></tr><tr><td>3.1 Automatiser la génération de la bibliographie : de Zotero à LaTeX</td><td>15</td></tr><tr><td>3.1.1 Paramétrage et principes généraux de biblatex</td><td>15</td></tr><tr><td>3.1.2 Produire et structurer un fichier .bib</td><td>15</td></tr><tr><td>3.1.3 Remplir son fichier .bib : la clef, les entrées et les champs</td><td>16</td></tr><tr><td>3.2 Les commandes de gestion bibliographique</td><td>16</td></tr><tr><td>3.2.1 Les styles bibliographiques</td><td>16</td></tr></table>
<table><tbody><tr><td>3.2.2</td><td>La commande printbibliography</td><td>17</td></tr><tr><td>3.2.3</td><td>Les commandes de citation</td><td>17</td></tr><tr><td>4</td><td>Séance 4 : Bonnes pratiques de rédaction en LATEX</td><td>19</td></tr><tr><td>4.1</td><td>Focus : bonnes pratiques en LATEX</td><td>19</td></tr><tr><td>4.1.1</td><td>Bonnes pratiques de rédaction</td><td>19</td></tr><tr><td>4.2</td><td>Créer ses propres commandes</td><td>20</td></tr><tr><td>4.3</td><td>Caractères réservés et documentation du code</td><td>21</td></tr><tr><td>4.4</td><td>Formules mathématiques et codes informatiques</td><td>22</td></tr><tr><td>4.4.1</td><td>Le mode inline</td><td>22</td></tr><tr><td>4.4.2</td><td>Le mode display</td><td>22</td></tr><tr><td colspan="2">Annexes</td><td>25</td></tr><tr><td colspan="2">Bibliographie</td><td>25</td></tr><tr><td>A</td><td>Ma première annexe</td><td>27</td></tr><tr><td>A.1</td><td>Première sous section d'annexe</td><td>27</td></tr><tr><td>A.2</td><td>Seconde sous-section de l'annexe</td><td>27</td></tr><tr><td>B</td><td>Ma deuxième annexe</td><td>29</td></tr><tr><td colspan="2">Glossaire</td><td>31</td></tr><tr><td colspan="2">Acronymes</td><td>33</td></tr><tr><td colspan="2">Table des figures</td><td>37</td></tr><tr><td colspan="2">Liste des tableaux</td><td>39</td></tr><tr><td colspan="2">Table des matières</td><td>41</td></tr></tbody></table>