\chapter{Usage avancé}\label{cha-usage-avance} \section{(Dés)Activation des erreurs ciblées propres aux éléments \enquote{obligatoires}}\label{sec-desact-des-erre} On a vu \vref{sec-comm-oblig} que la \yatcl{} considère comme \enquote{obligatoires} certains éléments (commandes et environnements) et que, parmi eux, certains ne le sont que modérément. La liste complète de ces derniers figure à la 1\iere{} colonne du \vref{tab-no-warnings}. \begin{table}[ht] \centering \caption[Éléments modérément \enquote{obligatoires} et désactivation des erreurs associées]{Éléments modérément \enquote{obligatoires} et options de désactivation des erreurs ciblées associées} \label{tab-no-warnings} \input{tableaux/no-warnings} \end{table} Cependant, au cours de la rédaction, certains éléments \enquote{obligatoires} de la thèse ne sont pas encore connus de l'utilisateur, par exemple la date de soutenance (commande \refCom{date}). % ^^A De ce fait, le signalement des éléments \enquote{obligatoires} manquants est : \begin{description} \item[désactivé] par défaut\footnote{C'est-à-dire en version intermédiaire du document (cf. valeur initiale \docValue{inprogress} de la clé \refKey{version}). Le signalement est également désactivé en versions intermédiaire alternative et brouillon (cf. valeurs \docValue{inprogress*} et \docValue{draft} de la clé \refKey{version}).} ; \item[activé] (seulement) en versions \enquote{à soumettre}\footnote{Cf. valeurs \docValue{submitted} et \docValue{submitted*} de la clé \refKey{version}.} et \emph{finale}\footnote{Cf. valeur \docValue{final} de la clé \refKey{version}.} du document, par le biais d'une erreur ciblée, émise à chaque compilation. \end{description} Or, l'utilisateur \emph{avancé} peut vouloir passer outre le caractère \enquote{obligatoire} de tel ou tel élément\footnote{Par exemple, il peut juger inutile de faire figurer des mots clés dans sa thèse et donc vouloir passer outre la commande \enquote{obligatoire} \protect\refCom{keywords}.}, y compris en versions à soumettre ou finale du document, et pour éviter que chaque compilation ne soit alors perturbée par les erreurs ciblées correspondantes, la \yatcl{} propose de désactiver ces erreurs de façon : \begin{description} \item[soit globale] au moyen de la clé \refKey{noerror} suivante. \begin{docKey}{noerror}{=\docValue{true}\textbar\docValue{false}}{par défaut \docValue{true}, initialement \docValue{true}} Cette option est en sous-main initialement égale à \docValue{true}, et devient automatiquement égale à \docValue{false} si la clé \refKey{version} a pour valeur \docValue{submitted}, \docValue{submitted*} ou \docValue{final}. L'employer la rend égale à \docValue{true} et désactive donc, dans tous les cas, toutes les erreurs propres à la \yatcl{}. \end{docKey} \item[soit individuelle] au moyen des clés listées au \vref{tab-no-warnings} et dont le rôle est précisé ci-après. \begin{docKey}{noauthor}{=\docValue{true}\textbar\docValue{false}}{par défaut \docValue{true}, initialement \docValue{false}} Cette option désactive l'erreur émise si la commande \refCom{author} est omise (ou à arguments obligatoires vides). \end{docKey} \begin{docKey}{notitle}{=\docValue{true}\textbar\docValue{false}}{par défaut \docValue{true}, initialement \docValue{false}} Cette option désactive l'erreur émise si la commande \refCom{title} est omise (ou à argument obligatoire vide). \end{docKey} \begin{docKey}{noacademicfield}{=\docValue{true}\textbar\docValue{false}}{par défaut \docValue{true}, initialement \docValue{false}} Cette option désactive l'erreur émise si la commande \refCom{academicfield} est omise (ou à argument obligatoire vide). \end{docKey} \begin{docKey}{nodate}{=\docValue{true}\textbar\docValue{false}}{par défaut \docValue{true}, initialement \docValue{false}} Cette option désactive l'erreur émise si la commande \refCom{date} est omise (ou à arguments obligatoires vides ou incorrects)\footnote{La commande \refCom{date} n'est en fait pas \enquote{obligatoire} en versions \enquote{à soumettre} (valeurs \docValue{submitted} et \docValue{submitted*} de la clé \refKey{version}).}. \end{docKey} \begin{docKey}{noinstitute}{=\docValue{true}\textbar\docValue{false}}{par défaut \docValue{true}, initialement \docValue{false}} Cette option désactive l'erreur émise si la commande \refCom{institute} est omise (ou à argument obligatoire vide). \end{docKey} \begin{docKey}{nodoctoralschool}{=\docValue{true}\textbar\docValue{false}}{par défaut \docValue{true}, initialement \docValue{false}} Cette option désactive l'erreur émise si la commande \refCom{doctoralschool} est omise (ou à argument obligatoire vide). \end{docKey} \begin{docKey}{nolaboratory}{=\docValue{true}\textbar\docValue{false}}{par défaut \docValue{true}, initialement \docValue{false}} Cette option désactive l'erreur émise si la commande \refCom{laboratory} est omise (ou à 1\ier{} argument obligatoire vide). \end{docKey} \begin{docKey}{nolaboratoryadress}{=\docValue{true}\textbar\docValue{false}}{par défaut \docValue{true}, initialement \docValue{false}} Cette option désactive l'erreur émise si la commande \refCom{laboratory} est omise (ou à 2\ieme{} argument obligatoire vide). \end{docKey} \begin{docKey}{nosupervisor}{=\docValue{true}\textbar\docValue{false}}{par défaut \docValue{true}, initialement \docValue{false}} Cette option désactive l'erreur émise si la commande \refCom{supervisor} est omise (ou à argument obligatoire vide). \end{docKey} \begin{docKey}{nomaketitle}{=\docValue{true}\textbar\docValue{false}}{par défaut \docValue{true}, initialement \docValue{false}} Cette option désactive l'erreur émise si la commande \refCom{maketitle} est omise. \end{docKey} \begin{docKey}{nokeywords}{=\docValue{true}\textbar\docValue{false}}{par défaut \docValue{true}, initialement \docValue{false}} Cette option désactive l'erreur émise si la commande \refCom{keywords} est omise (ou à arguments obligatoires vides). \end{docKey} \begin{docKey}{noabstract}{=\docValue{true}\textbar\docValue{false}}{par défaut \docValue{true}, initialement \docValue{false}} Cette option désactive l'erreur émise si l'environnement \refEnv{abstract} est omis (ou à contenu vide). \end{docKey} \begin{docKey}{nomakeabstract}{=\docValue{true}\textbar\docValue{false}}{par défaut \docValue{true}, initialement \docValue{false}} Cette option désactive l'erreur émise si la commande \refCom{makeabstract} est omise. \end{docKey} \begin{docKey}{notableofcontents}{=\docValue{true}\textbar\docValue{false}}{par défaut \docValue{true}, initialement \docValue{false}} Cette option désactive l'erreur émise si la commande \refCom{tableofcontents} est omise. \end{docKey} \begin{docKey}{noprintbibliography}{=\docValue{true}\textbar\docValue{false}}{par défaut \docValue{true}, initialement \docValue{false}} Cette option désactive l'erreur émise si la commande \refCom{printbibliography} est omise. \end{docKey} \end{description} \begin{dbwarning}{Éléments \enquote{obligatoires} : modérément obligatoires mais fortement conseillés}{} En versions à soumettre et finale du document, il est conseillé d'employer tous les éléments \enquote{obligatoires} et, sinon, d'utiliser à bon escient les clés de désactivation ci-dessus, sans quoi : \begin{itemize} \item des textes génériques peuvent figurer dans le document en remplacement de certains éléments manquants ; \item le bon fonctionnement de la \yatcl{} peut être sérieusement altéré. \end{itemize} Donc, pour ces versions, on ne passera outre les éléments \enquote{obligatoires} de la \yatcl{} que dans le cadre d'un usage avancé, si l'on est sûr de ce que l'on fait et qu'on pourra en gérer \emph{seul} les conséquences. On évitera notamment de recourir de façon trop légère à la clé \refKey{noerror}. \end{dbwarning} % \iffalse %%% Local Variables: %%% mode: latex %%% eval: (latex-mode) %%% ispell-local-dictionary: "fr_FR" %%% TeX-engine: xetex %%% TeX-master: "../yathesis.dtx" %%% End: \fi