183 lines
10 KiB
Markdown
183 lines
10 KiB
Markdown
#  Modèle de thèse Doctorat Bretagne Loire
|
|
|
|
*Explications en français*
|
|
|
|
Ce dépôt contient un modèle latex pour le manuscrit de thèse supportant toutes les écoles doctorales de l'[École des docteurs Bretagne Loire](https://www.doctorat-bretagneloire.fr/).
|
|
|
|
Ce modèle a pour but principal de fournir une première et une quatrième de couverture du manuscrit de thèse intégralement écrites en latex.
|
|
Ces couvertures ont été (manuellement) calquées sur le modèle original au format M$ Word fourni par MathSTIC en 2018, puis généralisé à toutes les écoles doctorales DBL.
|
|
Tandis que la couverture du manuscrit se doit de respecter le format établi par DBL, la disposition du contenu interne du manuscrit est elle plus flexible.
|
|
La disposition proposée dans ce modèle est donc donnée à titre d'exemple mais il n'est cependant pas obligatoire de la respecter.
|
|
|
|
|
|
### Structure du dépôt
|
|
|
|
- `main.tex` contient le squelette du document, aucun texte du manuscrit n'est présent dans ce fichier
|
|
- `these-dbl.cls` contient les dépendances, les paramètres de la bibliographie dont le style de citation et les paramètres de mise en page globale du manuscrit et plus particulièrement des deux couvertures
|
|
- `Couverture-these/pagedegarde.tex` contient les variables à remplir par l'auteur pour compléter la page de garde, ces variables sont utilisées par `\maketitle` redéfini dans `these-dbl.cls`
|
|
- `Couverture-these/resume.tex` contient les variables à remplir par l'auteur pour compléter la quatrième de couverture, ces variables sont utilisées par les macros définies dans `these-dbl.cls`
|
|
- Le `Makefile` vous aide à compiler le latex et la bibliographie en un pdf (détails plus bas)
|
|
- Les autres dossiers contiennent chacun un chapitre du document
|
|
|
|
|
|
### Remplir la première et quatrième de couverture
|
|
|
|
Les informations de la page de garde doivent être renseignées dans les variables du fichier `Couverture-these/pagedegarde.tex`.
|
|
Il suffit de modifier les lignes appelant les commandes `\ecoledoctorale{}` et `\etablissement{}` pour adapter les couvertures à l'école doctorale et à l'établissement, ou les établissements, délivrant le diplôme (par défaut MathSTIC et Université de Rennes 1, respectivement).
|
|
Le fichier `Couverture-these/README.md` liste Les écoles doctorales et établissements supportés ainsi que des liens vers les listes des spécialités et unités de recherche de chaque école doctorale pour aider à compléter la page de garde (commandes `\spec{}` et `\uniterecherche{}`).
|
|
Modifier la disposition des éléments de la page de garde présente dans `these-dbl.cls` ne devrait être nécessaire que pour rajouter quelques `\vspace` pour préserver la structure original après avoir renseigné les différents champs (e.g., spécialité, composition du jury).
|
|
|
|
Les variables relatives à la quatrième de couverture sont à renseigner dans `Couverture-these/resume.tex`.
|
|
|
|
|
|
### Dépendances
|
|
|
|
Une distribution LaTeX comme texlive est nécessaire pour compiler le document. À noter que certains paquets nécessaires à ce document ne sont pas toujours directement inclus dans une installation de base de texlive.
|
|
|
|
Paquets additionnels nécessaires :
|
|
|
|
- Fedora (installer avec `dnf install`)
|
|
- texlive-abstract
|
|
- texlive-wallpaper
|
|
- Autres distributions
|
|
- TODO (contributions bienvenues)
|
|
|
|
|
|
### Compiler le latex en pdf
|
|
|
|
Le `Makefile` fournis vous aide à compiler votre document.
|
|
Il utilise `pdflatex` et `biber` pour générer le fichier pdf et peut l'afficher grâce à `evince` sur Linux et `open` sur MacOS.
|
|
|
|
Compiler votre document avec `pdflatex/biber` :
|
|
|
|
make
|
|
|
|
Afficher le pdf généré :
|
|
|
|
make viewpdf
|
|
|
|
Suppimer tous les fichiers générés, pdf inclus :
|
|
|
|
make clean
|
|
|
|
|
|
### Spécificités d'un document multilingue
|
|
|
|
La liste des langues utilisées est définie dans `these-dbl.cls` où le paquet `babel` est importé.
|
|
Etant donné que la quatrième de couverture contient du français et de l'anglais, il est nécessaire de conserver au moins ces deux langues dans la liste.
|
|
Il faut utiliser `\selectlanguage{x}` (où x est `french` ou `english`) pour changer de langue après son insertion.
|
|
|
|
Si la langue principale du contenu du document est l'anglais, vous devez effectuer quelques modifications au modèle :
|
|
|
|
- remplacer `\selectlanguage{french}` par `\selectlanguage{english}` dans `main.tex`
|
|
- modifier la ligne 488 de `these-dbl.cls` pour remplacer `Partie` par `Part` dans les entêtes
|
|
- inclure un résumé en français d'au moins 4 pages
|
|
|
|
|
|
### Changer la police du contenu
|
|
|
|
La police imposée pour les couvertures est Arial mais vous pouvez utiliser une autre police pour le contenu de la thèse en redéfinissant les commandes `\rmdefault` et `\sfdefault` comme commenté dans `these-dbl.cls`.
|
|
Actuellement la police par défaut de latex est celle utilisée pour le contenu.
|
|
|
|
|
|
-----
|
|
|
|
#  Thesis template for Doctorat Bretagne Loire
|
|
|
|
*English explanations*
|
|
|
|
This repository contains a template for the thesis manuscript supporting all doctoral schools of the [École des docteurs Bretagne Loire](https://www.doctorat-bretagneloire.fr/).
|
|
|
|
The main goal of this template is to provide both front and back covers of the thesis manuscript entirely written in latex.
|
|
These covers have been (manually) reproduced from the original M$ Word model provided by MathSTIC in 2018, then generalized to all doctoral schools.
|
|
While the manuscript covers must follow the rules of DBL, the internal layout of the content is more flexible.
|
|
The content layout provided in this template is therefore given as an exemple rather than as a mandatory framework.
|
|
|
|
|
|
#### Structure of the repository
|
|
|
|
- `main.tex` contains the backbone structure of the document, no content is present in this file
|
|
- `these-dbl.cls` contains the package dependencies, bibliography parameters including citation style and overall layout specifications including both front and back cover layouts
|
|
- `Couverture-these/pagedegarde.tex` contains the variables that must be filled by the author to complete the front cover, these variables are used in `\maketitle` redefined in `these-dbl.cls`
|
|
- `Couverture-these/resume.tex` contains the variables that must be filled by the author to complete the back cover, these variables are used in the macros defined in `these-dbl.cls`
|
|
- The `Makefile` helps you compile the latex and bibliography into a pdf (details below)
|
|
- The rest of the directories each contain one chapter of the document
|
|
|
|
|
|
#### Fill the front and back cover
|
|
|
|
The front cover details must be provided by filling the variables in `Couverture-these/pagedegarde.tex`.
|
|
The lines calling the `\ecoledoctorale{}` and `\etablissement{}` (i.e., institution) commands must be modified to adapt the covers to the doctoral school and institution(s) delivering the diplome (by default set to MathSTIC and Université de Rennes 1, respectively).
|
|
The file `Couverture-these/README.md` lists the supported doctoral schools and institutions, and contains links pointing to lists of domains and labs/faculties, for each doctoral school, that are needed to fill the front cover (commands `\spec{}` and `\uniterecherche{}`).
|
|
Modifying the front cover layout defined in `these-dbl.cls` should only be necessary to preserve the original layout using a few `\vspace` after filling the front cover (e.g., domain, jury section).
|
|
|
|
The back cover variables that must be filled are in `Couverture-these/resume.tex`.
|
|
|
|
|
|
#### Dependencies
|
|
|
|
A LaTeX distribution such as texlive is necessary in order to compile your document. Please note some necessary packages are not directly included in a base texlive installation.
|
|
|
|
Required additional packages:
|
|
|
|
- Fedora (install using `dnf install`)
|
|
- texlive-abstract
|
|
- texlive-wallpaper
|
|
- Other distributions
|
|
- TODO (contributions welcome)
|
|
|
|
|
|
#### Compile latex into pdf
|
|
|
|
A `Makefile` is provided to help you compile your document. It uses `pdflatex` and`biber` to generate the pdf file and can display it by using `evince` on Linux or `open` on MacOS.
|
|
|
|
Compile your document with `pdflatex/biber`:
|
|
|
|
make
|
|
|
|
Display the generated pdf:
|
|
|
|
make viewpdf
|
|
|
|
Remove all generated files, pdf included:
|
|
|
|
make clean
|
|
|
|
|
|
#### Particularities of a multilanguage document
|
|
|
|
The list of used languages is defined in `these-dbl.cls` where the package `babel` is imported.
|
|
As the back cover contains both French and English, it is necessary to keep at least both these languages in the list.
|
|
Use `\selectlanguage{x}` (where x is `french` or `english`) to switch language after its usage.
|
|
|
|
If the main language of your document is English, you must apply the following changes to the provided template:
|
|
|
|
- replace `\selectlanguage{french}` by `\selectlanguage{english}` in `main.tex`
|
|
- edit line 488 of `these-dbl.cls` to replace `Partie` by `Part` in the headers
|
|
- include a summary in French of at least 4 pages
|
|
|
|
|
|
### Change the content font
|
|
|
|
The required font for the covers is Arial but you can use another font for the content of the thesis by redefining the commands `\rmdefault` and `\sfdefault` as commented out in `these-dbl.cls`.
|
|
Currently the latex default font is the one used for the content.
|
|
|
|
|
|
-----
|
|
|
|
#  Contribute
|
|
|
|
To propose changes, (1) you first have to request access to this repository (top page link, [HOWTO](https://docs.gitlab.com/ee/user/project/members/#project-membership-and-requesting-access)), (2) push your branch to this repository once access is granted, and finally (3) create a pull request with your proposed changes. Or just create an issue.
|
|
|
|
Maintainers: Pierre-Louis Roman (romanp@usi.ch).
|
|
|
|
Contributors: Louiza Yala (original & main developer), Josquin Debaz, Pierre-Louis Roman, Lucas Bourneuf, Corentin Guezenoc, Clément Elbaz, Florian Arrestier, Alexandre Honorat.
|
|
|
|
Upstream git repository: https://gitlab.inria.fr/ed-mathstic/latex-template
|
|
|
|
Previous upstream git repository (2019-2020): https://gitlab.inria.fr/proman/mathstic-thesis-template
|
|
|
|
Alternative repositories with a squashed history:
|
|
- https://github.com/remolaz/PhD_Thesis_Template_MathSTIC
|
|
- https://github.com/ahonorat/mathSTICtemplatePhD
|