diff options
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.tex | 182 |
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}% |