Structurer un mémoire ou une thèse en LaTeX avant que la panique ne s'installe

Pages liminaires, inclusion des chapitres, acronymes, classes d'université, vitesse de compilation et historique Git pour les étudiants en master et en doctorat.

Une thèse est un long article assorti de paperasserie. LaTeX gère très bien le long article. La paperasserie, c’est le plus souvent une classe d’université écrite en 2009 et testée pour la dernière fois sur une autre version de TeX Live.

Mettez la structure en place tôt, même si les chapitres sont encore vides. Déplacer du contenu d’un fichier à l’autre pendant le dernier mois, c’est ainsi que les références croisées et les chemins des figures cassent.

Acceptez le fichier de classe, isolez le reste

Placez dans le projet le .cls de l’université (ainsi que les fichiers .bst et de logo requis). Ne réécrivez pas la classe. Mettez vos macros, vos packages et le contenu de vos chapitres dans des fichiers que vous maîtrisez :

thesis/
main.tex
macros.tex
chapters/
figures/
university.cls

Si la classe ne fonctionne plus avec un moteur récent, faites le tri en suivant les fichiers de classe d’université qui ne compilent pas. Notez quel moteur le service des thèses accepte (pdfLaTeX, XeLaTeX ou LuaLaTeX) avant de vous investir dans fontspec.

Des pages liminaires comme le jury les attend

Chiffres romains pour le résumé, la dédicace, les remerciements, la table des matières et les listes de figures et de tableaux ; chiffres arabes pour les chapitres principaux. Les classes book et report offrent \frontmatter / \mainmatter ; les modèles fondés sur article demandent un \pagenumbering manuel. Le guide : chiffres romains puis arabes.

Le contenu de la page de titre doit souvent reproduire un exemple Word fourni par l’école doctorale. Copiez la formulation à l’identique. Toute créativité ici vaut au PDF d’être rejeté par une liste de contrôle.

Un fichier par chapitre

Une racine, de nombreuses inclusions :

\include{chapters/intro}
\include{chapters/background}
\include{chapters/methods}
\include{chapters/results}
\include{chapters/conclusion}

Gardez la main sur vos chapitres, même si des coauteurs vous aident sur les articles qui alimentent la thèse. Rangez les figures sous figures/chapter3/ pour que les chemins restent stables quand vous réorganisez. Utilisez \includeonly{chapters/methods} pendant la rédaction, afin que la compilation de toute la thèse ne soit pas le prix de chaque modification d’équation : fichiers de chapitre séparés.

Les étiquettes (labels) doivent être uniques dans tout le projet (eq:ch3-main, et non eq:main dans chaque fichier). Les vues de structure à l’échelle du projet et la vérification des références en direct aident sur une arborescence de 200 pages.

Acronymes et symboles

Les packages de glossaire sont puissants et tatillons. Pour beaucoup de thèses, une liste de symboles tenue à la main dans les pages liminaires suffit. Si vous voulez des acronymes qui se développent automatiquement, prévoyez une journée pour apprendre glossaries-extra avant la semaine du dépôt, et non pendant.

Définissez les macros mathématiques dans macros.tex et traitez ce fichier comme une loi commune. Une notation qui dérive entre le chapitre 2 et le chapitre 5 est un cadeau pour un examinateur pointilleux.

Bibliographie

Un seul .bib pour toute la thèse, ou un petit ensemble fusionné avec soin. Des clés stables. Validez avant l’impression en reliure souple : validateur BibTeX. Respectez le style que veut le département (numérique, auteur-année, styles en notes de bas de page propres aux sciences humaines). Ne mélangez pas les chaînes biblatex et BibTeX classique dans un même préambule.

Vitesse

La compilation de la thèse entière devient lente. Le mode brouillon pour les figures, \includeonly et l’externalisation de TikZ font regagner des heures. Quelques pistes : attendre moins longtemps le PDF.

Gardez un rituel de « compilation complète » chaque semaine, pour continuer à voir tôt les échecs entre chapitres.

Sauvegarde n’est pas historique

Une copie Dropbox est une sauvegarde. Git raconte comment l’argument a évolué. Faites un commit quand un chapitre compile. Poussez vers un dépôt distant privé sur GitHub ou GitLab.

Oleafly (s’ouvre dans un nouvel onglet) initialise un vrai dépôt par projet, crée des points de contrôle après les compilations réussies et les modifications laissées au repos, et restaure en un clic, avec en plus des vues de structure à l’échelle du projet et SyncTeX qui continuent de fonctionner d’un fichier de chapitre à l’autre. Il devient ainsi plus difficile de se passer de cette habitude. Vous pouvez obtenir la même discipline avec n’importe quel éditeur et un Git rigoureux ; la thèse ne devrait pas dépendre de votre mémoire pour lancer git init au dix-huitième mois.

Les allers-retours avec le jury

Exportez le PDF pour les lecteurs qui n’ouvriront pas les sources. Suivez les commentaires dans des tickets (issues) ou un document partagé, mais appliquez les corrections dans le TeX. Quand un membre du jury renvoie un PDF annoté scanné, nommez le fichier avec la date et la version pour savoir à quel commit des sources il se rapporte.

Liste de contrôle avant reliure souple et reliure rigide

Avant d’imprimer ou de déposer :

  • Le fichier de classe et le moteur respectent les règles du service des thèses.
  • Numérotation des pages liminaires correcte ; page de signatures présente si elle est exigée.
  • Tous les \ref/\cite sont résolus ; aucun [?].
  • Listes des figures et des tableaux présentes si exigées ; légendes cohérentes.
  • Les marges et la taille de police passent la liste de contrôle en PDF (imprimez une page d’essai).
  • Sources, PDF et hash du commit archivés après le dépôt.

Figures, tableaux et pages de listes

Beaucoup de services des thèses exigent une liste des figures et des tableaux. Les légendes doivent être cohérentes et ne pas déverser toute la section de méthodes dans une légende de 20 lignes. Utilisez des titres courts pour les listes et des légendes explicatives plus longues dans le corps du texte si la classe accepte les légendes courtes facultatives.

Plagiat et publications antérieures

Si des chapitres reprennent des articles publiés, suivez les règles de l’université sur la réutilisation et l’autorisation des coauteurs. Gardez sous gestion de versions le PDF accepté de chaque article antérieur et le chapitre de la thèse, avec une note sur ce qui a changé (notation, expériences étendues, introduction unifiée).

Commencez ce mois-ci, pas le mois de la rédaction

Créez le squelette dès que vous proposez le plan. Des chapitres vides qui compilent comptent comme une avancée. La plupart des paniques de fin de parcours viennent d’une dette de structure et d’un fichier de classe têtu, pas d’un trou dans la science. Remboursez cette dette tôt.

Tous les articles