diff options
Diffstat (limited to 'Master/texmf-dist/doc/lualatex/letgut/letgut.tex')
-rw-r--r-- | Master/texmf-dist/doc/lualatex/letgut/letgut.tex | 358 |
1 files changed, 276 insertions, 82 deletions
diff --git a/Master/texmf-dist/doc/lualatex/letgut/letgut.tex b/Master/texmf-dist/doc/lualatex/letgut/letgut.tex index 91006a60ea8..12a3bae3ffd 100644 --- a/Master/texmf-dist/doc/lualatex/letgut/letgut.tex +++ b/Master/texmf-dist/doc/lualatex/letgut/letgut.tex @@ -67,7 +67,7 @@ } \author{Association GUTenberg} \date{% - Version 0.9.4 en date du \today% + Version 0.9.5 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{source-files-attached}). \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} } @@ -344,13 +346,26 @@ Les options de la \letgutcls{} peuvent être spécifiées de deux façons : de la conception d'un numéro de la \lettre{}. \end{docKey} +\begin{docKey}{source-files-attached}{}{\valinitdef[\docValue*{true}][\docValue*{true}]} + En version autre que \enquote{pour auteurs} (cf. \refKey{for-authors}) et en + sortie autre que papier (cf. \refKey{paper}), chacun des fichiers nécessaires + (et suffisants) à la compilation d'un article de la \lettre{} 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} + La clé booléenne \refKey{source-files-attached} permet de (dés)activer cette + fonctionnalité. +\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⅛). + l'argument est par exemple ™subsection™). \end{dbremark} \subsection{Options autres} @@ -382,7 +397,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 +419,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{source-files-attached}). + 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 +516,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 +527,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 +541,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 +707,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 +733,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 +800,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 +824,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 +848,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 +856,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 +945,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 +953,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 +978,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 +986,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 +1018,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 +1030,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 +1095,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 +1159,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 +1173,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 +1276,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 +1337,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 +1358,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 +1469,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 +1801,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 +1841,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. |