summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/yathesis/sections/pages-titre.tex
blob: 3e62d72c9f3b7d205a7188e89d6bf8391c0969a5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
\chapter{Pages de titre}\label{cha:pages-de-titre}

Ce chapitre documente la commande \refCom{maketitle} permettant de
\emph{produire}, à partir des données définies \vref{sec:proprietes-de-titre},
les pages de titre de la thèse.

\section{Production}

\begin{docCommand}[doc description=\mandatory]{maketitle}{\oarg{options}}
  Cette commande \emph{produit} :
  \begin{enumerate}
  \item
    \begin{enumerate}
    \item une page de 1\iere{} de couverture\footnote{Sauf contre-ordre,
        cf. clé \refKey{nofrontcover}.} ;
    \item une page de titre.
    \end{enumerate}
    Ces deux pages sont composées dans la langue principale et
    sont identiques\footnote{À ceci près que le numéro d'ordre de la thèse ne figure
      que sur la page de 1\iere{} de couverture.} ;
  \item \emph{automatiquement}\footnote{Sans qu'il soit nécessaire de faire
      figurer une 2\ieme{} occurrence de la commande \refCom{maketitle}.} une
    seconde page de titre \emph{si} \phrase{et seulement si} l'une au moins des
    commandes \refCom{title}, \refCom{subtitle}, \refCom{academicfield} ou
    \refCom{speciality} est employée avec son argument optionnel
    (cf. \vref{rq:titre-supp}). Cette page est composée dans la langue
    secondaire.
  \end{enumerate}
\end{docCommand}

La commande \refCom{maketitle} admet un argument optionnel permettant de
personnaliser les pages de titre au moyen des clés \refKey{nofrontcover} et
\refKey{frametitle}.%^^A
%^^A
\changes{v0.99g}{2014/07/13}{Personnalisation des pages de titre (\emph{via}
  \protect\refKey{frametitle} et \protect\refKey{nofrontcover}) possible en
  option de \protect\docAuxCommand{maketitle}}%^^A

\begin{docKey}{nofrontcover}{=\docValue{true}\textbar\docValue{false}}{par défaut
    \docValue{true}, initialement \docValue{false}}
  Cette clé permet de désactiver la production de la page de 1\iere{} de
  couverture.
\end{docKey}

{%
  \tcbset{before lower=\vspace*{\baselineskip}\par}
\begin{docKey}{frametitle}{=\docValue{fbox}\textbar\docValue{shadowbox}\textbar\docValue{ovalbox}\textbar\docValue{none}\textbar\marg{autre}}{pas de valeur par défaut, initialement \docValue{fbox}}
  \changes{v0.99c}{2014/06/06}{Nouvelle clé \protect\refKey{frametitle}
    permettant de personnaliser (p. ex. supprimer) le cadre autour du
    titre}%^^A
  %^^A
  Cette clé permet de personnaliser le cadre figurant par défaut autour du
  titre de la thèse sur les pages de titre :
  \begin{itemize}
  \item sa valeur \docValue{fbox} produit un cadre rectangulaire ;
  \item sa valeur \docValue{shadowbox} produit un cadre ombré ;
  \item sa valeur \docValue{ovalbox} produit un cadre dont les sommets sont
    arrondis ;
  \item sa valeur \docValue{none} permet de supprimer ce cadre. L'affichage des
    mentions \enquote{Titre de la thèse} et \foreignquote{english}{Thesis
      Title} est alors désactivé ;
  \item toute \meta{autre} valeur lui étant passée doit être :
    \begin{enumerate}
    \item une liste de clés/valeurs propres à l'environnement
      \docAuxEnvironment{tcolorbox} du \Package{tcolorbox} (cf. la
      documentation de ce package) ;
    \item passée entre paire d'accolades :
\begin{preamblecode}
\yadsetup{frametitle={÷\meta{autre}÷}}
\end{preamblecode}
    \end{enumerate}
  \end{itemize}
\end{docKey}
}

\begin{dbexample}{Cadre personnalisé autour du titre de la thèse}{}
  Pour que le cadre entourant le titre de la thèse soit ombré, il suffit de
  saisir :
\begin{preamblecode}
\maketitle[frametitle=shadowbox]
\end{preamblecode}
\end{dbexample}

\begin{dbexample}{Cadre \enquote{fantaisie} autour du titre de la thèse}{}
  Cet exemple, certainement déconseillé, montre comment exploiter les
  fonctionnalités du \Package{tcolorbox} pour obtenir un cadre
  \enquote{fantaisie} autour du titre de la thèse.%
  \NoAutoSpacing%
\begin{preamblecode}
\maketitle[frametitle={colback=red!50!white,beamer}]
\end{preamblecode}
\end{dbexample}

\section{Exemple complet de pages de titre}
\label{sec:exemple-complet}

\begin{dbexample}{Préparation et production des pages de titre}{}
  Avec les données caractéristiques suivantes, la commande
  \refCom{maketitle} produit :
  \begin{enumerate}
  \item en langue principale (ici le français),
    \begin{enumerate}
    \item \changes*{v0.99f}{2014/07/11}{Directeurs de thèse désormais dans un
        tableau indépendant de celui des membres du jury sur les pages de
        titre}%^^A
      %^^A
      une page de 1\iere{} de couverture illustrée \vref{fig:maketitle-fr} ;
    \item une page de titre ;
    \end{enumerate}
  \item en langue secondaire (ici l'anglais), une page de titre illustrée
    \vref{fig:maketitle-en}.
  \end{enumerate}
%
  \NoAutoSpacing%
  \lstset{morecomment=[is]{\%}{\^^M}}%
  \preamblesample[\configurationdirectory/\characteristicsfile]{%
    deletekeywords={[2]title},%
    rangeendsuffix={\^^M},%
    linerange={%
      author-42]
    }%
  }{title=Préparation du titre (par exemple dans le \File{\characteristicsfile})}
  %
  \lstset{deletecomment=[is]{\%}{\^^M}}%
  %
  \bodysample{rangesuffix=\^^M,linerange={maketitle}}{title=Production
    du titre}
\end{dbexample}

\begin{landscape}
  \begin{figure}[htb]
    \centering
    \begin{subfigure}[b]{.45\linewidth}
      \centering%
      \fbox{\includegraphics[page=1,width=\linewidth-2\fboxsep-2\fboxrule]{master-slaves-files-sample/these}}
      % ^^A\screenshot[1]{fr-title}
      \caption{Page de première de couverture en français}
      \label{fig:maketitle-fr}
    \end{subfigure}%
    \hspace{\stretch{1}}%
    \begin{subfigure}[b]{.45\linewidth}
      \centering%
      \fbox{\includegraphics[page=5,width=\linewidth-2\fboxsep-2\fboxrule]{master-slaves-files-sample/these}}
      % ^^A\screenshot[1]{en-title}
      \caption{Page de titre en anglais}
      \label{fig:maketitle-en}
    \end{subfigure}%
    \caption{Pages de première de couverture et de titre}
    \label{fig:maketitle}
  \end{figure}
\end{landscape}
%
\iffalse
%%% Local Variables:
%%% mode: latex
%%% eval: (latex-mode)
%%% ispell-local-dictionary: "fr_FR"
%%% TeX-engine: xetex
%%% TeX-master: "../yathesis.dtx"
%%% End:
\fi