summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/yathesis/french/documentation/corps/pages-corps.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/yathesis/french/documentation/corps/pages-corps.tex')
-rw-r--r--Master/texmf-dist/doc/latex/yathesis/french/documentation/corps/pages-corps.tex182
1 files changed, 152 insertions, 30 deletions
diff --git a/Master/texmf-dist/doc/latex/yathesis/french/documentation/corps/pages-corps.tex b/Master/texmf-dist/doc/latex/yathesis/french/documentation/corps/pages-corps.tex
index a81d6822669..add3603a564 100644
--- a/Master/texmf-dist/doc/latex/yathesis/french/documentation/corps/pages-corps.tex
+++ b/Master/texmf-dist/doc/latex/yathesis/french/documentation/corps/pages-corps.tex
@@ -27,21 +27,137 @@ une conclusion \enquote{ordinaires}.
pour ce faire, standard, est rappelée \vref{sec-repart-du-memo}.
\end{dbremark}
+\section{Initialisation de la partie principale}
+
\begin{docCommand}[doc description=\mandatory]{mainmatter}{}
La partie principale de la thèse doit être manuellement introduite au moyen
- de la commande usuelle \docAuxCommand{mainmatter} de la
- \Class{book}\nofrontmatter.
+ de la commande usuelle \docAuxCommand{mainmatter}\nofrontmatter.
\end{docCommand}
-\section{Chapitres non numérotés}
+\section{Commandes de structuration}
+
+La \yatCl{} modifie les commandes usuelles de structuration
+(\docAuxCommand{chapter}, \docAuxCommand{section}, \docAuxCommand{subsection},
+etc.) en ce qui concerne les trois aspects suivants (examinés aux
+\vref{sec-chap-non-numer,sec-intit-altern,sec-chapitres-numerotes}) :
+\begin{description}
+\item[titres alternatifs des chapitres et sections :] il est possible de
+ différencier celui figurant en \gls{tdm} de celui figurant en
+ entête (c'est-à-dire en \gls{titrecourant}) ;
+\item[unités \emph{non} numérotées :] l'usage des variantes étoilées des
+ commandes de structuration est simplifié ;
+\item[têtes de chapitres numérotés :] leur mise en forme est modifiée (et
+ modifiable).
+\end{description}
+
+\subsection{Titres alternatifs des chapitres et sections}
+\label{sec-intit-altern}
+\index{table des matières!entrée différente du titre courant}%
+\index{titre courant!différent de l'entrée en table des matières}%
+\index{titre!d'unité!alternatif}
+\index{titre!d'unité!normal}
+
+\changes{v0.99p}{2016-12-08}{Commandes \protect\refCom{chapter} et
+ \protect\refCom{section} pourvues d'un argument optionnel supplémentaire
+ permettant de stipuler un titre alternatif en entête différent de celui
+ en \gls{tdm}}%
+
+Avec la \yatCl{}, les entêtes de la plupart des pages contiennent le titre du
+chapitre et le titre de l'éventuelle section en cours
+(cf. \vref{cha-pagination}).
+%
+Ce titre est par défaut celui stipulé en argument obligatoire des commandes
+respectivement \docAuxCommand{chapter} et \docAuxCommand{section}, et figure
+alors également dans le fil du texte et en \gls{tdm}\signet{}.
+
+% Les commandes \docAuxCommand{chapter} et \docAuxCommand{section} admettent un
+% argument obligatoire permettant de stipuler le \meta{titre} du chapitre et de la
+% section dans le fil du texte, \meta{titre} qui par défaut figure également en
+% \gls{tdm}\signet{} et en entête.
+%
+Les classes standard offrent la possibilité de faire figurer en
+\gls{tdm}\signet{} et en entête \emph{un} titre alternatif, différent de celui
+stipulé en argument obligatoire : il suffit pour cela de recourir
+à l'\emph{unique} argument optionnel des commandes \docAuxCommand{chapter} et
+\docAuxCommand{section}. Mais ce titre alternatif est alors nécessairement
+\emph{identique} en \gls{tdm}\signet{} et en entête.
+
+La \yatCl{} fournit une fonctionnalité supplémentaire : grâce aux \emph{deux}
+arguments optionnels dont elle dote les commandes \docAuxCommand{chapter} et
+\docAuxCommand{section}, le titre alternatif en entête peut être différencié de
+celui en \gls{tdm}\signet{}.
+
+La nouvelle syntaxe indiquée ci-dessous, commune aux commandes \refCom{chapter}
+et \refCom{section},
+% n'est indiquée ci-dessous que pour \refCom{chapter} mais
+est précisée et synthétisée au \vref{tab-commande-chapter-section}.
+
+\begin{docCommand}[doc new=2016-12-08]{chapter}{\oarg{alt. en {\normalfont\ttfamily\acrshort*{tdm}}}\oarg{alt. en entête}\marg{titre}}
+ \indexdef{chapitre!titre alternatif}%
+ % Cette commande crée un chapitre dont le titre :
+ % \begin{itemize}
+ % \item dans le fil du texte est \meta{titre} ;
+ % \item alternatif en \gls{tdm}\signet{} est \meta{alt. en {\normalfont\ttfamily\acrshort*{tdm}}} ;
+ % \item alternatif en entête est \meta{alt. en entête}.
+ % \end{itemize}
+\end{docCommand}
+%
+\begin{docCommand}[doc new=2016-12-08]{section}{\oarg{alt. en {\normalfont\ttfamily\acrshort*{tdm}}}\oarg{alt. en entête}\marg{titre}}
+ \indexdef{section!titre alternatif}%
+ Ces commandes créent respectivement un chapitre et une section dont le titre :
+ \begin{itemize}
+ \item dans le fil du texte est \meta{titre} ;
+ \item alternatif en \gls{tdm}\signet{} est \meta{alt. en {\normalfont\ttfamily\acrshort*{tdm}}} ;
+ \item alternatif en entête est \meta{alt. en entête}.
+ \end{itemize}
+ % Son usage précis est synthétisé au \vref{tab-commande-chapter-section}.
+\end{docCommand}
+%
+\begin{table}[htb]
+ \centering
+ \caption{Usage des (deux arguments optionnels des) commandes
+ \protect\refCom{chapter} et \protect\refCom{section}% (identique pour les
+ % commandes \docAuxCommand{chapter*} et \docAuxCommand{section*})
+ }
+ \label{tab-commande-chapter-section}
+ \input{tableaux/commande-chapter-section}
+\end{table}
+%
+\begin{dbremark}{Titres alternatifs différenciables aussi pour
+ \protect\docAuxCommand*{chapter*} et \protect\docAuxCommand*{section*}% les chapitres et
+ % sections non numérotés
+ }{}
+ Les commandes \docAuxCommand{chapter*} et \docAuxCommand{section*}, permettant
+ de créer des chapitres et sections non numérotés, partagent la syntaxe des
+ commandes \docAuxCommand{chapter} et \docAuxCommand{section} synthétisée au
+ \vref{tab-commande-chapter-section} : elles admettent donc elles aussi deux
+ arguments optionnels permettant de différencier les titres alternatifs
+ en \gls{tdm}\signet{} et en entête.
+\end{dbremark}
+%
+La syntaxe des commandes \docAuxCommand{subsection},
+\docAuxCommand{subsubsection}, \docAuxCommand{paragraph} et
+\docAuxCommand{subparagraph} n'est pas modifiée par rapport à celle de la
+\Class{book} ; en effet, les titres correspondants ne figurant que dans le fil
+du texte et (éventuellement) en \gls{tdm}\signet{}, il est inutile de pouvoir en
+stipuler une version spécifique aux entêtes.
+%
+\subsection{Unités du mémoire non numérotées}
\label{sec-chap-non-numer}%
-\index{chapitre!non numéroté}%
+% \indexdef{chapitre!non numéroté}%
+\indexdef{unité!du mémoire!non numérotée}%
+% \indexsee{numérotation!unité}{unité!du mémoire!non numérotée}%
-Si certains chapitres du corps de la thèse \aside{notamment d'introduction de
- conclusion \enquote{générales}} doivent être \emph{non} numérotés, on recourra de
-façon usuelle à la version étoilée de la commande
-\docAuxCommand{chapter}. Celle-ci a toutefois été quelque peu modifiée afin
-d'en simplifier l'usage.
+\changes{v0.99p}{2016-12-08}{%
+ Simplification de l'usage de toutes les commandes de structuration étoilées
+ (et plus seulement de \protect\docAuxCommand{chapter*})%
+}
+
+Si certaines unités du corps de la thèse \aside{par exemple des chapitres
+ d'introduction et de conclusion \enquote{générales}} doivent être \emph{non}
+numérotées, on recourra de façon usuelle à la version étoilée des commandes
+correspondantes. Ces dernières ont toutefois été quelque peu modifiées afin d'en
+simplifier l'usage.
% : habituellement, si un chapitre non numéroté est créé
% \emph{dans la partie principale} (entre \docAuxCommand{mainmatter} et
@@ -51,7 +167,7 @@ d'en simplifier l'usage.
% \item des précautions (assez techniques) doivent être prises pour que :
% \begin{enumerate}
% \item le titre correspondant figure dans la table des matières ;
-% \item les \glspl{titrecourant} correspondants soient corrects ;
+% \item les entêtes correspondants soient corrects ;
% \end{enumerate}
% \item toutes les (sous-(sous-))sections du chapitre, nécessairement non
% numérotées elles aussi, doivent également être créées avec les versions
@@ -59,30 +175,40 @@ d'en simplifier l'usage.
% \docAuxCommand{subsection*} et \docAuxCommand{subsubsection*}.
% \end{enumerate}
-\begin{dbremark}{Variante étoilée de la commande \protect\docAuxCommand*{chapter} modifiée}{}
- \indexdef{chapitre!non numéroté}%
- La \yatCl{} modifie la commande \docAuxCommand{chapter*} de sorte que :
+\begin{dbremark}{Variantes étoilées des commandes de structuration modifiées}{}
+ La \yatCl{} modifie les variantes étoilées des commandes de structuration
+ (\docAuxCommand{chapter*}, \docAuxCommand{section*},
+ \docAuxCommand{subsection*}, etc.) de sorte que :
\begin{enumerate}
- \item automatiquement, le titre du chapitre figure :
+ \item automatiquement, le titre (alternatif le cas échéant) correspondant
+ figure :
\begin{enumerate}
- \item dans la table des matières ;
- \item dans les \glspl{titrecourant} ;
+ \item en \gls{tdm} (selon la profondeur choisie : cf. \refKey{depth} et
+ \refKey{localtocs/depth}) ;
+ \item en entête (pour les chapitres et sections seulement) ;
\end{enumerate}
- \item les (sous-(sous-))sections du chapitre peuvent et même \emph{doivent}
- être créées avec les versions \emph{non} étoilées des commandes
- correspondantes : \docAuxCommand{section}, \docAuxCommand{subsection} et
- \docAuxCommand{subsubsection}.
+ \item si les unités correspondantes contiennent des sous-unités, ces dernières
+ puissent (et même \emph{doivent}) être créées avec les versions \emph{non}
+ étoilées des commandes correspondantes : elles seront néanmoins \emph{non}
+ numérotées (comme l'unité les contenant).
+
+ Ainsi, si un chapitre est non numéroté, les sections, sous-sections,
+ sous-sous-sections, etc. qu'il contient doivent aussi être non
+ numérotées. Et, avec la \yatCl{}, elles seront cependant introduites par les
+ commandes \emph{non} étoilées correspondantes : \docAuxCommand{section},
+ \docAuxCommand{subsection}, \docAuxCommand{subsubsection}, etc.
\end{enumerate}
\end{dbremark}
\begin{dbexample}{Introduction}{}
\indexex{chapitre!non numéroté}%
+ \indexex{unité!du mémoire!non numérotée}%
Le code suivant produit la \vref{fig-introduction} illustrant une
introduction (générale) non numérotée. On constate que, bien que seule la
commande \docAuxCommand{chapter} figure sous sa forme étoilée, aucun élément
de structuration de ce chapitre n'est numéroté.
%
- \bodysample[corps/introduction]{%
+ \bodysample{introduction}{%
deletekeywords={[1]introduction},%
deletekeywords={[3]section,subsection,subsubsection,paragraph,subparagraph}%
}{}
@@ -95,12 +221,14 @@ d'en simplifier l'usage.
\label{fig-introduction}
\end{figure}
-\section{Chapitres numérotés}
+\subsection{Têtes des chapitres numérotés}
\label{sec-chapitres-numerotes}%
\indexdef{chapitre!numéroté}%
-Les chapitres numérotés du corps de la thèse sont introduits par la commande
-usuelle \docAuxCommand{chapter} (cf. \vref{fig-chapitre}).
+Les chapitres numérotés de la thèse, introduits par la version non étoilée de la
+commande \docAuxCommand{chapter}, voient leurs têtes composées par défaut avec
+le style |PetersLenny| du \Package{fncychap} (cf. \vref{fig-chapitre}). La
+\vref{sec-style-des-tetes} explique comment ceci peut être modifié.
\begin{figure}[ht]
\centering
@@ -110,12 +238,6 @@ usuelle \docAuxCommand{chapter} (cf. \vref{fig-chapitre}).
\label{fig-chapitre}
\end{figure}
-\begin{dbremark}{Style des têtes de chapitres numérotés personnalisable}{}
- Les têtes de chapitres numérotés sont par défaut composées avec le style
- |PetersLenny| du \Package*{fncychap}. La \vref{sec-style-des-tetes} explique
- comment ceci peut être modifié.
-\end{dbremark}
-
\section{Références bibliographiques}\label{sec-refer-bibl}
\indexdef{bibliographie!globale}%