summaryrefslogtreecommitdiff
path: root/macros/luatex/latex/letgut/doc/letgut.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/luatex/latex/letgut/doc/letgut.tex')
-rw-r--r--macros/luatex/latex/letgut/doc/letgut.tex373
1 files changed, 284 insertions, 89 deletions
diff --git a/macros/luatex/latex/letgut/doc/letgut.tex b/macros/luatex/latex/letgut/doc/letgut.tex
index 91006a60ea..01fbebb836 100644
--- a/macros/luatex/latex/letgut/doc/letgut.tex
+++ b/macros/luatex/latex/letgut/doc/letgut.tex
@@ -67,7 +67,7 @@
}
\author{Association GUTenberg}
\date{%
- Version 0.9.4 en date du \today%
+ Version 0.9.6 en date du \today%
\texorpdfstring{%
\\
\url{https://framagit.org/gutenberg/letgut}%
@@ -205,7 +205,9 @@ Les options de la \letgutcls{} peuvent être spécifiées de deux façons :
\item éditorial\footnote{Ou avertissement s'il n'est pas trouvé.} (cf. clé
\refKey{editorial}) ;
\item informations sur \gut{}\footnote{Ou avertissement si elles ne sont pas
- trouvées.} (cf. clé \refKey{informations}).
+ trouvées.} (cf. clé \refKey{informations}) ;
+ \item fichiers attachés au \pdf{} produit (cf. clé
+ \refKey{reverse-files-attachement}).
\end{itemize}
\end{itemize}
\end{docKeys}
@@ -280,7 +282,7 @@ Les options de la \letgutcls{} peuvent être spécifiées de deux façons :
\begin{itemize}
\item n'est pas employée (les mois et année en cours sont alors
utilisés) ;
- \item est employée sous la forme \refKey*{date}⅛=⅛\meta{année}⅛-⅛\meta{mois}
+ \item est employée sous la forme \refKey*{date}™=™\meta{année}™-™\meta{mois}
où \meta{année} et \meta{mois} doivent être des nombres entiers
positifs. Les garde-fous suivants sont mis en place :
\begin{itemize}
@@ -291,7 +293,7 @@ Les options de la \letgutcls{} peuvent être spécifiées de deux façons :
\end{itemize}
\end{itemize}
\item \enquote{\meta{texte}} si l'option est employée sous la forme
- \refKey*{date}⅛=⅛\meta{texte}.
+ \refKey*{date}™=™\meta{texte}.
\end{itemize}
\end{docKey}
}
@@ -342,16 +344,30 @@ Les options de la \letgutcls{} peuvent être spécifiées de deux façons :
a pour effet que cette table des matières est détaillée au maximum (son niveau
de profondeur allant jusqu'aux sous-paragraphes), ce qui peut être utile lors
de la conception d'un numéro de la \lettre{}.
+
+ \begin{dbremark}{Tables des matières locales}{}
+ Chaque article peut contenir une table des matières locale, affichée au
+ moyen de la commande \docAuxCommand{localtableofcontents} (fournie par le
+ \package*{etoc} chargé en sous-main par la \letgutcls{}). Le niveau de
+ profondeur est par défaut celui des sections mais cela peut être modifié en
+ la faisant précéder de la commande \docAuxCommand{etocsetnexttocdepth} (dont
+ l'argument est par exemple ™subsection™).
+ \end{dbremark}
\end{docKey}
-\begin{dbremark}{Tables des matières locales}{}
- Chaque article peut contenir une table des matières locale, affichée au moyen
- de la commande \docAuxCommand{localtableofcontents} (fournie par le
- \package*{etoc} chargé en sous-main par la \letgutcls{}). Le niveau de
- profondeur est par défaut celui des sections mais cela peut être modifié en la
- faisant précéder de la commande \docAuxCommand{etocsetnexttocdepth} (dont
- l'argument est par exemple ⅛subsection⅛).
-\end{dbremark}
+\begin{docKey}{reverse-files-attachement}{}{\valinitdef[pas de valeur]}
+ Si, et seulement si, la \lettre{} est à la fois en version pour les lecteurs
+ (cf. \refKey{for-readers}) et en sortie écran (cf. \refKey{screen}), chacun
+ des fichiers nécessaires (et suffisants) à la compilation d'un de ses articles
+ est :
+ \begin{itemize}
+ \item attaché au \pdf{} produit ;
+ \item accessible en cliquant sur l'hyperlien correspondant en forme de
+ trombone : \noattachfile[icon=Paperclip] ;
+ \end{itemize}
+ L'option \refKey{reverse-files-attachement} inverse ce comportement par
+ défaut.
+\end{docKey}
\subsection{Options autres}
\label{sec:options-autres}
@@ -382,7 +398,7 @@ Si la commande \docAuxCommand{title}\marg{titre} est
\begin{dbwarning}{\docAuxCommand{title} et \docAuxCommand{author}
$\neq$ avant et après \lstinline+\\begin\{document\}+}{}
Les commandes \docAuxCommand{title} et \docAuxCommand{author} ne se comportent
- pas de la même façon avant et après ⅛\begin{document}⅛ (cf. sections
+ pas de la même façon avant et après ™\begin{document}™ (cf. sections
\nameref{sec:structuration} \vpageref{sec:structuration} et
\nameref{sec:sign-des-articl} \vpageref{sec:sign-des-articl}).
\end{dbwarning}
@@ -404,12 +420,29 @@ Si la commande \docAuxCommand{title}\marg{titre} est
\end{itemize}
\end{dbwarning}
-\begin{docCommand}{inputarticle}{\marg{fichier enfant}}
+\begin{docCommands}
+ {
+ {
+ doc name = inputarticle,
+ doc parameter = \marg{fichier enfant},
+ },
+ {
+ doc name = inputarticle*,
+ doc parameter = \marg{fichier enfant},
+ },
+ }
Cette commande permet d'importer le contenu d'un article stocké dans un
\meta{fichier enfant}\file{.tex}.
+ En version étoilée, les fichiers nécessaires (et suffisants) à la compilation
+ de l'article ne sont pas attachés au \pdf{} produit (cf. clé
+ \refKey{reverse-files-attachement}).
+
En plus de l'importation proprement dite, cette commande procède à un certain
nombre de réinitialisations.
+\end{docCommands}
+
+\begin{docCommand}{inputarticle}{\marg{fichier enfant}}
\end{docCommand}
\section{Structuration}
@@ -484,6 +517,10 @@ On lira avec intérêt la section \enquote{\nameref{sec:acronymes}}
doc parameter = \brackets{\meta{données$_1$} and \meta{données$_2$}[ and ...]}
},
{
+ doc name = person*,
+ doc parameter = \brackets{\meta{données$_1$} and \meta{données$_2$}[ and ...]}
+ },
+ {
doc name = author,
doc parameter = \marg{données}
},
@@ -491,6 +528,10 @@ On lira avec intérêt la section \enquote{\nameref{sec:acronymes}}
doc name = author,
doc parameter = \brackets{\meta{données$_1$} and \meta{données$_2$}[ and ...]}
},
+ {
+ doc name = author*,
+ doc parameter = \brackets{\meta{données$_1$} and \meta{données$_2$}[ and ...]}
+ },
}
\index{auteur}
\index{personne}
@@ -501,18 +542,20 @@ On lira avec intérêt la section \enquote{\nameref{sec:acronymes}}
étant spécifiées :
\begin{description}
\item[pour un individu unique] selon l'un des formats suivants :
- \begin{itemize}
- \item \meta{nom}
- \item \meta{nom}⅛, ⅛\meta{prénom}
- \item \meta{nom}⅛, ⅛\meta{prénom}⅛, ⅛\meta{titre}
- \end{itemize}
-\item[pour des individus multiples :]\leavevmode
- \begin{itemize}
- \item selon le même schéma que pour un individu unique ;
- \item les \meta{données} de chacun des individus étant séparées par le mot clé
- ⅛and⅛.
- \end{itemize}
+ \begin{itemize}
+ \item \meta{nom}
+ \item \meta{nom}™, ™\meta{prénom}
+ \item \meta{nom}™, ™\meta{prénom}™, ™\meta{titre}
+ \end{itemize}
+ \item[pour des individus multiples :]\leavevmode
+ \begin{itemize}
+ \item selon le même schéma que pour un individu unique ;
+ \item les \meta{données} de chacun des individus étant séparées par le mot clé
+ ™and™.
+ \end{itemize}
\end{description}
+ Les version étoilées de ces commandes trient alphabétiquement les listes de
+ personnes ou d'auteurs.
\end{docCommands}
Indépendamment de la casse utilisée en entrée, pour chaque \meta{nom} et
@@ -665,8 +708,10 @@ Unicode a prévu le caractère \Ucode[symbole numéro]{2116}.
{
{ doc name = gutenberg },
{ doc name = gut },
- % { doc name = lettre },
- % { doc name = lettregut },
+ { doc name = assogut },
+ { doc name = Assogut },
+ { doc name = lettres },
+ { doc name = lettresgut },
{ doc name = cahier },
{ doc name = cahiers },
{ doc name = cahiergut },
@@ -689,23 +734,25 @@ Unicode a prévu le caractère \Ucode[symbole numéro]{2116}.
\centering
\begin{tabular}{ll}
\toprule
- \refCom{gutenberg} & \gutenberg \\
- \refCom{gut} & \gut \\
- % \refCom{lettre} & \lettre \\
- % \refCom{lettregut} & \lettregut \\
- \refCom{cahier} & \cahier \\
- \refCom{cahiergut} & \cahiergut \\
- \refCom{cahiers} & \cahiers \\
- \refCom{cahiersgut} & \cahiersgut \\ \midrule
- \refCom{letgut} & \letgut \\
- \refCom{letgutcls} & \letgutcls \\ \midrule
- \refCom{knuth} & \knuth \\
- \refCom{lamport} & \lamport \\
- \refCom{tl} & \tl \\
- \refCom{tugboat} & \tugboat \\ \midrule
- \refCom{linux} & \linux \\
- \refCom{macos} & \macos \\
- \refCom{windows} & \windows \\ \bottomrule
+ \refCom{gutenberg} & \gutenberg \\
+ \refCom{gut} & \gut \\
+ \refCom{assogut} & \assogut \\
+ \refCom{Assogut} & \Assogut \\
+ \refCom{lettres} & \lettres \\
+ \refCom{lettresgut} & \lettresgut \\
+ \refCom{cahier} & \cahier \\
+ \refCom{cahiergut} & \cahiergut \\
+ \refCom{cahiers} & \cahiers \\
+ \refCom{cahiersgut} & \cahiersgut \\ \midrule
+ \refCom{letgut} & \letgut \\
+ \refCom{letgutcls} & \letgutcls \\ \midrule
+ \refCom{knuth} & \knuth \\
+ \refCom{lamport} & \lamport \\
+ \refCom{tl} & \tl \\
+ \refCom{tugboat} & \tugboat \\ \midrule
+ \refCom{linux} & \linux \\
+ \refCom{macos} & \macos \\
+ \refCom{windows} & \windows \\ \bottomrule
\end{tabular}
\caption{Effet des commandes de raccourcis}
\label{tab:raccourcis}
@@ -754,7 +801,8 @@ de \docAuxCommand{section}%
\ExplSyntaxOff
\begin{ltx-code-result}[title addon=emploi de la commande \refCom{lettrenumber},listing options app={deletekeywords={[6]{cours,lettre}}}]
-Si le numéro de la \lettre{} en cours est 46, celui de la \lettre
+Si le numéro de la \lettre{} en cours est 46,
+celui de la \lettre :
\begin{enumerate}
\item en cours est \lettrenumber ;
\item en cours est le \lettrenumber* ;
@@ -777,7 +825,7 @@ Si le numéro de la \lettre{} en cours est 46, celui de la \lettre
\enquote{\lettre} et \enquote{\lettregut}, le cas échéant suivies du numéro
de la \lettre{} :
\begin{description}
- \item[en cours] si l'\meta{argument optionnel} est un point (⅛.⅛) ;
+ \item[en cours] si l'\meta{argument optionnel} est un point (™.™) ;
\item[décalé de celui en cours] de ce qui est spécifié si l'\meta{argument optionnel} est un
entier relatif signé\footref{entier-signe} ;
\item[spécifié] si l'\meta{argument optionnel} est autre.
@@ -801,8 +849,7 @@ Si le numéro de la \lettre{} en cours est 46, on a :
\item \lettre*[43]
\item \lettre*
\end{enumerate}
-On fait usage de ces commandes
-dans la \lettregut*[.].
+On fait usage de ces commandes dans la \lettregut*[.].
\end{ltx-code-result}
\subsection{Touches de clavier}
@@ -810,7 +857,7 @@ dans la \lettregut*[.].
Afin de disposer d'un moyen simple, riche et élégant pour composer des touches
de clavier, la \letgutcls{} s'appuie sur le \package*{biolinum} et notamment sa
-commande ⅛\LKey⅛. Cette dernière a été légèrement étendue de façon à faciliter
+commande ™\LKey™. Cette dernière a été légèrement étendue de façon à faciliter
la saisie pour toutes les touches des diacritiques utilisés en français.
\begin{ltx-code-result}[title addon=touches de clavier]
@@ -899,7 +946,7 @@ environnements \enquote{verbatim} suivants.
ces codes et résulats :
\begin{itemize}
\item l'un sous l'autre par défaut ;
- \item l'un à gauche de l'autre si l'option ⅛sidebyside⅛ est
+ \item l'un à gauche de l'autre si l'option ™sidebyside™ est
employée.
\end{itemize}
\end{enumerate}
@@ -907,7 +954,7 @@ environnements \enquote{verbatim} suivants.
\begin{dbwarning}{Exemples de codes avec résultats : possiblement
flottants}{exemples-flottants}
- Si l'option ⅛sidebyside⅛ est passée à l'un ou l'autre des
+ Si l'option ™sidebyside™ est passée à l'un ou l'autre des
environnements \refEnv{ltx-code-result} et \refEnv{ltx-code-external-result},
l'exemple :
\begin{itemize}
@@ -932,7 +979,7 @@ Ces trois environnements admettent des \meta{options} :
\begin{itemize}
\item (toutes) celles acceptées par l'environnement
\docAuxEnvironment{tcblisting} et la commande \docAuxCommand{newtcblisting}
- fournis par la bibliothèque ⅛listings⅛ du
+ fournis par la bibliothèque ™listings™ du
\package*{tcolorbox}\footnote{Et, aussi, les commandes
\docAuxCommand{DeclareTCBListing} et assimilées fournies par la bibliothèque
\lstinline+xparse+ de ce package.}. Elles permettent notamment de surcharger
@@ -940,29 +987,29 @@ Ces trois environnements admettent des \meta{options} :
\begin{itemize}
\item de faire figurer l'éventuel résultat, non pas sous le code comme c'est
le cas par défaut, mais en regard (à droite) au moyen de l'option
- ⅛sidebyside⅛ ;
+ ™sidebyside™ ;
\item de supprimer les numéros de ligne au moyen de l'option
\begin{ltx-code}
listing options={numbers=none}
\end{ltx-code}
\end{itemize}
\item trois spécifiques à ces environnements :
- \begin{docKey*}{title addon}{=\meta{supplément au titre}}{\valinitdef}
- Cette option permet d'adjoindre un \meta{supplément au titre} de ces
- exemples, qui sont par défaut et automatiquement \enquote{Exemple \meta{n}}.
- \end{docKey*}
- \begin{docKey*}{result width}{=\meta{longueur}}{\valinitdef[\docAuxCommand*{linewidth}]}
+ \begin{docKey}{title addon}{=\meta{supplément}}{\valinitdef}
+ Cette option permet d'adjoindre au titre de ces exemples, qui sont par
+ défaut et automatiquement \enquote{Exemple \meta{n}}, un \meta{supplément}.
+ \end{docKey}
+ \begin{docKey}{result width}{=\meta{longueur}}{\valinitdef[\docAuxCommand*{linewidth}]}
Cette option, utile seulement pour l'environnement
\refEnv{ltx-code-external-result}, permet de spécifier une largeur autre que
celle initiale pour le fichier image du résultat, compilé indépendamment de
la \lettre{}.
- \end{docKey*}
- \begin{docKey*}{reference text}{=\meta{texte}}{\valinitdef[Cf. exemple \meta{n} page \meta{q}.]}
+ \end{docKey}
+ \begin{docKey}{reference text}{=\meta{texte}}{\valinitdef[Cf. exemple \meta{n} page \meta{q}.]}
Cette option n'a d'effet que :
\begin{itemize}
\item avec l'un ou l'autre des environnements \refEnv{ltx-code-result} et
\refEnv{ltx-code-external-result} ;
- \item lorsque l'option ⅛sidebyside⅛ leur est passée ;
+ \item lorsque l'option ™sidebyside™ leur est passée ;
\item lorsque l'exemple s'avère se trouver sur une page autre que
celle de son point d'insertion.
\end{itemize}
@@ -972,9 +1019,9 @@ listing options={numbers=none}
s'affranchir de ce texte en recourant à \lstinline+reference text=\{\}+.}.
\begin{dbwarning}{\refKey{reference text} avant \lstinline+sidebyside+}{}
Pour qu'elle soit prise en compte, l'option \refKey{reference text} doit
- être passée \emph{avant} l'option ⅛sidebyside⅛.
+ être passée \emph{avant} l'option ™sidebyside™.
\end{dbwarning}
- \end{docKey*}
+ \end{docKey}
\end{itemize}
\subsubsection{Coloration syntaxique}
@@ -984,16 +1031,16 @@ Par défaut, en début de document et de chaque fichier importé au moyen de
\refCom{inputarticle}, le langage supposé dans ces exemples de codes est
\hologo{TeX}, chargé (seulement) avec ses \enquote{dialectes} :
\begin{itemize}
-\item ⅛primitive⅛, ⅛common⅛, ⅛plain⅛, ⅛LaTeX⅛, ⅛AlLaTeX⅛ fournis par le
+\item ™primitive™, ™common™, ™plain™, ™LaTeX™, ™AlLaTeX™ fournis par le
\package*{listings} ;
-\item ⅛classes⅛ fourni par \letgutcls{} (répertoriant les classes disponibles
+\item ™classes™ fourni par \letgutcls{} (répertoriant les classes disponibles
sur le \ctan{}).
\end{itemize}
Une conséquence notable est la suivante :
\begin{dbwarning}{Coloration syntaxique réduite par défaut}{}
La coloration syntaxique dans les exemples de codes n'est par défaut active
- que pour le langage \hologo{TeX} et ses dialectes ⅛primitive⅛, ⅛common⅛,
- ⅛plain⅛, ⅛LaTeX⅛, ⅛AlLaTeX⅛ et ⅛classes⅛.
+ que pour le langage \hologo{TeX} et ses dialectes ™primitive™, ™common™,
+ ™plain™, ™LaTeX™, ™AlLaTeX™ et ™classes™.
\end{dbwarning}
Il est néanmoins possible de spécifier d'autres langages et dialectes au moyen
@@ -1049,7 +1096,7 @@ fournit la commande à arguments \enquote{verbatim} suivante.
Il est possible de surcharger les réglages par défaut de cette commande au
moyen d'\meta{options} qui sont (toutes) celles acceptées par l'environnement
\docAuxEnvironment{tcblisting} et la commande \docAuxCommand{newtcblisting}
- fournis par la bibliothèque ⅛listings⅛ du \package*{tcolorbox}\footnote{Et,
+ fournis par la bibliothèque ™listings™ du \package*{tcolorbox}\footnote{Et,
aussi, les commandes \docAuxCommand{DeclareTCBListing} et assimilées
fournies par la bibliothèque \lstinline+xparse+ de ce package.}.
\end{docCommand}
@@ -1113,7 +1160,7 @@ rg -g 0,25s user 0,23s system 320% cpu 0,150 total
\begin{dbwarning}{Caractère d'échappement des listings}{}
\lstset{escapechar=}%
- La \letgutcls{} définit ⅛£⅛ comme caractère d'échappement dans \LaTeX{} au
+ La \letgutcls{} définit ™£™ comme caractère d'échappement dans \LaTeX{} au
sein d'un listing.
\end{dbwarning}
@@ -1127,37 +1174,38 @@ Au besoin, on pourra désactiver ce caractère actif au moyen de
\docAuxCommand{lstinline} du \package*{listings} mais, pour
simplifier la tâche, la \letgutcls{} définit comme équivalent court
de \docAuxCommand{lstinline} le caractère unicode %
- \lstDeleteShortInline⅛%
- \texttt{⅛} %
- \lstMakeShortInline⅛%
- (U+215B)\footnote{Peu susceptible d'être utilisé dans du texte
+ \lstDeleteShortInline™%
+ \texttt{™} %
+ \lstMakeShortInline™%
+ (\Ucode{2122})\footnote{Peu susceptible d'être utilisé dans du texte
ordinaire.}.
\end{dbwarning}
Autrement dit, la \letgutcls{} contient l'instruction\footnote{À peu
de choses près.} :
- \lstDeleteShortInline⅛
+ \lstDeleteShortInline™
\begin{ltx-code}
-\lstMakeShortInline£\texttt{⅛}£
+\lstMakeShortInline£\texttt{™}£
\end{ltx-code}
Au besoin, on pourra désactiver ce caractère actif au moyen de :
\begin{ltx-code}
-\lstDeleteShortInline£\texttt{⅛}£
+\lstDeleteShortInline£\texttt{™}£
\end{ltx-code}
-\begin{dbremark}{Obtention du caractère \texttt{⅛}}{}
+\begin{dbremark}{Obtention du caractère \texttt{™}}{}
Le caractère %
-\texttt{⅛} %
+\texttt{™} %
s'obtient :
\begin{itemize}
-\item sous \linux{} : \LKeyShiftAltGrX{2}\footnote{Touche \LKey{2} du clavier principal.} ;
+\item sous \linux{} : \LKeyShiftAltGrX{8}\footnote{Touche \LKey{8} du clavier
+ principal.} ;
\item sous \macos{} : à l'aide du visualiseur de caractères\footnote{Et
possiblement de raccourcis claviers personnels.} ;
-\item sous \windows{} : \LKeyAltX{8}+\LKey{5}+\LKey{3}+\LKey{9}.
+\item sous \windows{} : \LKeyAltX{0}+\LKey{1}+\LKey{5}+\LKey{3}.
\end{itemize}
\end{dbremark}
- \lstMakeShortInline⅛%
+ \lstMakeShortInline™%
\section{Nouveautés apparues sur le \ctan}
\label{sec:rubr-cons-aux}
@@ -1229,6 +1277,16 @@ Les fiches de lecture d'un livre sont créées au moyen de l'environnement
\begin{docKey}{bibkey}{=\meta{clé}}{\valinitdef}
Cette clé permet de spécifier la \meta{clé} identifiant l'entrée d'un
\file*{.bib} contenant les données bibliographiques du document rapporté.
+ \begin{dbwarning}{Fichier de bibliographie}{}
+ Ces données bibliographiques doivent se trouver dans un fichier
+ \meta{bibliographie}\file{.bib}, structurées selon le format du
+ \package*{biblatex} et chargées en préambule (par exemple dans le
+ fichier local de configuration, cf. \vpageref{sec:fichier-local-de}) au
+ moyen de la commande :
+\begin{ltx-code}
+\addbibressource{£\meta{bibliographie}£.bib}
+\end{ltx-code}
+ \end{dbwarning}
\end{docKey}
\item[fortement conseillée :]
\begin{docKey}{frontcover}{=\meta{fichier}}{\valinitdef}
@@ -1280,10 +1338,10 @@ commande dédiée \refCom{letgutacro}.
être employé au moyen des commandes fournies par le \package*{acro}, par
exemple :
\begin{itemize}
- \item ⅛\ac{⅛\meta{court}⅛}⅛\footnote{Acronyme automatiquement affiché sous sa
+ \item ™\ac{™\meta{court}™}™\footnote{Acronyme automatiquement affiché sous sa
forme complète à sa 1\iere{} occurrence, sous sa forme courte à ses
occurrences suivantes.} ;
- \item ⅛\acs{⅛\meta{court}⅛}⅛\footnote{Acronyme affiché sous sa forme courte
+ \item ™\acs{™\meta{court}™}™\footnote{Acronyme affiché sous sa forme courte
seulement.}.
\end{itemize}
Toutefois, pour simplifier l'usage de ces acronymes, la \letgutcls{} crée
@@ -1301,8 +1359,8 @@ commande dédiée \refCom{letgutacro}.
%
qui agit comme :
\begin{itemize}
- \item ⅛\ac{⅛\meta{court}⅛}⅛ en version non étoilée ;
- \item ⅛\acs{⅛\meta{court}⅛}⅛ en version étoilée.
+ \item ™\ac{™\meta{court}™}™ en version non étoilée ;
+ \item ™\acs{™\meta{court}™}™ en version étoilée.
\end{itemize}
\end{docCommand}
Ainsi, l'acronyme utilisé via \docAuxCommand{\meta{court}} figure, pour ses
@@ -1412,6 +1470,143 @@ insère un filet horizontal.
Cette commande permet d'accentuer la séparation entre deux articles.
\end{docCommand}
+\section{Annonces}
+\label{sec:annonces}
+
+Afin de présenter aisément et de façon homogène les annonces à paraître dans la
+\lettre{}, la \letgutcls{} fournit l'environnement \refEnv{announcement}.
+
+\begin{docEnvironment}[doclang/environment content=annonce]{announcement}{\oarg{couleur}\marg{titre}}
+ Cet environnement est dédié aux \meta{annonce}s. La spécification :
+ \begin{itemize}
+ \item d'un \meta{titre} (pouvant toutefois être vide) est obligatoire ;
+ \item d'une \meta{couleur} (du tire et des ornements) autre que celle (noire)
+ par défaut est possible.
+ \end{itemize}
+\end{docEnvironment}
+
+\begin{ltx-code-result}[title addon=annonces]
+\begin{announcement}[red!35!black]{Convocation \acs{ag} ordinaire}
+ Les adhérents de l'\assogut{} sont invités à participer à
+ l'\textbf{assemblée générale \emph{ordinaire}} de l'association
+ le \textbf{dimanche 11 décembre 2022}.
+\end{announcement}
+\end{ltx-code-result}
+
+\section{Rébus}
+\label{sec:rebus}
+
+\tcbstartrecording\relax
+Afin de présenter aisément et de façon homogène les rébus à paraître dans la
+\lettre{}, la \letgutcls{} fournit l'environnement \refEnv{rebus}.
+
+\begin{docEnvironment}[doclang/environment content=rébus]{rebus}{\oarg{options}}
+ Cet environnement affiche un \meta{rébus} et s'emploie différemment selon que
+ la solution est prévue de figurer dans la \lettre{} :
+ \begin{description}
+ \item[en cours :] le rébus et sa solution doivent alors être séparées par
+ la commande \refCom{solution} ;
+ \item[suivante :] l'option \refKey{no solution} doit alors être employée.
+ \end{description}
+ La boîte contenant le rébus mentionne que sa solution se trouve,
+ respectivement :
+ \begin{itemize}
+ \item \enquote{page \meta{n}} ou \enquote{ci-dessous} ;
+ \item \enquote{dans la prochaine \lettre{}}.
+ \end{itemize}
+
+ La commande séparant le rébus et sa solution prévue de figurer dans la
+ \lettre{} en cours est :
+ \begin{docCommand}{solution}{}
+ Cette commande débute la solution d'un rébus à l'intérieur d'un environment
+ \refEnv{rebus}.
+ \end{docCommand}
+
+ En outre, cet environnement admet des \meta{options} :
+ \begin{itemize}
+ \item (toutes) celles acceptées par les environnements \refAux{tcolorbox} et
+ assimilés du \package*{tcolorbox}, destinées à, le cas échéant, modifier la
+ mise en forme par défaut de la boîte contenant le rébus ;
+ \item deux qui lui sont propres :
+ \begin{docKey}{title addon}{=\meta{supplément}}{\valinitdef}
+ Cette option permet d'adjoindre au titre d'un rébus, qui est par défaut et
+ automatiquement \enquote{Rébus}, un \meta{supplément} alors en italique et
+ entre parenthèses.
+ \end{docKey}
+ \begin{docKey}{no solution}{}{\valinitdef[\docValue*{false}][\docValue*{true}]}
+ Cette option est à spécifier pour un rébus dont la solution ne doit figurer
+ que dans la prochaine \lettre{}.
+ \end{docKey}
+ \end{itemize}
+\end{docEnvironment}
+
+Ainsi le code :
+
+\begin{ltx-code}[title addon=rébus]
+\begin{rebus}[no solution]
+ Rébus \emph{sans} solution dans le présent numéro.
+\end{rebus}
+\begin{rebus}
+ Rébus \emph{avec} solution dans le présent numéro.
+ \solution
+ Solution du rébus.
+\end{rebus}
+\end{ltx-code}
+
+donne-t-il les résultats suivants\footnote{Éventuellement pas immédiatement à la
+ suite car les boîtes contenant les rébus sont flottantes.}.
+
+\begin{rebus}[no solution,nofloat]
+ Rébus \emph{sans} solution dans le présent numéro.
+\end{rebus}
+\begin{rebus}[nofloat]
+ Rébus \emph{avec} solution dans le présent numéro.
+ \solution
+ Solution du rébus.
+\end{rebus}
+
+La \letgutcls{} fournit bien sûr le moyen d'afficher les solutions des rébus de
+la \lettre{}
+soit en cours, soit précédente.
+
+\begin{docCommand}{rebussolution}{\oarg{solution}\oarg{numéro}\oarg{options}}
+ Cette commande affiche la ou les solutions du ou des rébus qui figurent dans
+ la \lettre{} :
+ \begin{description}
+ \item[en cours :] (commande \refCom{solution}) si ses 1\ier{} et
+ 2\ieme{} arguments optionnels \meta{solution} et \meta{numéro} sont
+ inutilisés ;
+ \item[précédente :] si son 1\ier{} argument optionnel \meta{solution} est
+ utilisé. Selon que 2\ieme{} argument optionnel \meta{numéro} est spécifié ou
+ pas, il est indiqué que la \meta{solution} est celle d'un rébus figurant
+ dans la \lettre{} :
+ \begin{itemize}
+ \item \meta{numéro} ;
+ \item précédente.
+ \end{itemize}
+ \end{description}
+ Cette commande admet comme \meta{options} (toutes) celles acceptées par les
+ environnements \refAux{tcolorbox} et assimilés du \package*{tcolorbox},
+ destinées à, le cas échéant, modifier la mise en forme par défaut de la boîte
+ contenant la solution du rébus.
+\end{docCommand}
+
+Ainsi le code :
+
+\begin{ltx-code}[title addon=solution de rébus]
+\rebussolution
+\rebussolution[Solution du rébus]
+\rebussolution[Solution du rébus][49]
+\end{ltx-code}
+
+donne-t-il donne-t-il les résultats suivants\footnote{Éventuellement pas
+ immédiatement à la suite car les boîtes contenant les solutions des rébus sont
+ flottantes.}.
+
+\rebussolution
+\rebussolution[Solution du rébus]
+\rebussolution[Solution du rébus][49]
+
\section{Boîtes d'alertes}
\label{sec:boites-dalertes}
@@ -1607,7 +1802,7 @@ dressons ci-après la liste en les regroupant selon ces deux catégories.
\item[babel] support multilingue.
\begin{description}
\item[Options :] \docAuxKey*{english}, \docAuxKey*{french} ;
- \item[Configuration] ⅛\renewcommand*\frenchtablename{Tableau}⅛.
+ \item[Configuration] ™\renewcommand*\frenchtablename{Tableau}™.
\end{description}
\item[varioref] références de pages intelligentes.
\begin{description}
@@ -1647,11 +1842,11 @@ dressons ci-après la liste en les regroupant selon ces deux catégories.
\item[Options :]\leavevmode{}
\begin{itemize}
\item \docAuxKey*{first-style=footnote} ;
- \item \docAuxKey*{format/short=}⅛\scshape⅛ ;
- \item \docAuxKey*{format/foreign=}⅛\em⅛ ;
+ \item \docAuxKey*{format/short=}™\scshape™ ;
+ \item \docAuxKey*{format/foreign=}™\em™ ;
\item \docAuxKey*{foreign/display} ;
\item \docAuxKey*{locale/display} ;
- \item \docAuxKey*{locale/format=}⅛\upshape⅛.
+ \item \docAuxKey*{locale/format=}™\upshape™.
\end{itemize}
\end{description}
\item[hyperref] prise en charge étendue de l'hypertexte.