summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/yathesis/french/documentation/corps/personnalisation.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/yathesis/french/documentation/corps/personnalisation.tex')
-rw-r--r--Master/texmf-dist/doc/latex/yathesis/french/documentation/corps/personnalisation.tex1171
1 files changed, 1171 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/yathesis/french/documentation/corps/personnalisation.tex b/Master/texmf-dist/doc/latex/yathesis/french/documentation/corps/personnalisation.tex
new file mode 100644
index 00000000000..7074badc45f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/yathesis/french/documentation/corps/personnalisation.tex
@@ -0,0 +1,1171 @@
+\chapter{Personnalisation}\label{cha-configuration}
+
+% Cette section passe en revue les outils de personnalisation propres ou pas à la
+% \yatCl{} :
+% \begin{enumerate}
+% \item options de classe ;
+% \item options de préambule ;
+% \item commandes (et options de commandes) de la \yatCl;
+% \item packages chargés par la \yatCl ;
+% \item packages chargés manuellement.
+% \end{enumerate}
+
+\section{Options de classe}\label{options-classe}
+\index{option!de \yatcl|(}
+
+Les \meta{options} de classe de la \yatCl sont à passer selon la syntaxe
+usuelle :
+\begin{preamblecode}
+\documentclass["\meta{options}"]{yathesis}
+\end{preamblecode}
+% Tester et documenter la commande |\yasetup|.
+
+% La \yatCl accepte, en sus des options qui lui sont propres, celles de la
+% \Class{book} sur laquelle est elle basée.
+
+\subsection{Options de la classe \textsf{book}}\label{sec-options-usuelles-de}
+\index{option!de la \Class{book}}
+
+Parmi les \meta{options} de \yatcl figurent celles de la \Class{book},
+notamment :
+\begin{itemize}
+\item\index{taille des caractères}%
+ \docAuxKey{10pt} (défaut), \docAuxKey{11pt}, \docAuxKey{12pt}, pour fixer
+ la taille de base des caractères ;
+\item éventuellement :
+ \begin{itemize}
+ \item\index{équation!numéro à gauche}%
+ \docAuxKey{leqno} pour afficher les numéros d'équations à gauche ;
+ \item\index{équation!alignement à gauche}%
+ \docAuxKey{fleqn} pour que les équations hors texte soient toutes
+ alignées à gauche avec un même retrait d'alinéa ;
+ \item%
+ \index{pagination}%
+ \indexsee{recto}{pagination}%
+ \indexsee{verso}{pagination}%
+ \docAuxKey{oneside} pour une \gls{pagination} en recto
+ seulement\footnote{Les chapitres commencent alors indifféremment sur une une
+ page paire ou impaire\index{page!paire/impaire} (c'est-à-dire sur une page
+ de gauche ou de droite\index{page!gauche/droite}).}.
+ \end{itemize}
+\end{itemize}
+\begin{dbwarning}{Options usuelles de la \Class{book} : à utiliser avec
+ discernement}{}
+ Dans le cadre d'un usage de la \yatCl, il est \emph{fortement} déconseillé de
+ recourir à d'autres options usuelles de la \Class{book} que celles
+ ci-dessus : cela risquerait de produire des résultats non souhaités.
+\end{dbwarning}
+
+% \subsection{Options de la \yatCl}\label{sec-options-yatCl}
+%
+% Les \meta{options} discutées dans cette section, propres à la \yatCl{},
+% permettent de contrôler les grandes lignes du document.
+
+\subsection{Langues (principale, secondaire, supplémentaires)}
+\label{sec-langues}%
+\index{langue}%
+\index{langue!principale}%
+\index{langue!secondaire}%
+\indexsee{français}{langue}%
+\indexsee{anglais}{langue}%
+
+Par défaut, un mémoire créé avec la \yatCl est composé :
+\begin{itemize}
+\item en français comme langue principale;
+\item en anglais comme langue secondaire\footnote{Utilisée ponctuellement pour
+ des éléments supplémentaires tels qu'une page de titre, un résumé ou des
+ mots clés.}.
+\end{itemize}
+%
+\begin{docKey}{mainlanguage}{=\docValue{french}\textbar\docValue{english}}{pas
+ de valeur par défaut, initialement \docValue{french}}
+ \indexdef{langue!principale}%
+ \indexdef{langue!secondaire}%
+ Pour que la langue principale \aside{et activée par défaut} soit l'anglais, il
+ suffit de le stipuler au moyen de l'option |mainlanguage=english|. Le français
+ devient alors automatiquement la langue secondaire.
+\end{docKey}
+
+\begin{dbwarning}{Langues principales et secondaires prises en charge}{}
+ Les seules langues \emph{principale} et \emph{secondaire} prises en charge
+ par la \yatCl sont le français (\docValue{french}) et l'anglais
+ (\docValue{english}).
+\end{dbwarning}
+
+\begin{dbremark}{Langues supplémentaires}{languessupplementaires}
+ \index{langue!supplémentaire}%
+ Il est cependant possible de faire usage de langues \emph{supplémentaires},
+ autres que le français et l'anglais, en les stipulant en option de
+ \docAuxCommand{documentclass}\footnote{Ces langues doivent être l'une de
+ celles supportées par le \Package{babel}.} et en les employant selon la
+ syntaxe du \Package*{babel}.
+\end{dbremark}
+
+\begin{dbexample}{Langue supplémentaire pour thèse
+ multilingue principalement en français}{}
+ \indexex{langue!supplémentaire}%
+ Pour composer un mémoire ayant pour langue principale le français et
+ supplémentaire l'espagnol \aside{cas par exemple d'une thèse en linguistique
+ espagnole}, il suffit de passer l'option suivante à la \yatCl{}.
+\begin{preamblecode}
+\documentclass[spanish]{yathesis}
+\end{preamblecode}
+\end{dbexample}
+
+\begin{dbexample}{Langue supplémentaire pour thèse
+ multilingue principalement en anglais}{}
+ \indexex{langue!principale}%
+ \indexex{langue!secondaire}%
+ \indexex{langue!supplémentaire}%
+ Pour composer un mémoire ayant pour langue principale l'anglais (donc
+ secondaire le français) et supplémentaire l'espagnol \aside{cas par exemple
+ d'une thèse en linguistique espagnole}, il suffit de passer les options
+ suivantes à la \yatCl{}.
+\begin{preamblecode}
+\documentclass[mainlanguage=english,spanish]{yathesis}
+\end{preamblecode}
+\end{dbexample}
+
+\subsection{Profondeur de la numérotation}\label{sec-profondeur-de-la}
+\index{profondeur!numérotation des paragraphes}%
+\index{numérotation!des paragraphes!profondeur}%
+
+Par défaut, la numérotation des paragraphes a pour \enquote{niveau de
+ profondeur} les sous-sections. Autrement dit, seuls les titres des parties
+(éventuelles), chapitres, sections et sous-sections sont numérotés. L'option
+\refKey{secnumdepth} suivante permet de spécifier un autre niveau de
+profondeur.
+%
+{%
+ \tcbset{before lower=\vspace*{\baselineskip}\par}
+ \begin{docKey}{secnumdepth}{=\docValue{part}\textbar\docValue{chapter}\textbar\docValue{section}\textbar\docValue{subsection}\textbar\docValue{subsubsection}\textbar\docValue{paragraph}\textbar\docValue{subparagraph}}{pas
+ de valeur par défaut, initialement \docValue{subsection}}
+ \indexdef{profondeur!numérotation des paragraphes}%
+ \indexdef{numérotation des paragraphes!profondeur}%
+ Cette clé permet de modifier le \enquote{niveau de profondeur} de la
+ numérotation des paragraphes jusqu'aux, respectivement : parties,
+ chapitres, sections, sous-sections, sous-sous-sections, paragraphes,
+ sous-paragraphes.
+ \end{docKey}
+}
+
+\subsection{Espace interligne}\label{sec-interligne}
+\index{espace!interligne}%
+
+L'interligne du document est par défaut \enquote{simple} mais, au moyen de
+l'option \refKey{space} suivante, il est possible de spécifier un interligne
+\enquote{un et demi} ou \enquote{double}.
+
+\begin{docKey}{space}{=\docValue{single}\textbar\docValue{onehalf}\textbar\docValue{double}}{pas de valeur par défaut,
+ initialement \docValue{single}}
+ \indexdef{espace!interligne}%
+ Cette clé permet de spécifier un interligne \docValue{single} (simple),
+ \docValue{onehalf} (un et demi) ou \docValue{double} (double).
+\end{docKey}
+
+\begin{dbwarning}{Option d'interligne : seulement dans la partie
+ principale}{space-setspace}
+ Contrairement à l'option \refKey{setspace} qui a un effet (semi-)global et
+ prend effet dès le début du document, l'option \refKey{space} ne prend effet
+ qu'à la partie principale du document (cf. \vref{cha-corps}) et se termine
+ avec elle, avant la partie annexe (cf. \vref{cha-annexes}).
+\end{dbwarning}
+
+Si on souhaite changer d'interligne ailleurs dans le mémoire, on recourra aux
+commandes du \Package*{setspace} \aside*{chargé par la \yatCl}.
+
+\subsection{Tables des matières locales automatiques}
+\label{sec-localtoc}%
+\index{table des matières!locale}%
+
+%
+\changes{v0.99o}{2016-10-30}{Nouvelle option de classe \protect\refKey{localtocs}
+ permettant de faire automatiquement débuter les chapitres par leurs tables des
+ matières locales}%
+
+\begin{docKey}[][doc new=2016-10-30]{localtocs}{}{pas de valeur par défaut, pas
+ de valeur initiale}
+ \indexdef{table des matières!locale}%
+ Cette clé fait automatiquement débuter les chapitres de la partie
+ principale\footnote{C'est-à-dire de \refCom{mainmatter} jusqu'à
+ \refCom{backmatter}.} par leurs tables des matières locales.
+\end{docKey}
+
+Par défaut, les tables des matières locales générées grâce à la clé
+\refKey{localtocs} ont comme \enquote{niveau de profondeur} les
+sous-sections\footnote{Ce niveau est donc par défaut identique à celui des
+ \hyperref[sec-table-des-matieres]{tables des matières
+ \enquote{globales}}.}. Il est possible d'en spécifier un autre grâce à la
+clé \refKey{localtocs/depth}.
+
+{%
+ \tcbset{before lower=\vspace*{.5\baselineskip}\par}
+ \begin{docKey}[][doc
+ new=2016-10-30]{localtocs/depth}{=\docValue{section}\textbar\docValue{subsection}\textbar\docValue{subsubsection}\textbar\docValue{paragraph}\textbar\docValue{subparagraph}}{par
+ défaut \docValue{subsection}, pas de valeur initiale}
+ \index{table des matières!locale!profondeur}%
+ \index{profondeur!table des matières!locale}%
+ Cette clé :
+ \begin{enumerate}
+ \item actionne la clé \refKey{localtocs} ;
+ \item modifie le \enquote{niveau de profondeur} des tables des matières
+ locales, respectivement jusqu'aux : sections, sous-sections,
+ sous-sous-sections, paragraphes, sous-paragraphes\footnote{La clé
+ \refKey{localtocs/depth} ne peut pas prendre comme valeurs
+ \docValue{part} ou \docValue{chapter} puisque les tables des matières
+ \emph{locales aux chapitres} ne peuvent être de \enquote{niveau de
+ profondeur} \emph{supérieur ou égal} aux chapitres.}.
+ \end{enumerate}
+
+\end{docKey}
+}
+
+\begin{dbexample}{Tables des matières locales automatiques}{}
+ \indexex{table des matières!locale}%
+ Pour que chaque chapitre de la partie principale du mémoire débute
+ automatiquement par sa table des matières locale, il suffit de passer l'option
+ suivante à la \yatCl{}.
+\begin{preamblecode}
+\documentclass[localtocs]{yathesis}
+\end{preamblecode}
+
+ Dans l'exemple précédent, les tables des matières locales vont jusqu'aux
+ sous-sections. Pour qu'elles aillent par exemple jusqu'aux sous-sous-sections,
+ on recourra à :
+\begin{preamblecode}
+\documentclass[localtocs/depth=subsubsection]{yathesis}
+\end{preamblecode}
+\end{dbexample}
+
+La \yatCl{} fournit aussi des commandes permettant d'activer ou de désactiver
+semi-globalement ou localement l'insertion automatique de tables des matières
+locales et ce, indépendamment du recours à l'option \refKey{localtocs}.
+
+\begin{docCommand}[doc new=2016-10-30]{startlocaltocs}{}
+ \index{table des matières!locale}%
+ Cette commande est une bascule \emph{activant} jusqu'à nouvel ordre
+ l'insertion automatique de tables des matières locales.
+\end{docCommand}
+
+\begin{docCommand}[doc new=2016-10-30]{stoplocaltocs}{}
+ \index{table des matières!locale}%
+ Cette commande est une bascule \emph{désactivant} jusqu'à nouvel ordre
+ l'insertion automatique de tables des matières locales.
+\end{docCommand}
+
+\begin{docCommand}[doc new=2016-10-30]{nextwithlocaltoc}{}
+ \index{table des matières!locale}%
+ Cette commande \emph{active}, pour le \emph{chapitre suivant seulement},
+ l'insertion automatique de tables des matières locales.
+\end{docCommand}
+
+\begin{docCommand}[doc new=2016-10-30]{nextwithoutlocaltoc}{}
+ \index{table des matières!locale}%
+ Cette commande \emph{désactive}, pour le \emph{chapitre suivant seulement},
+ l'insertion automatique de tables des matières locales.
+\end{docCommand}
+
+Les tables des matières locales sont introduites par une section (non numérotée)
+intitulée \translateexpression{localtocname}.
+
+\subsection{Bibliographies locales automatiques}
+\label{sec-localbibs}%
+\index{bibliographie!locale}%
+
+%
+\changes{v0.99o}{2016-10-30}{Nouvelle option de classe
+ \protect\refKey{localbibs} permettant de faire automatiquement finir les
+ chapitres par leurs bibliographies locales}%
+
+\begin{docKey}[][doc new=2016-10-30]{localbibs}{}{pas de valeur par défaut, pas
+ de valeur initiale}
+ \indexdef{bibliographie!locale}%
+ Cette clé fait automatiquement finir les chapitres (contenant au moins une
+ référence bibliographique) par leurs bibliographies locales.
+\end{docKey}
+
+\begin{docKey}[][doc new=2016-10-30]{localbibs*}{}{pas de valeur par défaut, pas
+ de valeur initiale}
+ \indexdef{bibliographie!locale}%
+ Cette clé a le même effet que \refKey{localbibs} sauf que l'option
+ \docAuxKey{defernumbers} du \Package*{biblatex} est alors
+ activée\footnote{Cf. la documentation de \package*{biblatex} pour plus de
+ détails sur cette option et éventuellement une discussion sur ses avantages
+ et inconvénients à \url{http://tex.stackexchange.com/q/332431/18401}.}.
+\end{docKey}
+
+\begin{dbwarning}{Package \package*{biblatex} nécessaire pour les bibliographies
+ locales}{}
+ Cette fonctionnalité d'ajout automatique des bibliographies locales en fin de
+ chapitres repose sur le \Package{biblatex} (cf. \vref{sec-refer-bibl}):
+ \begin{itemize}
+ \item donc nécessite, pour la bibliographie de la thèse, le recours à ce
+ package \alert{à l'exclusion de tout autre outil de production de
+ bibliographie} (notamment \hologo{BibTeX}) ;
+ \item notamment sur sa notion de segments de bibliographies et plus
+ particulièrement sur l'option |refsegment=chapter| qui devra être prise
+ compte si d'autres segments sont souhaités.
+ \end{itemize}
+\end{dbwarning}
+
+\begin{dbexample}{Bibliographies locales automatiques}{}
+ \indexex{bibliographie!locale}%
+ Pour que chaque chapitre finisse automatiquement par sa bibliographie locale,
+ il suffit de passer l'option suivante à la \yatCl{}.
+\begin{preamblecode}
+\documentclass[localbibs]{yathesis}
+\end{preamblecode}
+\end{dbexample}
+
+Les bibliographies locales sont introduites par une section (non numérotée)
+intitulée \translateexpression{localbibname}.
+
+\subsection{Versions du mémoire}\label{sec-versions}
+\index{version du mémoire}%
+
+Au moyen de la clé \refKey{version}, la \yatCl{} permet de facilement produire
+différentes versions du document : \enquote{intermédiaire} (par défaut),
+\enquote{à soumettre}, \enquote{finale} et \enquote{brouillon}.
+
+{\tcbset{before lower=\vspace*{\baselineskip}\par}
+ \begin{docKey}{version}{=\docValue{inprogress}\textbar\docValue{inprogress*}\textbar\docValue{submitted}\textbar\docValue{submitted*}\textbar\docValue{final}\textbar\docValue{draft}}{pas
+ de valeur par défaut, initialement \docValue{inprogress}}
+ \indexdef{version du mémoire}%
+ Cette clé permet de spécifier la version du document à produire, au moyen
+ des valeurs suivantes.
+ \begin{description}
+ \item[\docValue{inprogress}.]%
+ \indexdef{version du mémoire!intermédiaire}%
+ Cette valeur produit une version
+ \enquote{intermédiaire} du document\footnote{Une telle version est
+ éventuellement destinée à être diffusée à des relecteurs.}. Ses
+ caractéristiques sont les suivantes.
+ \begin{enumerate}
+ \item\label{item:inprogress:1} Pour indiquer clairement qu'il s'agit d'une
+ version \enquote{intermédiaire}, (presque) tous les pieds de
+ page\index{pied de page} contiennent en petites capitales la mention
+ \translateexpression{inprogressfoottext}.
+ \item\label{item:inprogress:2} Aucun élément \enquote{obligatoire}
+ (cf. \vref{sec-comm-oblig}) manquant n'est signalé.
+ \end{enumerate}
+ \item[\docValue{inprogress*}.]%
+ \indexdef{version du mémoire!intermédiaire}%
+ Cette valeur produit le même effet que la valeur \docValue{inprogress}
+ sauf que le caractère non définitif de la version est renforcé par la
+ mention \translateexpression{inprogress}, figurant en
+ filigrane\index{filigrane} et en capitales sur toutes les pages.
+ \item[\docValue{submitted}.]%
+ \indexdef{version du mémoire!soumise aux rapporteurs}%
+ Cette valeur produit une version du document
+ destinée à être \enquote{soumise} aux rapporteurs. \emph{Contrairement à}
+ la version par défaut :
+ \begin{enumerate}
+ \item l'affichage en pied de page\index{pied de page} de la mention
+ \enquote{Version intermédiaire en date du \meta{date du jour}} ou
+ \foreignquote{english}{Work in progress as of \meta{date du jour}} est
+ désactivé ;
+ \item \changes*{v0.99f}{2014-07-11}{En versions \enquote{à soumettre},
+ date de soutenance et composition du jury absentes des pages de titre
+ (et non obligatoires)}%
+ %
+ sur les pages de titre, la composition du jury est masquée et la date de
+ soutenance est supprimée\footnote{En versions soumises aux rapporteurs,
+ le doctorant ne peut préjuger ni d'un jury ni d'une date de
+ soutenance, ne sachant pas encore s'il va être autorisé à soutenir.} ;
+ \item tout élément \enquote{obligatoire} (cf. \vref{sec-comm-oblig})
+ manquant est signalé par une erreur de compilation\footnote{La date de
+ soutenance est normalement \enquote{obligatoire}, sauf dans les
+ versions soumises aux rapporteurs où elle ne figure nulle part.}.
+ \end{enumerate}
+ \item[\docValue{submitted*}.] %
+ \indexdef{version du mémoire!soumise aux rapporteurs}%
+ %
+ Cette valeur produit le même effet que la valeur \docValue{submitted} sauf
+ que le caractère \enquote{à soumettre} de la version est renforcé par
+ l'affichage, sur (presque) tous les pieds de pages\index{pied de page} et
+ en petites capitales, de la mention \enquote{Version soumise en date du
+ \meta{date}} ou \translateexpression{submittedfoottext}. Ici, la
+ \meta{date} est par défaut celle du jour, mais il est possible d'en
+ spécifier une autre au moyen de la commande \refCom{submissiondate}.
+ \item[\docValue{final}.]
+ \indexdef{version du mémoire!finale}%
+ Cette valeur produit une version \enquote{finale}
+ du document. \emph{Contrairement à} la version par défaut :
+ \begin{enumerate}
+ \item l'affichage en pied de page\index{pied de page} de la mention
+ \enquote{Version intermédiaire en date du \meta{date du jour}} ou
+ \foreignquote{english}{Work in progress as of \meta{date du jour}} est
+ désactivé ;
+ \item si un élément \enquote{obligatoire} (cf. \vref{sec-comm-oblig})
+ manque, une erreur de compilation signale l'omission.
+ \end{enumerate}
+ \item[\docValue{draft}.]
+ \indexdef{version du mémoire!brouillon}%
+ Cette valeur produit une version
+ \enquote{brouillon} du document\footnote{Une telle version est \emph{a
+ priori} à usage exclusif de l'utilisateur et n'est en particulier pas
+ destinée à être diffusée.}. Ses caractéristiques sont les suivantes :
+ \begin{itemize}
+ \item \emph{comme} la version par défaut, si un élément
+ \enquote{obligatoire} (cf. \vref{sec-comm-oblig}) manque, aucune erreur
+ de compilation ne signale l'omission ;
+ \item \emph{contrairement à} la version par défaut, la mention
+ \enquote{Version intermédiaire en date du \meta{date du jour}} ou
+ \foreignquote{english}{Work in progress as of \meta{date du jour}} ne
+ figure pas ;
+ \item \emph{en plus de} la version par défaut :
+ \begin{enumerate}
+ \item Les différentes zones de la page, notamment celle allouée au
+ texte, sont matérialisées et les dépassements de marges sont signalés
+ par une barre verticale noire dans la marge.
+ \item La mention \translateexpression{draft} figure en
+ filigrane\index{filigrane} (et en capitales) sur toutes les pages du
+ document.
+ \item Sur certaines pages, notamment celles de titre :
+ \begin{enumerate}
+ \item les données caractéristiques de la thèse\footnote{Auteur,
+ (sous-)titre, institut(s), directeurs, rapporteurs, examinateurs,
+ etc.} sont des hyperliens vers le fichier de configuration de la
+ thèse\footnote{Cf. \vref{sec-lieu-de-saisie}.} où il est possible de
+ les (re)définir (cf. \vref{sec-expressions-cles});
+ \item\label{item-expression} les expressions fournies par la
+ \yatCl\footnote{\enquote{Thèse présentée par},
+ \foreignquote{english}{In order to become Doctor from},
+ \foreignquote{english}{draft}, \enquote{Version intermédiaire en
+ date du}, etc. insérées de façon automatique sur certaines pages
+ du mémoire.} sont :
+ \begin{itemize}
+ \item estampillées du label qui les identifie;
+ \item des hyperliens vers le fichier de configuration de la thèse
+ (cf. \vref{rq-configurationfile}) où il est possible de les
+ (re)définir (cf. \vref{sec-expressions-cles}).
+ \end{itemize}
+ \end{enumerate}
+ Si le système d'exploitation est correctement configuré, un simple
+ clic sur ces hyperliens ouvre le fichier correspondant dans l'éditeur
+ de texte \LaTeX{} par défaut.
+ \end{enumerate}
+ \end{itemize}
+ \end{description}
+ \end{docKey}
+}
+
+Les versions \enquote{à soumettre} et \enquote{finale} d'un mémoire de thèse ne
+sont à produire qu'exceptionnellement, en toute fin de rédaction. De ce fait :
+\begin{dbwarning}{Par défaut, documents en version intermédiaire}{}
+ Un document composé avec la \yatCl{} est par défaut en version
+ \emph{intermédiaire}. Autrement dit, la clé \refKey{version} a pour valeur
+ initiale \docValue*{inprogress}.
+\end{dbwarning}
+
+\subsection{Formats de sortie}
+\label{sec-formats-de-sortie}
+\index{format du mémoire}%
+
+Les documents composés avec la \yatCl{} peuvent avoir deux formats de sortie :
+\enquote{écran} (par défaut) et \enquote{papier}, stipulés au moyen de la clé
+\refKey{output}.
+
+\begin{docKey}{output}{=\docValue{screen}\textbar\docValue{paper}\textbar\docValue{paper*}}{pas
+ de valeur par défaut, initialement \docValue{screen}}
+ \indexdef{format du mémoire}%
+ Cette clé permet de spécifier le format de sortie du document, au moyen des
+ valeurs suivantes.
+ \begin{description}
+ \item[\docValue{screen}.]%
+ \indexdef{format du mémoire!écran}%
+ Avec cette valeur, le document a un format de sortie destiné à être
+ visualisé à l'écran. Ce format ne présente pas de spécificités
+ particulières.
+ \item[\docValue{paper}.]%
+ \indexdef{format du mémoire!papier}%
+ Avec cette valeur, le document a un format de sortie
+ destiné à être imprimé sur papier. Les différences par rapport au format
+ \enquote{écran} sont les suivantes :
+ \begin{enumerate}
+ \item%
+ \index{lien hypertexte}%
+ si le \Package{hyperref} est chargé par l'utilisateur,
+ \begin{enumerate}
+ \item\label{item-paper-1}%
+ sa commande |\href{|\meta{\normalfont\ttfamily\acrshort*{url}}|}{|\meta{texte}|}| est
+ automatiquement remplacée par :
+ \lstset{deletekeywords={url},deletekeywords={[2]url}}%
+ \begin{itemize}
+ \item \meta{texte}\lstinline+\footnote{\url{+\meta{\normalfont\ttfamily\acrshort*{url}}|}}|
+ si elle figure dans le texte ordinaire ;
+ \item \meta{texte}
+ \lstinline[deletekeywords={[2]url}]+(\url{+\meta{\normalfont\ttfamily\acrshort*{url}}|})|
+ si elle figure en note de bas de page ;
+ \end{itemize}
+ \item les liens hypertextes sont systématiquement matérialisés comme le
+ fait par défaut le \Package{hyperref}, c'est-à-dire par des cadres
+ rectangulaires de couleurs (qui ne figurent pas sur le document
+ papier). Ainsi, si l'utilisateur recourt à la commande
+ |\hypersetup{colorlinks=true}| pour que, en sortie \enquote{écran}, les
+ hyperliens soient composés en couleur et non pas encadrés, il n'a pas
+ besoin de modifier ce choix pour que, en sortie \enquote{papier}, cette
+ coloration soit désactivée ;
+ \end{enumerate}
+ \item%
+ \label{item-paper-2}%
+ les barres de navigation affichées par certains styles de
+ glossaires\footnote{Telles qu'on peut en voir
+ \vref{fig-printacronyms,fig-printglossary}.} \emph{sont} masquées.
+ \end{enumerate}
+ \item[\docValue{paper*}.]%
+ \indexdef{format du mémoire!papier}%
+ Cette valeur produit le même effet que la valeur \docValue{paper} sauf que
+ son \vref{item-paper-2} est inversé : les barres de navigation \emph{ne}
+ sont \emph{pas} masquées.
+ \end{description}
+\end{docKey}
+
+\begin{dbwarning}{Mises en page éventuellement différentes en formats
+ \enquote{écran} et \enquote{papier}}{}
+ Du fait des \cref{item-paper-1,item-paper-2} précédents, les mises en page des
+ formats \enquote{écran} et \enquote{papier} peuvent être différentes, et il
+ pourra être opportun de les comparer, par exemple à l'aide d'un logiciel
+ comparateur de fichiers \acrshort{pdf}. Si on souhaite que les sorties
+ \enquote{écran} et \enquote{papier} soient absolument identiques, il suffit
+ d'imprimer la première ; mais il faut avoir conscience du fait que, dans ce
+ cas, si le mémoire contient des références vers des \acrshort{url} (par
+ exemple fournies par
+ |\href{|\meta{\normalfont\ttfamily\acrshort*{url}}|}{|\meta{texte}|}|), leurs
+ cibles ne figureront nulle part en sortie \enquote{papier}.
+\end{dbwarning}
+
+\subsection{Style des têtes de chapitres}\label{sec-style-des-tetes}
+
+Pour gérer les têtes de chapitres, la \yatCl{} s'appuie sur le
+\Package*{fncychap}, par défaut chargé avec le style \docValue{PetersLenny}. La
+clé \refKey{fncychap} suivante permet de spécifier un autre style de ce
+package\footnote{Par souci de compatibilité ascendante, la clé désormais
+ obsolète \docAuxKey{chap-style} est un alias de la clé
+ \refKey{fncychap}.}.%
+%
+{%
+ \tcbset{before lower=\vspace*{\baselineskip}\par}
+ \begin{docKey}{fncychap}{=\docValue{Sonny}\textbar\docValue{Lenny}\textbar\docValue{Glenn}\textbar\docValue{Conny}\textbar\docValue{Rejne}\textbar\docValue{Bjarne}\textbar\docValue{PetersLenny}\textbar\docValue{Bjornstrup}\textbar\docValue{none}}{pas
+ de valeur par défaut, initialement \docValue{PetersLenny}}
+ \index{chapitre!style de tête}%
+ \index{style!de tête de chapitre}%
+ \changes{v0.99g}{2014-07-13}{Clé \protect\refAux{chap-style} remplacée par
+ (et alias de) la clé \protect\refKey{fncychap}}%
+ %
+ Cette clé permet de spécifier un autre style du \Package{fncychap}.
+
+ Le \enquote{style} supplémentaire \docValue{none} permet de désactiver le
+ chargement de \package{fncychap} pour retrouver les têtes de chapitres
+ usuelles de la \Class{book}.
+ \end{docKey}
+}
+
+\subsection{Habilitations à diriger les recherches}
+\label{sec-hdr}%
+% \index{hdr (habilitation)@\acrshort{hdr} (habilitation)}%
+
+Grâce à sa clé \refKey{hdr}, la \yatCl{} peut être utilisée pour les
+habilitations à diriger les recherches.
+
+\begin{docKey}{hdr}{=\docValue{true}\textbar\docValue{false}}{par défaut
+ \docValue{true}, initialement \docValue{false}}
+ % \indexdef{hdr (habilitation)@\acrshort{hdr} (habilitation)}%
+ \changes{v0.99f}{2014-07-11}{Nouvelle clé \protect\refKey{hdr} permettant de
+ d'utiliser la \yatCl{} pour une habilitation à diriger les recherches}%
+ %
+ Cette clé spécifie que le mémoire est pour une habilitation à diriger les
+ recherches.
+\end{docKey}
+
+Le seul effet de la clé \refKey{hdr} est d'adapter un certain nombre
+d'expressions clés de la \yatCl{}, en remplaçant par exemple
+\enquote{\foreignlanguage{french}{\translate{thesisdefendedby}}} par
+\enquote{\foreignlanguage{french}{\translate{thesisdefendedby-hdr}}}. Les
+expressions propres aux habilitations à diriger les recherches sont celles dont
+les labels sont suffixés par \enquote{\texttt{-hdr}} dans le
+\vref{tab-expressions-cles}.
+
+\subsection{Expressions séparant corporations et affiliations des membres du jury}
+\label{sec-expr-separ-les}%
+\index{expression!séparant corporation et affiliation}%
+
+Sur les pages de titre, chaque membre du jury peut être précisé notamment par :
+\begin{itemize}
+\item sa corporation, cf. \refKey{professor}, \refKey{associateprofessor},
+ \refKey{associateprofessor*}, \refKey{seniorresearcher},
+ \refKey{juniorresearcher} et \refKey{juniorresearcher*} ;
+\item son affiliation, cf. \refKey{affiliation}.
+\end{itemize}
+Comme illustré \vref{fig-maketitle}, si ces deux précisions sont présentes,
+elles sont par défaut séparées :
+\begin{description}
+\item[en français] par l'une des deux expressions contextuelles suivantes :
+ \begin{itemize}
+ \item \enquote{\textvisiblespace{}à l'}\footnote{Le symbole
+ \enquote{\textvisiblespace{}} matérialise une espace.} ;
+ \item \enquote{\textvisiblespace{}au\textvisiblespace{}} ;
+ \end{itemize}
+ où l'article défini est automatiquement élidé selon l'initiale (voyelle ou
+ consonne) de l'affiliation ;
+\item[en anglais] par l'expression fixe (non contextuelle)
+ \enquote{\textvisiblespace{}at\textvisiblespace{}}.
+\end{description}
+
+\begin{dbwarning}{Élision automatique non robuste}{elision-separateurs}
+ \index{expression!élision}%
+ L'élision automatique des expressions contextuelles en français n'est pas
+ robuste : elle peut en effet ne pas donner le résultat escompté si la valeur
+ de la clé \refKey{affiliation}, définissant l'affiliation, a pour initiale :
+ \begin{itemize}
+ \item une consonne, mais est de genre féminin ;
+ \item une voyelle, mais par le truchement d'une commande\commandeacronyme, et
+ non pas \enquote{directement}.
+ \end{itemize}
+\end{dbwarning}
+
+Au moyen des clés \refKey{sepcorpaffilfrench} et \refKey{sepcorpaffilenglish}
+suivantes, les expressions séparatrices en français et en anglais peuvent être
+redéfinies, globalement ou localement.
+
+\begin{docKey}{sepcorpaffilfrench}{=\meta{expression}}{pas de valeur par défaut,
+ initialement \lstinline[showspaces]+\ +\texttt{à}\lstinline[showspaces]+\ +\texttt{l'} ou
+ \lstinline[showspaces]+\ au\ +}
+ \indexdef{expression!séparant corporation et affiliation}%
+ Cette option permet de redéfinir l'\meta{expression} employée en français pour
+ séparer les corporations et affiliations des membres du jury. Elle peut être
+ employée :
+ \begin{description}
+ \item[globalement:] elle est alors à spécifier en option de la classe de
+ document ;
+ \item[localement:] elle est alors à spécifier en option de l'une des
+ commandes de définition des membres du jury (cf.
+ \vref{sec-definition-jury}).
+ \end{description}
+\end{docKey}
+
+\begin{docKey}{sepcorpaffilenglish}{=\meta{expression}}{pas valeur par
+ défaut, initialement \lstinline[showspaces]+\ at\ +}
+ \indexdef{expression!séparant corporation et affiliation}%
+ Cette option, analogue à \refKey{sepcorpaffilfrench}, permet de redéfinir
+ l'\meta{expression} employée en anglais pour séparer les corporations et
+ affiliations des membres du jury.
+\end{docKey}
+
+\begin{dbwarning}{Expressions séparatrices débutant ou finissant par un espace}{}
+ Si les valeurs des clés \refKey{sepcorpaffilfrench} ou
+ \refKey{sepcorpaffilenglish} doivent \emph{débuter} ou \emph{finir} par un
+ espace, celui-ci doit être saisi au moyen de
+ %
+ \lstinline[showspaces]+\ +
+ %
+ % ou de
+ %
+ % \lstinline[deletekeywords={[2]space}]+\space+,
+ %
+ et non pas seulement de
+ %
+ \lstinline[showspaces]+ +.
+ %
+\end{dbwarning}
+
+\begin{dbexample}{Redéfinition (globale) de l'expression séparant corporations
+ et affiliations}{}
+ \indexex{expression!séparant corporation et affiliation}%
+ L'exemple suivant montre comment remplacer l'expression (par défaut) séparant
+ corporations et affiliations par une virgule, et ce :
+ \begin{itemize}
+ \item globalement pour tous les membres du jury;
+ \item en anglais.
+ \end{itemize}
+\begin{preamblecode}[listing options={showspaces}]
+\documentclass[sepcorpaffilenglish={,\ }]{yathesis}
+\end{preamblecode}
+\end{dbexample}
+
+\begin{dbexample}{Redéfinition (locale) de l'expression séparant corporation et
+ affiliation}{}
+ \indexex{expression!séparant corporation et affiliation}%
+ L'exemple suivant montre comment remplacer l'expression séparant corporation et
+ affiliation par \enquote{\textvisiblespace{}à la\textvisiblespace{}}, et ce :
+ \begin{itemize}
+ \item localement (pour un membre du jury particulier);
+ \item en français.
+ \end{itemize}
+\begin{bodycode}[listing options={showspaces}]
+\referee[professor,sepcorpaffilfrench=\ à la\ ,affiliation=Cité des sciences]{René}{Descartes}
+\end{bodycode}
+\end{dbexample}
+
+\subsection{Nombre de laboratoires sur les pages de résumés et de 4\ieme{} de couverture}
+\label{sec-nombre-de-labor}
+\index{résumé}%
+\index{quatrième de couverture}%
+
+Par défaut, seul le laboratoire principal (avec son adresse) est affiché sur les
+pages de résumés et de 4\ieme{} de couverture (cf. \vref{sec-abstract,sec-quatr-de-couv}). Mais la clé
+\refKey{numlaboratories} suivante permet de faire figurer un nombre arbitraire
+de laboratoires parmi ceux définis au moyen de la commande \refCom{laboratory}.%
+%
+\changes{v0.99j}{2014-07-18}{Nouvelle clé \protect\refKey{numlaboratories}
+ permettant de spécifier le nombre ($\geqslant 0$) de laboratoires devant
+ figurer sur les pages de résumés et de 4\ieme{} de couverture}%
+
+\begin{docKey}{numlaboratories}{=\meta{nombre}}{pas de valeur par
+ défaut, initialement \docValue*{1}}
+ \index{laboratoire!multiple!nombre}%
+ Cette clé permet de spécifier le \meta{nombre} (entier positif ou nul) de
+ laboratoires dont les noms et adresses doivent figurer sur la page de résumés
+ et de 4\ieme{} de couverture. Ces laboratoires sont pris dans l'ordre de
+ leurs définitions au moyen de la commande \refCom{laboratory}.
+\end{docKey}
+
+Pour gagner de la place sur les pages concernées, la composition des noms et
+adresses des laboratoires est un peu condensée si \meta{nombre} dépasse $1$.
+
+\section{Options à passer aux packages chargés par la \yatCl}
+\label{sec-options-passer-aux}%
+\index{option!de package chargé par \yatcl}%
+
+\changes{v0.99g}{2014-07-13}{Des options peuvent être passées aux packages
+ chargés par \yat{}}%
+%
+Pour plusieurs de ses fonctionnalités, la \yatCl s'appuie sur des packages
+(listés \vref{sec-packages-charges-par}) qu'elle charge automatiquement. Aussi
+son comportement par défaut et sa personnalisation sont-ils également gouvernés
+par le comportement par défaut et la personnalisation de ces packages.
+
+\begin{dbwarning}{Packages automatiquement chargés à ne pas charger
+ manuellement}{packages-a-ne-pas-charger}
+ Les packages qui sont automatiquement chargés par la \yatCl{} ne doivent pas
+ être chargés manuellement (au moyen de la commande
+ \docAuxCommand{usepackage}), sous peine de provoquer des conflits d'options
+ (tel que signalé à la \vref{faq-option-clash}).
+\end{dbwarning}
+
+De ce fait, la personnalisation des packages automatiquement chargés par le
+biais d'arguments optionnels passés à la commande \docAuxCommand{usepackage}
+n'est pas possible. Pour pallier cela, \yat{} fournit des options de classe
+permettant de passer à certains de ces packages une ou plusieurs options sous
+la forme d'une liste de clés/valeurs. Les packages concernés sont précisément
+ceux :
+\begin{itemize}
+\item (éventuellement) utiles à l'utilisateur final ;
+\item dont la personnalisation se fait habituellement par le biais d'options
+ à passer en argument optionnel de la commande \docAuxCommand{usepackage} (et
+ seulement par ce biais-là\footnote{En particulier, ne sont pas concernés les
+ packages dont les options peuvent être passées indifféremment en argument
+ optionnel de \protect\docAuxCommand{usepackage} ou au moyen d'une commande
+ de configuration propre ; il en est ainsi du \Package{bookmark} qui dispose
+ de la commande \protect\docAuxCommand*{bookmarksetup}.}).
+\end{itemize}
+Ces options, qui ont même nom que celui du package concerné, sont les suivantes
+(charge à l'utilisateur de consulter la documentation des packages concernés
+pour savoir s'ils peuvent lui être utiles et, le cas échéant, quelles valeurs
+peuvent être passées à leurs options).
+
+\begin{docKey}{graphicx}{=\marg{option(s)}}{pas valeur par défaut,
+ initialement vide}
+ \index{option!de package chargé par \yatcl!graphicx@\package*{graphicx}}%
+ Cette option permet de passer une ou plusieurs \meta{option(s)} au
+ \Package{graphicx}.
+\end{docKey}
+\begin{docKey}{adjustbox}{=\marg{option(s)}}{pas valeur par défaut,
+ initialement \docValue*{export}}
+ \index{option!de package chargé par \yatcl!adjustbox@\package*{adjustbox}}%
+ Cette option permet de passer une ou plusieurs \meta{option(s)} au
+ \Package{adjustbox}.
+\end{docKey}
+\begin{docKey}{setspace}{=\marg{option(s)}}{pas valeur par défaut,
+ initialement vide}
+ \index{option!de package chargé par \yatcl!setspace@\package*{setspace}}%
+ Cette option permet de passer une ou plusieurs \meta{option(s)} au
+ \Package{setspace}.
+
+ Contrairement à l'option \refKey{space} qui ne prend effet qu'à la partie
+ principale du document et se termine avec elle, l'option \refKey{setspace}
+ a un effet (semi-)global et prend effet dès le début du document
+ (cf. \vref{wa-space-setspace}).
+\end{docKey}
+\begin{docKey}{xcolor}{=\marg{option(s)}}{pas valeur par défaut,
+ initialement vide}
+ \index{option!de package chargé par \yatcl!xcolor@\package*{xcolor}}%
+ Cette option permet de passer une ou plusieurs \meta{option(s)} au
+ \Package{xcolor}.
+\end{docKey}
+\begin{docKey}{datatool}{=\marg{option(s)}}{pas valeur par défaut,
+ initialement vide}
+ \index{option!de package chargé par \yatcl!datatool@\package*{datatool}}%
+ Cette option permet de passer une ou plusieurs \meta{option(s)} au
+ \Package{datatool}.
+\end{docKey}
+\begin{docKey}{titleps}{=\marg{option(s)}}{pas valeur par défaut, initialement
+ vide}
+ \index{option!de package chargé par \yatcl!titleps@\package*{titleps}}%
+ % \changes{v0.99j}{2014-07-18}{Clé \protect\refAux{titleps} remplacée par
+ % (et alias de) la clé \protect\refKey{titlesec}}%
+ Cette option permet de passer une ou plusieurs \meta{option(s)} au
+ \Package{titleps}.
+\end{docKey}
+\begin{docKey}{draftwatermark}{=\marg{option(s)}}{pas valeur par défaut,
+ initialement vide}
+ \index{option!de package chargé par
+ \yatcl!draftwatermark@\package*{draftwatermark}}%
+ Cette option permet de passer une ou plusieurs \meta{option(s)} au
+ \Package{draftwatermark}.
+\end{docKey}
+\begin{docKey}{babel}{=\marg{option(s)}}{pas valeur par défaut,
+ initialement vide}
+ \index{option!de package chargé par \yatcl!babel@\package*{babel}}%
+ Cette option permet de passer une ou plusieurs \meta{option(s)} au
+ \Package{babel}.
+\end{docKey}
+\begin{docKey}{datetime}{=\marg{option(s)}}{pas valeur par défaut,
+ initialement \docValue*{nodayofweek}}
+ \index{option!de package chargé par \yatcl!datetime@\package*{datetime}}%
+ Cette option permet de passer une ou plusieurs \meta{option(s)} au
+ \Package{datetime}.
+\end{docKey}
+%
+\changes*{v0.99k}{2014-10-01}{%
+ Option de classe \protect\docAuxKey*{bookmark} supprimée%
+}%
+
+\begin{dbexample}{Passage d'options à un package automatiquement chargés par \yat}{}
+ L'exemple suivant montre comment passer au \Package{xcolor} les options
+ \docValue*{dvipsnames} et \docValue*{table}.
+\begin{preamblecode}[listing options={showspaces}]
+\documentclass[xcolor={dvipsnames,table}]{yathesis}
+\end{preamblecode}
+\end{dbexample}
+
+% \section{Options de préambule}
+% \label{sec-options-de-preambule}
+%
+% Pour des raisons techniques, les options de la \yatCl listées à la
+% \vref{options-classe}, ne peuvent être passées qu'en argument optionnel de
+% \docAuxCommand{documentclass}. Les options de la présente section peuvent être
+% passées indifféremment :
+% \begin{itemize}
+% \item en argument optionnel de \docAuxCommand{documentclass} ;
+% \item en préambule, en argument de la commande \refCom{yadsetup}.
+% \end{itemize}
+%
+% \begin{docCommand}{yadsetup}{\marg{options}}
+% Cette commande permet de spécifier certaines \meta{options} de la \yatCl.
+% \end{docCommand}
+%
+% \subsection{Profondeur de la numérotation}\label{sec-profondeur-de-la}
+% \index{profondeur!numérotation des paragraphes}%
+% \index{numérotation!des paragraphes!profondeur}%
+%
+% Par défaut, la numérotation des paragraphes a pour \enquote{niveau de
+% profondeur} les sous-sections. Autrement dit, seuls les titres des parties
+% (éventuelles), chapitres, sections et sous-sections sont numérotés. L'option
+% \refKey{secnumdepth} suivante permet de spécifier un autre niveau de
+% profondeur.
+% %
+% {%
+% \tcbset{before lower=\vspace*{\baselineskip}\par}
+% \begin{docKey}{secnumdepth}{=\docValue{part}\textbar\docValue{chapter}\textbar\docValue{section}\textbar\docValue{subsection}\textbar\docValue{subsubsection}\textbar\docValue{paragraph}\textbar\docValue{subparagraph}}{pas
+% de valeur par défaut, initialement \docValue{subsection}}
+% \indexdef{profondeur!numérotation des paragraphes}%
+% \indexdef{numérotation des paragraphes!profondeur}%
+% Cette clé permet de modifier le \enquote{niveau de profondeur} de la
+% numérotation des paragraphes jusqu'aux, respectivement : parties,
+% chapitres, sections, sous-sections, sous-sous-sections, paragraphes,
+% sous-paragraphes.
+% \end{docKey}
+% }
+%
+% \subsection{Espace interligne}\label{sec-interligne}
+% \index{espace!interligne}%
+%
+% L'interligne du document est par défaut \enquote{simple} mais, au moyen de
+% l'option \refKey{space} suivante, il est possible de spécifier un interligne
+% \enquote{un et demi} ou \enquote{double}.
+%
+% \begin{docKey}{space}{=\docValue{single}\textbar\docValue{onehalf}\textbar\docValue{double}}{pas de valeur par défaut,
+% initialement \docValue{single}}
+% \indexdef{espace!interligne}%
+% Cette clé permet de spécifier un interligne \docValue{single} (simple),
+% \docValue{onehalf} (un et demi) ou \docValue{double} (double).
+% \end{docKey}
+%
+% \begin{dbwarning}{Option d'interligne : seulement dans la partie
+% principale}{space-setspace}
+% Contrairement à l'option \refKey{setspace} qui a un effet (semi-)global et
+% prend effet dès le début du document, l'option \refKey{space} ne prend effet
+% qu'à la partie principale du document (cf. \vref{cha-corps}) et se termine
+% avec elle, avant la partie annexe (cf. \vref{cha-annexes}).
+% \end{dbwarning}
+%
+% Si on souhaite changer d'interligne ailleurs dans le mémoire, on recourra aux
+% commandes du \Package*{setspace} \aside*{chargé par la \yatCl}.
+
+\section{Commandes et options de commandes de la \yatCl}
+\index{commandes de personnalisation!lieu de spécification}%
+\index{option!de \yatcl!lieu de spécification}%
+
+\begin{dbremark}{Lieu des commandes de personnalisation}{configurationfile}
+ Les commandes de personnalisation listées dans cette section (et donc propres
+ à \yatCl{}) ou fournies par les packages chargés manuellement peuvent être
+ saisies :
+ \begin{itemize}
+ \item soit directement dans le (préambule du) fichier (maître) de la thèse ;
+ \item%
+ \index{fichier!de configuration de \yatcl}%
+ \index{dossier!de configuration}%
+ soit dans un fichier (prévu à cet effet) à nommer \file{\configurationfile}
+ et à placer dans un sous-dossier (prévu à cet effet) à nommer
+ \folder{\configurationdirectory}\footnote{Ces fichier et sous-dossier sont
+ à créer au besoin mais le canevas de thèse \enquote{en arborescence} livré
+ avec la \yatCl, décrit \vref{sec-canevas-arborescence}, les fournit.}.
+ \end{itemize}
+\end{dbremark}
+
+\begin{dbwarning}{Fichier de configuration à ne pas importer manuellement}{}
+ Le \File{\configurationfile} est \emph{automatiquement} importé par la
+ \yatCl{} et il doit donc \emph{ne pas} être explicitement importé : on
+ \emph{ne} recourra donc \emph{pas} à la commande
+ |\input{|\file{\configurationfile}|}| (ou autre commande d'importation
+ similaire à \docAuxCommand{input}).
+\end{dbwarning}
+
+\subsection{(Re)Définition des expressions de la
+ thèse}\label{sec-expressions-cles}%
+\index{expression!(re)définition}%
+
+Un mémoire de thèse composé avec la \yatCl est émaillé d'expressions insérées
+de façon automatique sur certaines pages (titre, mots clés, laboratoire,
+résumés, etc.). Que ces expressions soient définies par la \yatCl ou bien
+standard, il est possible de les redéfinir.
+
+\subsubsection{Expressions définies par la classe}
+\label{sec-expr-defin-par}%
+\index{expression!redéfinition}%
+
+Les expressions \meta{en français} et \meta{en anglais} définies par la \yatCl
+sont listées\footnote{Et classées par ordre alphabétique des expressions
+ \meta{en français}.} dans le \vref{tab-expressions-cles} et y sont identifiées
+par un \meta{label} permettant de les redéfinir (voire de les définir, cf.
+\vref{ex-doctor}) au moyen de la commande \refCom{expression} suivante.
+%
+\begin{docCommand}{expression}{\marg{label}\marg{en français}\marg{en anglais}}
+ \indexdef{expression!redéfinition}%
+ Cette commande permet de redéfinir les valeurs \meta{en français} et
+ \meta{en anglais} de l'expression identifiée par \meta{label}.
+\end{docCommand}
+%
+\bgroup
+\renewcommand{\expression}[3]{%
+ \ifthenelse{\isempty{#2}}{%
+ \meta{vide}%
+ }{%
+ #2%
+ }%
+ &
+ \ifthenelse{\isempty{#3}}{%
+ \meta{vide}%
+ }{%
+ #3%
+ }%
+ &
+ #1%
+ \\%
+ % \midrule%
+}
+%
+% \footnotesize%
+\small%
+\LTXtable{\textwidth}{tableaux/expressions}%
+\egroup
+%
+\begin{dbexample}{Modification d'expression définie par la classe}{}
+ \indexex{expression!redéfinition}%
+ Pour remplacer l'expression en français \enquote{Unit\'e de recherche} (dont le label est
+ |universitydepartment|) par \enquote{Laboratoire}, il suffit de
+ saisir :
+ %
+\begin{preamblecode}[title=Par exemple dans le \File{\configurationfile}]
+\expression{universitydepartment}{Laboratoire}{University Department}
+\end{preamblecode}
+\end{dbexample}
+%
+\begin{dbexample}{Suppression d'expression définie par la classe}{}
+ \indexex{expression!redéfinition}%
+ Si on souhaite supprimer des pages de titre les mentions \enquote{Titre de la
+ thèse} et \foreignquote{english}{Thesis Title} (expressions dont le label
+ est |thesistitle|), il suffit de saisir :
+\begin{preamblecode}[title=Par exemple dans le \File{\configurationfile}]
+\expression{thesistitle}{}{}
+\end{preamblecode}
+\end{dbexample}
+
+\begin{dbremark}{Modification d'expressions facilitée par la version
+ \enquote{brouillon}}{}
+ On a vu \vref{sec-versions} que l'option
+ \lstinline[deletekeywords={version}]|version=draft| permet de facilement
+ retrouver les labels des expressions et atteindre le \File{\configurationfile}
+ pour y modifier celles-ci.
+\end{dbremark}
+
+\subsubsection{Expressions standard}
+\label{sec-expressions-standard}%
+\index{expression!redéfinition}%
+
+Le \vref{tab-expressions-standard} liste les expressions \LaTeX{} standard
+telles que traduites par la \yatCl{}. Il s'agit en fait des traductions en
+français et en anglais fournies par les modules \package*+{frenchb} et
+\package*+{english} du \Package{babel}, à l'exception de l'expression française
+figurant en légende des tableaux flottants (\enquote{Table} est remplacée par
+\enquote{Tableau}).%
+\changes*{v0.99j}{2014-07-18}{Les légendes des tableaux flottants sont
+ introduites par l'expression \enquote{\textsc{Tableau}} et non plus plus
+ \enquote{\textsc{Table}}}%
+
+Si on souhaite redéfinir ces expressions, il suffit de recourir aux commandes
+|\addto|, |\captionsfrench| et |\captionsenglish| du \Package{babel} au moyen
+de la syntaxe suivante.
+
+\begin{preamblecode}[title=Par exemple dans le \File{\configurationfile}]
+\addto\captionsfrench{\def\"\meta{commande}"{"\meta{en français}"}}
+\addto\captionsenglish{\def\"\meta{commande}"{"\meta{en anglais}"}}
+\end{preamblecode}
+\begin{table}[hb]
+ \centering
+ \caption{Valeurs et commandes d'expressions \LaTeX{} standard fournies par la \yatCl{}}
+ \label{tab-expressions-standard}
+ \input{tableaux/expressions-standard}
+\end{table}
+%
+\begin{dbexample}{Redéfinition d'expressions du \Package{babel}}{}
+ \indexex{expression!redéfinition}%
+ \indexex{nom!résumé}%
+\begin{preamblecode}[title=Redéfinition des expressions pour les résumés]
+\addto\captionsfrench{\def\abstractname{Aperçu de notre travail}}
+\addto\captionsenglish{\def\abstractname{Overview of our work}}
+\end{preamblecode}
+\end{dbexample}
+
+En cas d'usage des packages \package{glossaries} et \package{biblatex}, la
+syntaxe précédente est inopérante avec les commandes
+\docAuxCommand{glossaryname} et \docAuxCommand{bibname} (ainsi que
+\docAuxCommand{refname}). Dans ce cas, pour donner un \meta{titre} (ou
+\meta{nom}) \meta{alternatif} :
+\begin{itemize}
+\item%
+ \index{nom!glossaire}%
+ \index{nom!liste d'acronymes}%
+ \index{nom!liste de symboles}%
+ aux glossaire(s), liste d'acronymes et liste de symboles, on recourra
+ à l'une ou l'autre des instructions suivantes :
+\begin{bodycode}[listing options={deletekeywords={title}}]
+\printglossary[title="\meta{titre alternatif}"]
+\printglossaries[title="\meta{titre alternatif}"]
+\printacronyms[title="\meta{titre alternatif}"]
+\printsymbols[title="\meta{titre alternatif}"]
+\end{bodycode}
+\item%
+ \index{nom!bibliographie}%
+ à la bibliographie, on recourra à :
+\begin{bodycode}[listing options={deletekeywords={title}}]
+\printbibliography[title="\meta{titre alternatif}"]
+\end{bodycode}
+\end{itemize}
+
+En outre, en cas d'usage du \Package*{listings}, un \meta{titre alternatif}
+pourra être donné à la liste des listings, au moyen de:
+\begin{preamblecode}[title=Par exemple dans le \File{\configurationfile}]
+\renewcommand\lstlistingname{"\meta{titre alternatif}"}
+\end{preamblecode}
+
+\subsection{Nouvelles corporations}\label{sec-nouveaux-corps}
+\index{corporation!non prédéfinie}%
+\index{expression!définition!corporation}%
+
+On a vu \vref{sec-jury} que des options des commandes définissant les
+directeurs de thèse et membres du jury permettent de spécifier si ceux-ci
+appartiennent aux corporations \emph{prédéfinies} :
+\begin{itemize}
+\item des professeurs ou des maîtres de conférences (\glspl{hdrpeople} ou pas) des
+ universités ;
+\item des directeurs de recherche ou des chargé(e)s de recherche (\glspl{hdrpeople} ou
+ pas) du \gls{cnrs}.
+\end{itemize}
+La clé \refKey{corps} suivante permet de spécifier de \emph{nouvelles}
+corporations (ou nouveaux corps) à \emph{définir} au moyen de la commande
+\refCom{expression}.
+
+\begin{docKey}{corps}{=\meta{label}}{pas de valeur par défaut, initialement
+ vide}
+ \indexdef{expression!définition!corporation}%
+ \changes{v0.99e}{2014-06-15}{Clé \protect\refAux{corporation} remplacée par
+ (et alias de) la clé \protect\refKey{corps}}%
+ %
+ L'option |corps=|\meta{label} permet de stipuler une \meta{corporation en
+ français} et une \meta{corporation en anglais} où \meta{label} identifie une
+ expression listée au \vref{tab-expressions-cles} ou à définir au moyen de la
+ commande \refCom{expression}.
+\end{docKey}
+
+\begin{dbexample}{Nouvelle corporation}{doctor}
+ \indexex{expression!définition}%
+ \indexex{expression!non prédéfinie}%
+ \indexex{corporation!non prédéfinie}%
+ Si on souhaite spécifier que certains membres du jury sont docteurs, il
+ suffit de définir \aside{une seule fois} l'expression suivante de label (par
+ exemple) |doctor| :
+\begin{preamblecode}[title=Par exemple dans le \File{\configurationfile}]
+\expression{doctor}{docteur}{Doctor}
+\end{preamblecode}
+ pour pouvoir ensuite l'utiliser \aside{autant de fois que souhaité}, par
+ exemple ainsi :
+\begin{bodycode}
+\examiner[corps=doctor]{Joseph}{Fourier}
+\examiner[corps=doctor]{Paul}{Verlaine}
+\end{bodycode}
+\end{dbexample}
+
+\subsection{Nouveaux rôles}\label{sec-nouveaux-roles}
+\index{rôle!non prédéfini}%
+\index{expression!définition!rôle}%
+
+On a pu noter \vref{sec-jury} que des rôles, figurant automatiquement sur les
+pages de titre, sont attachés :
+\begin{itemize}
+\item aux directeurs de thèse définis au moyen des commandes
+ \refCom{supervisor}, \refCom{cosupervisor} et \refCom{comonitor} :
+ \enquote{directeur}, \enquote{co-directeur} et \enquote{co-encadrant} ;
+\item au président du jury défini au moyen de la commande
+ \refCom{committeepresident} : \enquote{président du jury}.
+\end{itemize}
+La clé \refKey{role} suivante permet de spécifier de \emph{nouveaux} rôles
+à \emph{définir} au moyen de la commande \refCom{expression}.
+
+% Il est même possible de \emph{définir} de \emph{nouveaux} rôles au moyen
+% de la commande \refCom{expression}.
+
+\begin{docKey}{role}{=\meta{label}}{pas de valeur par défaut, initialement
+ vide}
+ \indexdef{expression!définition!rôle}%
+ \changes{v0.99f}{2014-07-11}{Nouvelle clé \protect\refKey{role} permettant de
+ spécifier ou définir de nouveaux rôles pour les personnes}%
+ %
+ L'option |role=|\meta{label} permet de stipuler un \meta{rôle en français} et
+ un \meta{rôle en anglais} où \meta{label} identifie une expression listée au
+ \vref{tab-expressions-cles} ou à définir au moyen de la commande
+ \refCom{expression}.
+\end{docKey}
+\index{option!de \yatcl|)}
+
+\section{Packages chargés manuellement}
+\label{sec-options-de-classes}
+Si on souhaite recourir à des packages qui ne sont pas appelés par la \yatCl{},
+on les chargera manuellement, par exemple en préambule du fichier (maître) de
+la thèse.
+
+%%% Local Variables:
+%%% mode: latex
+%%% TeX-master: "../yathesis-fr"
+%%% End: