diff options
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.tex | 1171 |
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: |