<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">\documentclass{letgut}

% On compose la prĂ©sente documentation en Kp-Fonts, sauf en ce qui concerne la
% fonte Ă&nbsp; chasse fixe qui n'est pas ce qu'il y a de plus rĂ©ussi chez elle.
\setmainfont{KpRoman}
\setsansfont{KpSans}
% \setmonofont{TeX Gyre Cursor}
\setmonofont[Scale = MatchLowercase]{RobotoMono}

% On ne veut pas d'Ă©ditorial dans cette Â« Lettre Â» et on veut que sa couleur de
% fond ne soit pas la couleur ivoire par dĂ©faut, mais du blanc.
\letgutsetup{
  , editorial=false
  , pagecolor= {1,1,1}
  , detailedtoc = subsection
  % ,final
}

% Bibliographie
\addbibresource{letgut.bib}

% On dĂ©finit quelques commandes (utiles seulement pour la prĂ©sente
% documentation), par exemple celle permettant d'accĂ©der Ă&nbsp; la couleur de fond du
% papier lorsque l'option `paper' n'est pas employĂ©e.
\ExplSyntaxOn
\NewDocumentCommand { \letgutdefaultpagecolor } {  } {
  \c__letgut_default_pagecolor_screen_clist
}
\definecolor{letgutdefaultpagecolor}{rgb}{\c__letgut_default_pagecolor_screen_clist}

\NewDocumentCommand { \letgutalertboxdefaultcolor } {  } {
  \c__letgut_default_alert_box_color_tl
}

\NewDocumentCommand { \letgutallcolorslinks } {  } {
  \c__letgut_default_allcolors_links_color_tl
}

\NewDocumentCommand { \docker } { s } {
  \IfBooleanTF{#1}%
  {\software{docker}}%
  {\software[https://docs.docker.com/]{Docker}}%
}

\pdfstringdefDisableCommands{%
  \def\docker{Docker}
}
\ExplSyntaxOff

% Acronymes
\letgutacro[tag=thisdocument]{LD}{\LaTeX{} dĂ©pendant}
\letgutacro[tag=thisdocument]{CD}{Compact Disc}[]
\letgutacro[tag=thisdocument]{TLMGR}{\TeX~Live Manager}[gestionnaire \TeX~Live]
\letgutacro[tag=thisdocument,short=no-op,short-format=\upshape] % DĂ©sactive les petites capitales
{NOOP}
{No Operation}
[instruction nulle]
\letgutacro{CPGĂ‰}{Classes PrĂ©paratoires aux Grandes Ă‰coles}

% Ă‰lĂ©ments du titre
\title{%
  Documentation de la
  \texorpdfstring{%
    \letgutcls%
  }{%
    classe letgut%
  }%
}
\author{Association GUTenberg}
\date{%
  Version 0.9.9 en date du \today%
  \texorpdfstring{%
    \\
    \url{https://framagit.org/gutenberg/letgut}%
  }{%
  }%
}

% \tcbset{index command name=\jobname-commands}
% \makeindex[name=\jobname-commands,title=Index des commandes,extout=odx,extin=ond,columnseprule]
% \makeindex[title=Index des concepts,extout=pdx,extin=pnd,columnseprule]
\begin{document}

\syntaxhl{%
  LaTeX,%
  acro,%
  babel-french,%
  biblatex,%
  biolinum,%
  % classes,%
  csquotes,%
  % graphicx,%
  hologo,%
  hyperref,%
  letgut,%
  listings,%
  tcolorbox,%
  varioref,%
}

\title{Introduction}
\label{sec:introduction}
L'association \gutenberg{} publie la \lettregut{}, son bulletin irrĂ©gulomestriel,
depuis fĂ©vrier 1993 \autocite{AssociationGUTenbergLettreGUTenberg}.

Pour ce faire, une classe \hologo{(La)TeX} dĂ©diĂ©e, maison, a peu Ă&nbsp; peu vu le
jour\footnote{Notamment grĂ˘ce au concours de \person{AndrĂ©, Jacques},
  \person{Flipo, Daniel} et \person{Chupin, Maxime}.} mais, au grĂ© des
nouveaux besoins et des personnes qui ont assurĂ© la publication de la \lettre{},
son dĂ©veloppement a Ă©tĂ© quelque peu erratique ; il n'aurait notamment pas Ă©tĂ©
possible de publier son code en l'Ă©tat. En outre, sa documentation Ă©tait
inexistante.

Le \ca{} de l'association Ă©lu en novembre 2020 a souhaitĂ© fournir une classe
mieux structurĂ©e, davantage pĂ©renne et documentĂ©e, Ă&nbsp; mĂŞme d'ĂŞtre publiĂ©e sur le
\ctan{}. C'est dĂ©sormais chose faite avec la prĂ©sente \letgutcls\footnote{Ă€
  cette occasion, la classe a Ă©tĂ© lĂ©gĂ¨rement renommĂ©e de \class[]{let-gut} en
  \letgut{}.}.

\title{Usage de la classe \letgut}
\label{sec:usage-de-la}

\section{Compilation}
\label{sec:compilation}

\begin{dbwarning}{\hologo{LuaLaTeX} (rĂ©cent) et UTF-8 nĂ©cessaires}{lualatex-recent}
  Les documents recourant Ă&nbsp; la \letgutcls{} doivent :
  \begin{itemize}
  \item ĂŞtre compilĂ©s avec le moteur \hologo{LuaLaTeX}\footnote{Dans une version
      au minimum \texttt{1.13.2}, le format \software{lualatex} devant ĂŞtre dans
      une version au minimum \texttt{2021.6.6}.} ;
  \item avoir (de ce fait) comme codage d'entrĂ©e l'UTF-8\footnote{Y compris les
      fichiers sources auxiliaires tels que les \file{.bib}.}.
  \end{itemize}
\end{dbwarning}

La section \enquote{\nameref{recours-docker}}, \vpageref{recours-docker},
dĂ©taille un moyen de de disposer d'une telle version de \hologo{LuaLaTeX} sans
risque de perturber une installation de \hologo{(La)TeX} dĂ©jĂ&nbsp; existante.

\section{Options}
\label{sec:options}

\subsection{Options de la \class*{article}}
\label{sec:options-de-la}

La \letgutcls{} est basĂ©e sur la \class*{article}, chargĂ©e avec les options
\docAuxKey{twoside} et \docAuxKey{11pt} qui ne peuvent donc ĂŞtre
surchargĂ©es. Les autres options peuvent ĂŞtre employĂ©es mais sont dĂ©conseillĂ©es
par souci d'homogĂ©nĂ©itĂ© de la mise en page des numĂ©ros successifs de la
\lettregut{}.

\subsection{Options de la \letgutcls}
\label{sec:options-de-la}

\subsubsection{SpĂ©cification}
\label{sec:specification}

Les options de la \letgutcls{} peuvent ĂŞtre spĂ©cifiĂ©es de deux faĂ§ons :
\begin{enumerate}
\item en argument de la commande dĂ©diĂ©e \refCom{letgutsetup} ;
\item Ă&nbsp; la compilation, au moyen de la commande (Ă&nbsp; lancer dans un terminal) :
\begingroup
\lstset{basicstyle=\ttfamily\small}
\terminal{lualatex '\PassOptionsToClass{ÂŁ\meta{options}ÂŁ}{letgut} \input{ÂŁ\meta{fichier}ÂŁ}'}{}
\endgroup
\end{enumerate}

\begin{dbwarning}{Options de \letgut{} : pas en argument optionnel
    de \docAuxCommand{documentclass}}{}
  On Ă©vitera de passer les options de la \letgutcls{} en argument optionnel de
  la commande \docAuxCommand{documentclass} et ce, de sorte Ă&nbsp; Ă©viter les
  conflits d'options avec les diffĂ©rents packages chargĂ©s.
\end{dbwarning}

\begin{docCommand}{letgutsetup}{\marg{options}}
  \index{configuration}%
  Cette commande permet de spĂ©cifier les \meta{options} de la \letgutcls{}.
\end{docCommand}

\subsubsection{Liste des options}
\label{sec:liste-des-options}

\begin{docKeys}
  {
    {
      doc name = for-readers,
      doc description = {\valinitdef[\docValue*{true}][\docValue*{true}]},
    },
    {
      doc name = for-authors,
      doc description = {\valinitdef[\docValue*{false}][\docValue*{true}]},
    },
  }%
  %
  Ces clĂ©s boolĂ©ennes, contraires l'une de l'autre, activent les versions
  respectivement \enquote{pour lecteurs} (par dĂ©faut) et \enquote{pour auteurs}
  de la \lettre{}. Celles-ci mettent en page la \lettre{} respectivement :
  \begin{itemize}
  \item telle que les lecteurs finaux la liront ;
  \item telle que les auteurs d'articles de la \lettre{} peuvent le souhaiter au
    cours de leur rĂ©daction, notamment sans :
    \begin{itemize}
    \item titre ;
    \item (r)appel Ă&nbsp; cotisation (cf. clĂ© \refKey{membership-reminder}) ;
    \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}) ;
    \item fichiers attachĂ©s au \pdf{} produit (cf. clĂ©
      \refKey{reverse-files-attachement}).
    \end{itemize}
  \end{itemize}
\end{docKeys}

\begin{docKeys}
  {
    {
      doc name = draft,
      doc description = {\valinitdef[\docValue*{true}][\docValue*{true}]},
    },
    {
      doc name = final,
      doc description = {\valinitdef[\docValue*{false}][\docValue*{true}]},
    },
  }%
  %
  Ces clĂ©s boolĂ©ennes, contraires l'une de l'autre, activent les versions
  respectivement \enquote{brouillon} (par dĂ©faut) et \enquote{final} de la
  \lettre{}.

  En version \enquote{brouillon}, et seulement dans cette version% \footnote{Avec
    % la version actuelle, une consĂ©quence supplĂ©mentaire mais temporaire est
    % que }
  :
  \begin{enumerate}
  \item le \package*{lua-typo} est chargĂ©\footnote{En fait, cela est
      momentanĂ©ment dĂ©sactivĂ© car le \package*{luacolor}, chargĂ© en sous-main
      par \package{lua-typo}, ne fonctionne actuellement pas bien avec une
      fonctionnalitĂ© du noyau \hologo{LaTeX} utilisĂ©e par la classe (plus de
      dĂ©tails
      \href{https://github.com/ho-tex/luacolor/issues/4}{ici}.)}. Celui-ci met
    en lumiĂ¨re, par un changement de couleur, les lignes typographiquement
    imparfaites dâ€™un fichier \pdf*{} produit par \hologo{LuaLaTeX} ;
  \item le mot \enquote{Brouillon} figure en filigrane sur chaque page ;
  \item les boĂ®tes trop pleines (\foreignloc{Overfull \docAuxCommand*{hbox}})
    sont mises en Ă©vidence comme avec les classes standards.
  \end{enumerate}
\end{docKeys}

\begin{docKeys}
  {
    {
      doc name = screen,
      doc description = {\valinitdef[\docValue*{true}][\docValue*{true}]},
    },
    {
      doc name = paper,
      doc description = {\valinitdef[\docValue*{false}][\docValue*{true}]},
    },
  }%
  %
  Ces clĂ©s boolĂ©ennes, contraires l'une de l'autre, activent les formats de
  sortie respectivement \enquote{Ă©cran} (par dĂ©faut) et \enquote{papier} de la
  \lettre{}.

  En version \enquote{Ă©cran}, et seulement dans cette version, la couleur de
  fond du papier est par dĂ©faut non pas le blanc mais celle spĂ©cifiĂ©e (et
  modifiable) par \refKey{pagecolor}.
\end{docKeys}

\begin{docKey}{number}{=\meta{numĂ©ro}}{\valinitdef}
  Cette clĂ© permet de spĂ©cifier le \meta{numĂ©ro} de la \lettre{}.
\end{docKey}

{%
  % \tcbset{before lower=\vspace*{.5\baselineskip}\par}
  \begin{docKey}{date}{=\meta{annĂ©e}\texttt{-}\meta{mois} ou \meta{texte}}{\valinitdef[annĂ©e et mois en cours]}
    Cette clĂ© permet de spĂ©cifier la date de la \lettre{}. Celle-ci est affichĂ©e sous
    la forme :
    \begin{itemize}
    \item \enquote{\meta{Mois} \meta{annĂ©e}} dans les cas oĂą l'option :
      \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}
        oĂą \meta{annĂ©e} et \meta{mois} doivent ĂŞtre des nombres entiers
        positifs. Les garde-fous suivants sont mis en place :
        \begin{itemize}
        \item si \meta{annĂ©e} n'est pas celle en cours ou la suivante, elle est
          remplacĂ©e par l'annĂ©e en cours ;
        \item si \meta{mois} n'est pas entre $1$ et $12$, il est remplacĂ© par le
          mois en cours ;
        \end{itemize}
      \end{itemize}
    \item \enquote{\meta{texte}} si l'option est employĂ©e sous la forme
      \refKey*{date}â„˘=â„˘\meta{texte}.
    \end{itemize}
  \end{docKey}
}

\begin{docKey}{pagecolor}{=\marg{couleur}}{\valinitdef[\docValue*{letgut_pagecolor}]}
  Cette clĂ© permet, si (et seulement) l'option \refKey{paper} \emph{n'}est
  \emph{pas} employĂ©e, de spĂ©cifier (selon le modĂ¨le \enquote{rgb}) une
  \meta{couleur} de fond du papier autre que celle appliquĂ©e par
  dĂ©faut\footnote{C'est-Ă&nbsp;-dire \colorbox{letgutdefaultpagecolor}{celle-ci}% , dont
    % la valeur \enquote{rgb} est \docValue*{\letgutdefaultpagecolor}
    .}.
\end{docKey}

\begin{docKey}{allcolorslinks}{=\meta{couleur}}{\valinitdef[\docValue*{letgut_allcolors_links}]}
  Cette clĂ© permet de spĂ©cifier (selon le modĂ¨le \enquote{\foreignloc{named}})
  une \meta{couleur} pour (tous) les liens hypertextes autre que celle
  \docColor{letgut_allcolors_links} par dĂ©faut\footnote{C'est-Ă&nbsp;-dire
    \textcolor{letgut_allcolors_links}{celle-ci}% , Ă©gale
    % Ă&nbsp; \docValue*{\letgutallcolorslinks}
    .}.
\end{docKey}

\begin{docKey}{membership-reminder}{}{\valinitdef[\docValue*{true}][\docValue*{true}]}
  Cette clĂ© boolĂ©enne affiche automatiquement un (r)appel Ă&nbsp; cotisation en bas de
  1\iere{} page de la \lettre{}.
\end{docKey}

\begin{docKey}{editorial}{}{\valinitdef[\docValue*{true}][\docValue*{true}]}
  Cette clĂ© boolĂ©enne importe automatiquement en tout dĂ©but de la \lettre{}
  (nĂ©anmoins aprĂ¨s le titre et le sommaire) le \file*{editorial.tex} contenant
  l'Ă©ditorial. Si aucun \file*{editorial.tex} n'est trouvĂ©, un avertissement est
  Ă©mis lors de la compilation et une boĂ®te d'alerte est affichĂ©e en 1\iere{}
  page.
\end{docKey}

\begin{docKey}{informations}{}{\valinitdef[\docValue*{true}][\docValue*{true}]}
  Cette clĂ© boolĂ©enne importe automatiquement en derniĂ¨re page de la \lettre{}
  le \file*{informations-gut.tex} contenant toutes les informations sur
  \gut{}. Si aucun \file*{informations-gut.tex} n'est trouvĂ©, un avertissement
  est Ă©mis lors de la compilation et une boĂ®te d'alerte est affichĂ©e en derniĂ¨re
  page.
\end{docKey}

\tcbset{before lower=\vspace*{.5\baselineskip}\par}
%
\begin{docKey}[][doc updated={2023-01-19}]{detailedtoc}{=\docValue{section}\textbar\docValue{subsection}\textbar\docValue{subsubsection}\textbar\docValue{paragraph}\textbar\docValue{subparagraph}}{\valinitdef[\docValue*{title}][\docValue*{all}]}
  Par dĂ©faut, une table des matiĂ¨res est automatiquement insĂ©rĂ©e en dĂ©but de
  document, avec comme niveau de profondeur celui des titres des articles
  (saisis via la \refCom{title}), et seulement eux.  La clĂ© \refKey{detailedtoc}
  permet de modifier le \enquote{niveau de profondeur} de cette table des
  matiĂ¨res, respectivement jusqu'aux sections, sous-sections,
  sous-sous-sections, paragraphes, sous-paragraphes. Sont Ă©galement acceptĂ©es
  les valeurs spĂ©ciales :
  \begin{itemize}
  \item \docValue{all} (alias de \docValue{subparagraph}) ;
  \item \docValue{none} qui inhibe l'affichage de la table des matiĂ¨res.
  \end{itemize}

  \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 l'une des valeurs possibles de la clĂ© \refKey{detailedtoc}).
  \end{dbremark}
\end{docKey}

\begin{docKey}[][doc new={2023-01-14}]{reverse-files-attachement}{}{\valinitdef[pas de valeur]}
  Si, et seulement si, la \lettre{} est Ă&nbsp; 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) Ă&nbsp; 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}

D'autres options peuvent ĂŞtre passĂ©es Ă&nbsp; la \letgutcls{}. Il est ainsi possible
de faire usage de langues du \package*{babel}, autres que le franĂ§ais et
l'anglais dĂ©jĂ&nbsp; chargĂ©es par \letgut{}, en les stipulant en option de
\docAuxCommand{documentclass} et en les employant selon la syntaxe de ce
package.

\section{Titre et titres courants}
\label{sec:titre}
Si la commande \docAuxCommand{title}\marg{titre} est
\begin{description}
\item[\emph{non} utilisĂ©e :] le titre du document est construit Ă&nbsp; partir du
  \meta{numĂ©ro} et de la \meta{date} spĂ©cifiĂ©s (cf. clĂ©s \refKey{number} et
  \refKey{date}). Il figure alors automatiquement en 1\iere{} page sous la forme
  \enquote{NumĂ©ro \meta{numĂ©ro} -- \meta{date}}. Le titre courant est alors
  \enquote{La \lettregut{}, \meta{date}} ;
\item[\phantom{\emph{non}} utilisĂ©e\footnotemark{} :]\footnotetext{Ainsi que les
    habituelles commandes \docAuxCommand{author} et \docAuxCommand{date}.}  et
  ce, \emph{avant \lstinline+\\begin\{document\}+}, le \meta{titre} du document
  figure alors automatiquement en 1\iere{} page sous sa forme habituelle et est
  suivie d'un changement de page. Le titre courant est alors
  \enquote{\meta{titre}, \meta{date}}.
\end{description}

\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
    \nameref{sec:structuration} \vpageref{sec:structuration} et
    \nameref{sec:sign-des-articl} \vpageref{sec:sign-des-articl}).
\end{dbwarning}

\begin{dbwarning}{Commande \docAuxCommand{maketitle} Ă&nbsp; \emph{ne pas} employer}{}
  La commande \docAuxCommand{maketitle} est Ă&nbsp; \emph{ne pas} employer car elle
  l'est en sous-main par la classe.
\end{dbwarning}

\section{Importation d'articles}
\label{sec:import-dart}

\begin{dbwarning}{Importation de fichiers d'articles}{}
  Si le contenu d'un article est stockĂ© dans un \meta{fichier enfant}\file{.tex},
  on l'importera dans un fichier parent recourant Ă&nbsp; la \letgutcls{} :
  \begin{itemize}
  \item \emph{non pas} au moyen de la commande ordinaire \docAuxCommand{input} ;
  \item \emph{mais}  au moyen de la commande \refCom{inputarticle}.
  \end{itemize}
\end{dbwarning}

\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) Ă&nbsp; 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 Ă&nbsp; un certain
  nombre de rĂ©initialisations.
\end{docCommands}

\section{Structuration}
\label{sec:structuration}

\begin{docCommands}[
  doc parameter = \oarg{intitulĂ© alternatif}\marg{intitulĂ©}
  ]
  {
    { doc name = title },
    { doc name = subtitle },
    { doc name = section },
    { doc name = subsection },
    { doc name = subsubsection },
    { doc name = paragraph },
    { doc name = subparagraph },
  }
  %
  Ces commandes permettent de structurer le contenu de la \lettre{} :
  \begin{itemize}
  \item \refCom{title} est celle de plus haut niveau, introduisant
    l'\meta{intitulĂ©} de chaque article (automatiquement composĂ© en grandes
    capitales et prĂ©cĂ©dĂ© de l'ornement \aldineleft) ;
  \item \refCom{subtitle}, de niveau suivant et facultative, introduisant un
    \meta{intitulĂ©} d'Ă©ventuel sous-titre d'article (automatiquement composĂ© en
    grandes capitales). Ceci peut ĂŞtre utile par exemple pour distinguer des
    parties indĂ©pendantes d'un mĂŞme article ;
  \item celles de niveaux suivants sont les habituelles commandes de
    structuration fournies par la \class*{article}.
  \end{itemize}
\end{docCommands}

\begin{dbremark}{Structure non numĂ©rotĂ©e}{}
  Les titres, sous-titres, sections, sous-sections, etc. de la \lettre{} ne sont
  pas numĂ©rotĂ©s. Aussi pourra-t-on, pour faire rĂ©fĂ©rence Ă&nbsp; l'une de ces
  rubriques, recourir aux commandes :
  \begin{itemize}
  \item \docAuxCommand{nameref} pour en citer l'\meta{intitulĂ©} ;
  \item \docAuxCommand{vpageref} pour en citer la page ;
  \item \docAuxCommand{enquote} pour, le cas Ă©chĂ©ant, faire figurer
    l'\meta{intitulĂ©} entre guillemets ;
  % \item \docAuxCommand{namecref} (fournie par le \package*{cleveref}, chargĂ© par
  %   \letgut{}) pour en citer la nature (le cas Ă©chĂ©ant).
  \end{itemize}
  ces trois commandes Ă©tant directement utilisables puisque fournies par les
  packages respectivement \package{hyperref}, \package{varioref} et
  \package{csquotes}, chargĂ©s en sous-main par la \letgutcls{}.
\end{dbremark}

\begin{ltx-code-result}[title addon=rĂ©fĂ©rences croisĂ©es aux rubriques,listing options app={deletekeywords={[3]{nameref,section}}}]
On lira avec intĂ©rĂŞt la section \enquote{\nameref{sec:acronymes}}
\vpageref{sec:acronymes}.
\end{ltx-code-result}

\section[Personnes et auteurs]{Noms de personnes et d'auteurs d'articles}
\label{sec:sign-des-articl}

% Les prĂ©nom, nom et titre d'une personne peuvent ĂŞtre affichĂ©s au moyen de la
% commande \refCom{person} suivante.

\begin{docCommands}[
  doc name = person,
  doc name = author,
  ]
  {
    {
      doc name = person,
      doc parameter = \marg{donnĂ©es}
    },
    {
      doc name = person,
      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}
    },
    {
      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}
  %
  Ces commandes affichent\footnote{Au fer Ă&nbsp; droite pour \refCom{author}.} les
  \meta{donnĂ©es} (noms et Ă©ventuels prĂ©noms et titres) d'une ou plusieurs
  personnes ou d'un ou plusieurs auteurs d'articles, ces \meta{donnĂ©es}
  Ă©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}
  \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
\meta{prĂ©nom}, chacune des initiales et des premiĂ¨res lettres aprĂ¨s un espace ou
un tiret est affichĂ© en grande capitale.

\begin{ltx-code-result}[title addon=personnes]
On peut dire merci Ă&nbsp;
\person{Knuth, Donald E., dieu and Lamport, Leslie} !
\end{ltx-code-result}

\begin{ltx-code-result}[title addon=auteur,listing options app={deletekeywords={[3]{author}}}]
\begin{displayquote} % Fourni par `csquotes' chargĂ© par `letgut'
  Wait, wait, I never said that.
  \author{knuth, dONALD e.}
\end{displayquote}
\end{ltx-code-result}

\section{Aide Ă&nbsp; la saisie et homogĂ©nĂ©isation de la mise en forme}
\label{sec:aide-la-saisie}

Les articles de la \lettre{} sont Ă©maillĂ©s de concepts (packages ou classes
\hologo{(La)TeX}, logiciels, etc.) et de termes et expressions
(\enquote{\gut{}}, \enquote{\lettre{}}, etc.) employĂ©s de faĂ§on
rĂ©currente. Aussi des commandes spĂ©cifiques sont-elles prĂ©vues de faĂ§on Ă&nbsp; en
faciliter la saisie et Ă&nbsp; en homogĂ©nĂ©iser la mise en forme.

\subsection{Packages et classes, logiciels, fichiers}
\label{sec:classes-packages-et}

\begin{docCommands}
  {
    {
      doc name = package,
      doc parameter = \oarg{URL}\marg{nom},
    },
    {
      doc name = package*,
      doc parameter = \oarg{URL}\marg{nom}\oarg{prĂ©fixe},
    },
    {
      doc name = class,
      doc parameter = \oarg{URL}\marg{nom},
    },
    {
      doc name = class*,
      doc parameter = \oarg{URL}\marg{nom}\oarg{prĂ©fixe},
    },
  }
  %
  Ces commandes affichent le \meta{nom} d'un package ou d'une classe
  \hologo{(La)TeX}. Le \meta{nom} affichĂ© est un lien hypertexte si et seulement
  si l'argument optionnel est :
  \begin{description}
  \item[\emph{non} employĂ©] la cible Ă©tant alors
    \url{https://ctan.org/pkg/}\meta{nom} ;
  \item[\phantom{\emph{non}} employĂ©] mais non vide, la cible Ă©tant alors
    \meta{URL}.
  \end{description}
  Pour que le \meta{nom} affichĂ© ne soit pas un lien hypertexte, il suffit
  d'employer un argument optionnel vide.

  Les versions Ă©toilĂ©es font prĂ©cĂ©der le \meta{nom} d'un \meta{prĂ©fixe} qui, par
  dĂ©faut, est respectivement \enquote{package} et \enquote{classe}.
\end{docCommands}

\begin{ltx-code-result}[title addon=packages et classes,listing options app={deletekeywords={[4]{tables}}}]
La \class*{letgut} s'appuie entre autres sur le \package*{etoc}
(qui permet de personnaliser les tables des matiĂ¨res).

Une des classes s'appuyant sur le \package*[]{etoc} est
\class[https://framagit.org/gutenberg/letgut/]{letgut}.
\end{ltx-code-result}

\begin{docCommands}
  {
    {
      doc name = software,
      doc parameter = \oarg{URL}\marg{nom},
    },
    {
      doc name = software*,
      doc parameter = \oarg{URL}\marg{nom}\oarg{prĂ©fixe},
    },
  }
  %
  Ces commandes affichent le \meta{nom} d'un logiciel qui est optionnellement un
  lien hypertexte vers \meta{URL}.  La version Ă©toilĂ©e fait prĂ©cĂ©der le
  \meta{nom} d'un \meta{prĂ©fixe} qui, par dĂ©faut, est \enquote{logiciel}.
\end{docCommands}

\begin{docCommands}
  {
    {
      doc name = file,
      doc parameter = \marg{nom},
    },
    {
      doc name = file*,
      doc parameter = \marg{nom}\oarg{prĂ©fixe},
    },
  }
  %
  Ces commandes affichent le \meta{nom} d'un fichier.  La version Ă©toilĂ©e fait
  prĂ©cĂ©der le \meta{nom} d'un \meta{prĂ©fixe} qui, par dĂ©faut, est
  \enquote{fichier}.
\end{docCommands}

\begin{ltx-code-result}[title addon=logiciels et fichiers,listing options app={deletekeywords={[3]{file,plus,l,tex}}}]
Le \file*{test.tex} a Ă©tĂ© ouvert dans le
\software*[https://www.gnu.org/software/emacs/]{Emacs}, plus
prĂ©cisĂ©ment dans \software*{Emacs}[l'Ă©diteur de texte].
\end{ltx-code-result}

\begin{dbwarning}{Commandes pas toutes bienvenues en \docAuxCommand{title} et
    \docAuxCommand{subtitle}}{}
  Lorsqu'elles sont employĂ©es en argument des commandes \refCom{title} et
  \refCom{subtitle}, les versions Ă©toilĂ©es de ces commandes ont des effets
  indĂ©sirables (prĂ©fixes pas en grandes capitales et signets non conformes).
\end{dbwarning}

\subsection{Locutions Ă©trangĂ¨res, points de code Unicode}

\begin{docCommand}{foreignloc}{\marg{locution}}
  Cette commande est conĂ§ue pour afficher une \meta{locution} Ă©trangĂ¨re.
\end{docCommand}

\begin{docCommand}{latinloc}{\marg{locution}}
  Cette commande est conĂ§ue pour afficher une \meta{locution} latine.
\end{docCommand}

\begin{ltx-code-result}[title addon=locutions Ă©trangĂ¨res,listing options app={deletekeywords={[3]{options}}}]
Attention aux \foreignloc{load-time options} !
Mais... \latinloc{errare humanum est}.
\end{ltx-code-result}

\begin{docCommand}{Ucode}{\oarg{nom}\marg{point de code}}
  Cette commande est conĂ§ue pour afficher le \meta{point de code} et
  Ă©ventuellement le \meta{nom} d'un caractĂ¨re Unicode sous la forme
  \enquote{U+\meta{point de code} (\meta{\textsc{nom}})}.
\end{docCommand}

\begin{ltx-code-result}[title addon=Point de code d'un caractĂ¨re Unicode,listing options app={deletekeywords={[3]{options}}}]
Unicode a prĂ©vu le caractĂ¨re \Ucode[symbole numĂ©ro]{2116}.
\end{ltx-code-result}

\subsection{Termes et expressions (figĂ©s)}
\label{sec:termes}

\begin{docCommands}
  {
    { doc name = gutenberg },
    { doc name = gut },
    { doc name = assogut, doc new={2023-01-14} },
    { doc name = Assogut, doc new={2023-01-14} },
    { doc name = lettresn doc new={2023-01-14} },
    { doc name = lettresgut, doc new={2023-01-14} },
    { doc name = cahier },
    { doc name = cahiers },
    { doc name = cahiergut },
    { doc name = cahiersgut },
    { doc name = letgut },
    { doc name = letgutcls },
    { doc name = knuth },
    { doc name = lamport },
    { doc name = tl },
    { doc name = tugboat },
    { doc name = linux },
    { doc name = macos },
    { doc name = windows },
  }
  %
  Ce que ces commandes affichent est rĂ©pertoriĂ© dans le \vref{tab:raccourcis}.
\end{docCommands}

\begin{table}[htb]
  \centering
  \begin{tabular}{ll}
    \toprule
    \refCom{gutenberg}  &amp; \gutenberg  \\
    \refCom{gut}        &amp; \gut        \\
    \refCom{assogut}    &amp; \assogut    \\
    \refCom{Assogut}    &amp; \Assogut    \\
    \refCom{lettres}    &amp; \lettres    \\
    \refCom{lettresgut} &amp; \lettresgut \\
    \refCom{cahier}     &amp; \cahier     \\
    \refCom{cahiergut}  &amp; \cahiergut  \\
    \refCom{cahiers}    &amp; \cahiers    \\
    \refCom{cahiersgut} &amp; \cahiersgut \\ \midrule
    \refCom{letgut}     &amp; \letgut     \\
    \refCom{letgutcls}  &amp; \letgutcls  \\ \midrule
    \refCom{knuth}      &amp; \knuth      \\
    \refCom{lamport}    &amp; \lamport    \\
    \refCom{tl}         &amp; \tl         \\
    \refCom{tugboat}    &amp; \tugboat    \\ \midrule
    \refCom{linux}      &amp; \linux      \\
    \refCom{macos}      &amp; \macos      \\
    \refCom{windows}    &amp; \windows    \\ \bottomrule
  \end{tabular}
  \caption{Effet des commandes de raccourcis}
  \label{tab:raccourcis}
\end{table}

Par homogĂ©nĂ©itĂ© avec les commandes \refCom{class} et \refCom{class*}, on aurait
pu souhaiter que les terme et expression \enquote{\letgut} et
\enquote{\letgutcls} soient produits par \refCom{letgut} et
\docAuxCommand*{letgut*}. Mais cette derniĂ¨re commande, Ă©toilĂ©e, a dĂ» ĂŞtre
remplacĂ©e par une commande non Ă©toilĂ©e (\refCom{letgutcls}), sans quoi un
problĂ¨me technique aurait empĂŞchĂ© l'utilisation de \refCom{letgut} en argument
de \docAuxCommand{section}%
\footnote{Plus de dĂ©tails
  \href{https://tex.stackexchange.com/q/493017/18401}{ici}.}.

\begin{dbwarning}{Commande \refCom{letgutcls} pas bienvenue en \docAuxCommand{title} et
    \docAuxCommand{subtitle}}{}
  Lorsqu'elle est employĂ©e en argument des commandes \refCom{title} et
  \refCom{subtitle}, la commande \refCom{letgutcls} a un effet indĂ©sirable
  (prĂ©fixe pas en grandes capitales).
\end{dbwarning}

\begin{docCommands}[
    doc new=2022-10-03,
    doc name=lettrenumber,
    doc parameter = \oarg{entier relatif signĂ©}
  ]
  {
    { },
    { doc name=lettrenumber* },
  }
  \index{configuration}%
  Cette commande affiche le numĂ©ro de la \lettre{} :
  \begin{description}
  \item[en cours] si l'argument optionnel n'est pas employĂ© ;
  \item[dĂ©calĂ© de celui en cours] de l'\meta{entier relatif
      signĂ©}\footnote{\label{entier-signe}C.-Ă&nbsp;-d. un \enquote{plus} ou un
      \enquote{moins} (\lstinline|+| ou \lstinline|-|) suivi d'un nombre
      entier.} spĂ©cifiĂ© sinon.
  \end{description}
  En version Ă©toilĂ©e, la chaĂ®ne \enquote{\no{}} prĂ©cĂ¨de ce numĂ©ro.
\end{docCommands}

\ExplSyntaxOn
\int_gset:Nn \g__letgut_number_int {46}
\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 :
\begin{enumerate}
\item en cours est \lettrenumber ;
\item en cours est le \lettrenumber* ;
\item suivante est \lettrenumber[+1] ;
\item prĂ©cĂ©dente est le \lettrenumber*[-1].
\end{enumerate}
\end{ltx-code-result}

\begin{docCommands}[]
  {
    { doc name = lettre },
    { doc name = lettre,  doc new=2022-10-03, doc parameter = \oarg{argument optionnel} },
    { doc name = lettre*, doc new=2022-10-03, doc parameter = \oarg{argument optionnel} },
    { doc name = lettregut },
    { doc name = lettregut,  doc new=2022-10-03, doc parameter = \oarg{argument optionnel} },
    { doc name = lettregut*, doc new=2022-10-03, doc parameter = \oarg{argument optionnel} },
  }
  %
  Ces commandes affichent les chaĂ®nes de caractĂ¨res respectivement
  \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[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.
  \end{description}
  En version Ă©toilĂ©e, la chaĂ®ne \enquote{\no{}} prĂ©cĂ¨de le numĂ©ro (seulement si
  l'\meta{argument optionnel} est employĂ©).
\end{docCommands}

\begin{ltx-code-result}[title addon=emplois des commandes \refCom{lettre} et \refCom{lettregut},listing options app={deletekeywords={[6]{cours,lettre}}}]
Si le numĂ©ro de la \lettre{} en cours est 46, on a :
\begin{enumerate}
\item \lettre
\item \lettre[.]
\item \lettre[+10]
\item \lettre[-10]
\item \lettre[43]
\item \lettre[coucou]
\item \lettre*[.]
\item \lettre*[+10]
\item \lettre*[-10]
\item \lettre*[43]
\item \lettre*
\end{enumerate}
On fait usage de ces commandes dans la \lettregut*[.].
\end{ltx-code-result}

\subsection{Touches de clavier}
\label{sec:touches-de-clavier}

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 Ă&nbsp; faciliter
la saisie pour toutes les touches des diacritiques utilisĂ©s en franĂ§ais.

\begin{ltx-code-result}[title addon=touches de clavier]
% De base (Ă©chantillon) :
\LKey{A} \LKey{Z} \LKey{0} \LKey{9}

\LKeyF{1} \LKeyF{12}

\LKeyCtrl \LKeyAlt \LKeyAltGr \LKeyShift \LKeyEnter \LKeyTab

\LKeyCtrlX{A} \LKeyShiftX{A} \LKeyAltX{A} \LKeyAltGrX{A}

\LKeyAt \LKeyScreenUp \LKeyScreenDown \LKeyCommand \LKeyOptionKey

\LMouseN \LMouseL \LMouseM \LMouseR

\LKey{exclam} \LKey{numbersign} \LKey{percent} \LKey{backslash}

% AjoutĂ©s par la classe `letgut`
\LKey{Ă&nbsp;} \LKey{Ă€} \LKey{Ă˘} \LKey{Ă‚} \LKey{Ă©} \LKey{Ă‰}
\LKey{Ă¨} \LKey{Ă} \LKey{ĂŞ} \LKey{ĂŠ} \LKey{Ă«} \LKey{Ă‹}
\LKey{Ă®} \LKey{ĂŽ} \LKey{ĂŻ} \LKey{ĂŹ}
\LKey{Ă´} \LKey{Ă”}
\LKey{Ăą} \LKey{Ă™} \LKey{Ă»} \LKey{Ă›} \LKey{ĂĽ} \LKey{Ăś}
\LKey{Ăż} \LKey{Ĺ¸} \LKey{Ă§} \LKey{Ă‡}
\end{ltx-code-result}

\begin{dbwarning}{Touche de clavier du symbole â‚¬ manquant}{}
  La touche de clavier du symbole â‚¬ n'est pas fournie par le
  \package*{biolinum}.
\end{dbwarning}

\section{Codes informatiques}
\label{sec:code-informatique}

Cette section est consacrĂ©e aux outils spĂ©cifiques Ă&nbsp; la \letgutcls{} permettant
de faire figurer du code informatique dans la \lettre{}.

\subsection{Codes \hologo{(La)TeX}}
\label{sec:exemples-de-codes}

\subsubsection{Exemples de codes \hologo{(La)TeX}, possiblement avec rĂ©sultats}
\label{sec:listings-}

Afin de prĂ©senter aisĂ©ment et de faĂ§on homogĂ¨ne les exemples de codes
\hologo{(La)TeX}, possiblement avec leurs rĂ©sultats, la \letgutcls{} fournit les
environnements \enquote{verbatim} suivants.

\begin{docEnvironments}[
  doc parameter = \oarg{options},
  doclang/environment content = code,
  ]{
    {
      doc name = ltx-code,
      % doc description = code (seulement),
    },
    {
      doc name = ltx-code-result,
      % doc description = % code
      % $+$ rĂ©sultat (interne),
    },
    {
      doc name = ltx-code-external-result,
      doc parameter = \oarg{options}\marg{fichier},
      % doc description = % code
      % $+$ rĂ©sultat (externe),
    },
  }
  Ces environnements affichent le \meta{code} \hologo{(La)TeX} qui y est insĂ©rĂ© et
  pour :
  \begin{description}
  \item[\refEnv{ltx-code}] seulement ce \meta{code} ;
  \item[\refEnv{ltx-code-result}] Ă©galement le rĂ©sultat, compilĂ© en mĂŞme temps
    que la \lettre{} ;
  \item[\refEnv{ltx-code-external-result}] Ă©galement le rĂ©sultat, compilĂ©
    indĂ©pendamment de la \lettre{} et dont le \meta{fichier} image est spĂ©cifiĂ©.
  \end{description}
\end{docEnvironments}

\begin{dbremark}{Mise en page des exemples de codes}{}
  \begin{enumerate}
  \item Les exemples de codes (avec ou sans rĂ©sultats) sont par dĂ©faut
    automatiquement coupĂ©s en frontiĂ¨re de page.
  \item Les exemples de codes avec rĂ©sultats (environnements
    \refEnv{ltx-code-result} et \refEnv{ltx-code-external-result}), prĂ©sentent
    ces codes et rĂ©sultats :
    \begin{itemize}
    \item l'un sous l'autre par dĂ©faut ;
    \item l'un Ă&nbsp; gauche de l'autre si l'option â„˘sidebysideâ„˘ est
      employĂ©e.
    \end{itemize}
  \end{enumerate}
\end{dbremark}

\begin{dbwarning}{Exemples de codes avec rĂ©sultats : possiblement
    flottants}{exemples-flottants}
  Si l'option â„˘sidebysideâ„˘ est passĂ©e Ă&nbsp; l'un ou l'autre des
  environnements \refEnv{ltx-code-result} et \refEnv{ltx-code-external-result},
  l'exemple :
  \begin{itemize}
  \item prĂ©sente ses code et rĂ©sultat en regard ce qui rend impossible sa
    coupure en frontiĂ¨re de page ;
  \item est alors automatiquement flottant.
  \end{itemize}
  Dans le cas oĂą cet exemple (\no\meta{n}) s'avĂ¨re se trouver sur une page
  (\meta{q}) autre que celle (\meta{p}) de son point d'insertion, deux
  rĂ©fĂ©rences croisĂ©es sont automatiquement insĂ©rĂ©es :
  \begin{description}
  \item[une \enquote{avant} :] au point d'insertion de l'exemple pour indiquer
    qu'il est Ă&nbsp; consulter plus loin ; son texte, \emph{par dĂ©faut}
    \enquote{Cf. exemple \meta{n} page \meta{q}.}, peut ĂŞtre surchargĂ© au moyen
    de l'option \refKey{reference text} ;
  \item[une \enquote{arriĂ¨re} :] Ă&nbsp; la fin du titre de l'exemple ; son texte est
    \enquote{ (cf. page \meta{p})}.
  \end{description}
\end{dbwarning}

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
  \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
  les rĂ©glages par dĂ©faut, par exemple :
  \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 (Ă&nbsp; droite) au moyen de l'option
    â„˘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 Ă&nbsp; ces environnements :
  \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}.]}
    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'exemple s'avĂ¨re se trouver sur une page autre que
      celle de son point d'insertion.
    \end{itemize}
    Elle permet alors de surcharger le texte \enquote{Cf. exemple \meta{n} page
      \meta{q}.} automatiquement insĂ©rĂ© au point d'insertion de l'exemple
    (cf.~\vref{wa-exemples-flottants})\footnote{Il est par exemple possible de
      s'affranchir de ce texte en recourant Ă&nbsp; \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â„˘.
    \end{dbwarning}
  \end{docKey}
\end{itemize}

\subsubsection{Coloration syntaxique}
\label{sec:coloration}

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
  \package*{listings} ;
\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â„˘.
\end{dbwarning}

Il est nĂ©anmoins possible de spĂ©cifier d'autres langages et dialectes au moyen
de la commande \refCom{syntaxhl} suivante, Ă&nbsp; insĂ©rer avant le dĂ©but de l'exemple
de code concernĂ©.

\begin{docCommands}[
doc name = syntaxhl,
doc parameter = \marg{liste de dialectes},
]
{
  { },
  { doc parameter = \oarg{langage}\marg{liste de dialectes} },
}
Cette comande permet de spĂ©cifier :
\begin{itemize}
\item un \meta{langage} (par dĂ©faut \hologo{TeX}) ;
\item une \meta{liste de dialectes}, sĂ©parĂ©s par des virgules ;
\end{itemize}
auxquels on souhaite que s'applique la coloration syntaxique.
\end{docCommands}

\begin{dbwarning}{Dialectes colorĂ©s syntaxiquement seulement si dĂ©finis}{}
  Ceci suppose que ces langages et dialectes sont dĂ©finis (et saisis selon la
  syntaxe du \package*{listings}) dans le \file*{letgut-lstlang.sty} situĂ© :
  \begin{itemize}
  \item soit dans le dossier de la \lettre{} en cours ;
  \item soit dans le dossier parent de celui de la \lettre{} en cours ;
  \item soit  dans un dossier de la \tds{}
  \end{itemize}
\end{dbwarning}

Pour le langage \hologo{TeX}, ces dialectes sont essentiellement les classes et
les packages \hologo{(La)TeX} et un exemple de dĂ©claration de tel dialecte est
fourni section~\enquote{\nameref{sec:exemple-de-decl}},
\vpageref{sec:exemple-de-decl}.

\subsection{EntrĂ©es et sorties dans un terminal}
\label{sec:entrees-sorties}

Afin de prĂ©senter aisĂ©ment et de faĂ§on homogĂ¨ne des exemples de commandes
entrĂ©es et Ă©ventuellement de leurs sorties correspondantes, la \letgutcls{}
fournit la commande Ă&nbsp; arguments \enquote{verbatim} suivante.

\begin{docCommand}{terminal}{\oarg{prompt}\oarg{options}\marg{stdin}\marg{stdout}}
  %
  Cette commande affiche les codes en entrĂ©e (\meta{stdin}) et en sortie
  (\meta{stdout}), chacun des deux Ă©tant possiblement vide.

  Le \meta{prompt}, ou \enquote{invite de commande}, est par dĂ©faut le symbole
  \texttt{\$} affichĂ© en rouge.

  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,
    aussi, les commandes \docAuxCommand{DeclareTCBListing} et assimilĂ©es
    fournies par la bibliothĂ¨que \lstinline+xparse+ de ce package.}.
\end{docCommand}

Ainsi le code suivant :
\begingroup
\lstset{basicstyle=\ttfamily\scriptsize}
\begin{ltx-code}[listing options app={%
  deletekeywords={[3]{latex,width,height,string,label,by,example,system,tex}},%
  deletetexcs={edef,rlap,smash,expandafter,string}%
}]
\terminal{time rg foobar -g "*.sty" "/home/bitouze/texlive/2022"}{
/home/bitouze/texlive/2022/texmf-dist/tex/latex/skeyval/skeyval.sty
445:%       \usepackage[option1,option2]{foobar}
447:%       \expandafter\show\csname foobar.sty.poxkeys\endcsname

/home/bitouze/texlive/2022/texmf-dist/tex/latex/thmtools/thm-restate.sty
197:%%% support for keyval-style: restate=foobar

/home/bitouze/texlive/2022/texmf-dist/tex/latex/pinlabel/pinlabel.sty
284:\edef\foobar{[width=\@p@swidth sp,height=\@p@sheight sp]{\@p@dffile}}%
286:\@message{\string\@includegraphics@\foobar}%
287:\rlap{\smash{\expandafter\@includegraphics@\foobar}}%

/home/bitouze/texlive/2022/texmf-dist/tex/latex/theoremref/theoremref.sty
129:    its label by ``\thlabel{foobar}''. For example,

/home/bitouze/texlive/2022/texmf-dist/tex/latex/qrbill/qrbill.sty
12:%%   Marei Peischl (peiTeX) and Alex Antener (foobar LLC).
rg     -g  0,25s user 0,23s system 320% cpu 0,150 total
}
\end{ltx-code}

donne-t-il :

\terminal{time rg foobar -g "*.sty" "/home/bitouze/texlive/2022"}{
/home/bitouze/texlive/2022/texmf-dist/tex/latex/skeyval/skeyval.sty
445:%       \usepackage[option1,option2]{foobar}
447:%       \expandafter\show\csname foobar.sty.poxkeys\endcsname

/home/bitouze/texlive/2022/texmf-dist/tex/latex/thmtools/thm-restate.sty
197:%%% support for keyval-style: restate=foobar

/home/bitouze/texlive/2022/texmf-dist/tex/latex/pinlabel/pinlabel.sty
284:\edef\foobar{[width=\@p@swidth sp,height=\@p@sheight sp]{\@p@dffile}}%
286:\@message{\string\@includegraphics@\foobar}%
287:\rlap{\smash{\expandafter\@includegraphics@\foobar}}%

/home/bitouze/texlive/2022/texmf-dist/tex/latex/theoremref/theoremref.sty
129:    its label by ``\thlabel{foobar}''. For example,

/home/bitouze/texlive/2022/texmf-dist/tex/latex/qrbill/qrbill.sty
12:%%   Marei Peischl (peiTeX) and Alex Antener (foobar LLC).
rg     -g  0,25s user 0,23s system 320% cpu 0,150 total
}
\endgroup

\subsection{CaractĂ¨res d'Ă©chappement et de raccourci pour les
  extraits de code}
\label{sec:caract-dech-et}

\begin{dbwarning}{CaractĂ¨re d'Ă©chappement des listings}{}
  \lstset{escapechar=}%
  La \letgutcls{} dĂ©finit â„˘ÂŁâ„˘ comme caractĂ¨re d'Ă©chappement dans \LaTeX{} au
  sein d'un listing.
\end{dbwarning}

Au besoin, on pourra dĂ©sactiver ce caractĂ¨re actif au moyen de
\begin{ltx-code}
\lstset{escapechar=}
\end{ltx-code}

\begin{dbwarning}{Ă‰quivalent court de \docAuxCommand{lstinline}}{}
  Les extraits de code peuvent ĂŞtre saisis au moyen de la commande
  \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â„˘%
  (\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â„˘
\begin{ltx-code}
\lstMakeShortInlineÂŁ\texttt{â„˘}ÂŁ
\end{ltx-code}

  Au besoin, on pourra dĂ©sactiver ce caractĂ¨re actif au moyen de :
\begin{ltx-code}
\lstDeleteShortInlineÂŁ\texttt{â„˘}ÂŁ
\end{ltx-code}

\begin{dbremark}{Obtention du caractĂ¨re \texttt{â„˘}}{}
Le caractĂ¨re %
\texttt{â„˘} %
s'obtient :
\begin{itemize}
\item sous \linux{} : \LKeyShiftAltGrX{8}\footnote{Touche \LKey{8} du clavier
    principal.} ;
\item sous \macos{} : Ă&nbsp; l'aide du visualiseur de caractĂ¨res\footnote{Et
    possiblement de raccourcis claviers personnels.} ;
\item sous \windows{} : \LKeyAltX{0}+\LKey{1}+\LKey{5}+\LKey{3}.
\end{itemize}
\end{dbremark}
  \lstMakeShortInlineâ„˘%

\section{NouveautĂ©s apparues sur le \ctan}
\label{sec:rubr-cons-aux}

Afin de pouvoir plus aisĂ©ment lister les nouveautĂ©s (packages et classes
\hologo{(La)TeX}, etc.) apparues sur le \ctan{}, la \letgutcls{} fournit le
nouvel environnement de liste \refEnv{ctannews}, similaire Ă&nbsp; l'environnement
\docAuxEnvironment{description}.
%
\begin{docEnvironment}[doclang/environment content=liste des nouveautĂ©s]{ctannews}{}
  Cet environnement permet de dresser la \meta{liste des nouveautĂ©s} apparues
  sur le \ctan{}.
\end{docEnvironment}
%
Chaque \meta{nouveautĂ©} est introduite au moyen de la commande \refCom{item}
suivante.
\begin{docCommands}[
  doc parameter = \oarg{nom},
  ]
  {
    { doc name = item },
    { doc name = item* },
  }
  %
  Cette commande affiche le \meta{nom} de la \meta{nouveautĂ©} comme ce serait le
  cas pour le \enquote{label} d'une liste de description, ce qui permet ensuite
  de dĂ©crire la \meta{nouveautĂ©} en question. Le \meta{nom} est en outre un lien
  hypertexte vers sa page sur le \ctan{}
  (\url{https://ctan.org/pkg/}\meta{nom}).

  La version Ă©toilĂ©e \refCom{item*} est dĂ©diĂ©e aux nouveautĂ©s Ĺ“uvres de
  contributeurs francophones et le logo de la francophonie, alors
  automatiquement situĂ© en regard dans la marge, les signale comme telles.
\end{docCommands}

\begin{ltx-code-external-result}[title addon=nouveautĂ©s,listing options app={deletekeywords={[6]{hologo,matapli}}}]{exemple-nouveautes}
\begin{ctannews}
\item[nl-interval] vise Ă&nbsp; simplifier le processus de
  reprĂ©sentation graphique des intervalles de l'axe rĂ©el.
\item*[matapli] classe \hologo{LaTeX} destinĂ©e Ă&nbsp; la composition
  de la revue Matapli (conĂ§ue par \person{Chupin, Maxime},
  secrĂ©taire adjoint de \gutenberg{}).
\end{ctannews}
\end{ltx-code-external-result}

\begin{docCommand}{francophony}{}
  Cette commande affiche le logo de la francophonie, ainsi : \francophony.
\end{docCommand}

\section{Fiches de lecture}
\label{sec:fiches-de-lecture}

Les fiches de lecture d'un livre sont crĂ©Ă©es au moyen de l'environnement
\refEnv{bookreview} suivant.

\begin{docEnvironment}[doclang/environment content=fiche de lecture]{bookreview}{\marg{caractĂ©ristiques}}
  Cet environnement permet de mettre en page une \meta{fiche de lecture}
  caractĂ©risĂ©e par les \meta{caractĂ©ristiques} suivantes qui sont, selon les
  cas :
  \begin{description}
  \item[obligatoires :]
    \begin{docKey}{title}{=\meta{titre}}{\valinitdef}
      Cette clĂ© permet de spĂ©cifier le \meta{titre} introductif de la fiche.
    \end{docKey}
    \begin{docKey}{reviewer}{=\meta{rapporteur}}{\valinitdef}
      Cette clĂ© permet de spĂ©cifier le \meta{rapporteur} de la fiche, Ă&nbsp; spĂ©cifier
      selon la syntaxe de la commande \refCom{author}.
    \end{docKey}
    \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}
      Cette clĂ© permet de spĂ©cifier le \meta{fichier} image de la couverture du
      document rapportĂ©.
    \end{docKey}
  \item[facultative :]
    \begin{docKey}{price}{=\meta{prix}}{\valinitdef}
      Cette clĂ© permet le cas Ă©chĂ©ant de spĂ©cifier le \meta{prix} du document rapportĂ©.
    \end{docKey}
  \end{description}
\end{docEnvironment}

\section{Acronymes}
\label{sec:acronymes}

Nombreux sont les articles de la \lettre{} susceptibles de contenir des
acronymes peut-ĂŞtre pas connus de tous. Aussi est-il opportun que, lors de leur
premiĂ¨re occurrence, ceux-ci soient explicitĂ©s.

Pour automatiser cela, la \letgutcls{} s'appuie sur le \package*{acro} ;
toutefois, pour Ă&nbsp; la fois simplifier la crĂ©ation desdits acronymes et Ă©tendre
(lĂ©gĂ¨rement) les fonctionnalitĂ©s offertes par \package{acro}, elle fournit la
commande dĂ©diĂ©e \refCom{letgutacro}.

\begin{docCommand}{letgutacro}{\oarg{options}\marg{COURT}\marg{long}\oarg{traduction
      franĂ§aise}}
  \index{acronyme}%
  Cette commande permet de crĂ©er un nouvel acronyme en spĂ©cifiant :
  \begin{itemize}
  \item sa forme courte \meta{COURT}, \emph{obligatoirement en grandes
      capitales} ;
  \item sa forme longue \meta{long}.
  \end{itemize}
  En outre, le 1\ier{} et 2\ieme{} arguments \emph{optionnels} permettent de,
  respectivement :
  \begin{itemize}
  \item passer Ă&nbsp; la commande \docAuxCommand{DeclareAcronym} (de crĂ©ation
    d'acronymes du \package*{acro} agissant en sous-main) des \meta{options} qui
    lui sont propres, permettant ainsi de surcharger les options par dĂ©faut
    passĂ©es Ă&nbsp; cette commande par \refCom{letgutacro} ;
  \item signaler que l'acronyme provient de l'anglais et d'en spĂ©cifier la
    \meta{traduction franĂ§aise} (Ă©ventuellement vide si celle-ci n'est pas
    pertinente).
  \end{itemize}

  L'acronyme ainsi crĂ©Ă© a pour identifiant \meta{court}, c'est-Ă&nbsp;-dire
  la version \emph{en bas de casse} de \meta{COURT}, et peut donc
  ĂŞ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
      forme complĂ¨te Ă&nbsp; sa 1\iere{} occurrence, sous sa forme courte Ă&nbsp; ses
      occurrences suivantes.} ;
  \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
  alors automatiquement une commande \docAuxCommand{\meta{court}}%
  \footnote{%
    Sauf si elle existe dĂ©jĂ&nbsp;, auquel cas la crĂ©ation d'une telle commande est
    silencieusement escamotĂ©e. Ainsi par exemple, l'acronyme
    %
    \lstinline+\\letgutacro[...]\{TIKZ\}\{...\}[...]+
    %
    fourni par \letgut{} (cf. \vpageref{liste-acronymes}) ne surcharge-t-il
    pas la commande \docAuxCommand{tikz} fournie notamment par le
    \package*{tikz}.%
  }
  %
  qui agit comme :
  \begin{itemize}
  \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
occurrences :
\begin{description}
\item[premiĂ¨re :] sous la forme \meta{\textsc{court}}\footnote{C'est-Ă&nbsp;-dire
    \meta{court} en petites capitales.} suivi d'une note de bas de
  page contenant \enquote{\meta{long}.} ;
\item[suivantes :] sous la forme \meta{\textsc{court}}.
\end{description}

En outre :
\begin{itemize}
\item cette commande peut ĂŞtre utilisĂ©e sans restriction en argument des
  commandes \refCom{title}, \refCom{subtitle}, \refCom{section},
  \refCom{subsection}, etc. et l'acronyme figure sous sa forme \meta{COURT} dans
  les \foreignloc{bookmarks} (signets) ;
\item un copiĂ© de \meta{\textsc{court}} colle \meta{COURT}.
\end{itemize}

\begin{dbwarning}{\refCom{letgutacro} : uniquement en prĂ©ambule}{}
  La dĂ©finition d'acronymes au moyen de \refCom{letgutacro} ne peut se faire
  qu'en prĂ©ambule.
\end{dbwarning}

Ainsi, avec les dĂ©finitions suivantes en prĂ©ambule :

\begin{ltx-code}[title addon=dĂ©finition d'acronymes,listing options app={deletekeywords={[3]{TeX,LaTeX,emph,n,no}}}]
% Acronyme franĂ§ais
\letgutacro{LD}{\LaTeX{} dĂ©pendant}

% Acronyme anglais avec traduction franĂ§aise
\letgutacro{TLMGR}{\TeX~Live Manager}[gestionnaire \TeX~Live]

% Acronyme anglais sans traduction franĂ§aise
\letgutacro{CD}{Compact Disc}[]

% Acronyme anglais avec surcharge :
% - `short=no-op` : l'acronyme est Â« no-op Â» (en bas de casse)
%   et le nom de la commande sous-jacente ne peut ĂŞtre \no-op
%   (tiret interdit)
% - `short-format=\upshape` : les petites capitales sont
%   dĂ©sactivĂ©es
\letgutacro[short=no-op,short-format=\upshape]
{NOOP}
{No Operation}
[instruction nulle]

% Acronyme en allemand :
\letgutacro[
  short=\emph{Ti\emph{k}Z},
  short-format=\em,
  foreign-babel=german,
  foreign-locale=allemand]
{TIKZ}
{Ti\emph{k}Z ist \emph{kein} Zeichenprogramm}
[Ti\emph{k}Z \emph{n'}est \emph{pas} un programme de dessin]
\end{ltx-code}

a-t-on :

\begin{ltx-code-result}[title addon=utilisation d'acronymes,listing options app={deletekeywords={cd},deletekeywords={[3]{cd,tikz,LaTeX,on}},deletekeywords={[6]{cd}},deletekeywords={itemize},morekeywords={[2]{itemize}}}]
On dispose dĂ©sormais pour \enquote{\LaTeX{} dĂ©pendant}
d'un acronyme qu'on peut utiliser par exemple
\begin{itemize}
\item ainsi : \ac{ld} ou \acs{ld} ;
\item ou bien ainsi : \ld{} ou \ld*{}.
\end{itemize}

On peut Ă©galement employer les acronymes :
\begin{itemize}
\item \cd{}, \cd{} ;
\item \tlmgr{}, \tlmgr{} ;
\item \noop{}, \noop{} ;
\item \ac{tikz}, \ac{tikz}. % Noter le non emploi de `\tikz'
\end{itemize}
\end{ltx-code-result}

Les noms des commandes sous-jacentes ne doivent contenir que des lettres, mais
celles-ci peuvent ĂŞtre accentuĂ©es. Ainsi, avec la dĂ©finition suivante en
prĂ©ambule :

\begin{ltx-code}[title addon=dĂ©finition d'acronyme avec lettres
  accentuĂ©es,drop lifted shadow]
\letgutacro{CPGĂ‰}{Classes PrĂ©paratoires aux Grandes Ă‰coles}
\end{ltx-code}

a-t-on :

\begin{ltx-code-result}[title addon=utilisation d'acronyme avec lettres accentuĂ©es,listing options app={deletekeywords={[3]{l}}}]
On peut Ă©galement employer l'acronyme \cpgĂ©{}, \cpgĂ©{}.
\end{ltx-code-result}

La \letgutcls{} fournit un \file*{letgut-acronyms.tex} dans lequel sont dĂ©finis
plusieurs acronymes anglais et franĂ§ais, directement utilisables. Ceux-ci sont
rĂ©pertoriĂ©s \vpageref{liste-acronymes}.

\section{SĂ©parateurs}
\label{sec:filets}

Il est parfois utile d'accentuer la sĂ©paration entre les articles de la
\lettre. Ceci peut se faire au moyen de la commande \refCom{separator} qui
insĂ¨re un filet horizontal.

\begin{docCommand}{separator}{}
  \index{sĂ©parateur}%
  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 Ă&nbsp; paraĂ®tre dans la
\lettre{}, la \letgutcls{} fournit l'environnement \refEnv{announcement}.

\begin{docEnvironment}[doclang/environment content=annonce,doc new and updated={2023-01-14}{2023-05-21}]{announcement}{\oarg{options}\marg{titre}}
  % \tcbdocmarginnote{\color{red}\faExclamationTriangle{} CompatibilitĂ© ascendante cassĂ©e le
  %   2023-05-21}
  Cet environnement est dĂ©diĂ© aux \meta{annonce}s. La spĂ©cification d'un
  \meta{titre} (pouvant toutefois ĂŞtre vide) est obligatoire. S'il n'est pas
  vide, il figure alors par dĂ©faut dans la table des matiĂ¨res et dans les
  signets au mĂŞme niveau que celui des titres d'articles.

  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 Ă&nbsp;, le cas Ă©chĂ©ant, modifier la
    mise en forme par dĂ©faut de l'annonce ;
  \item deux qui lui sont propres :
    \begin{docKey}[][doc new and updated={2023-05-21}{2023-11-08}]{toc title}{=\meta{titre alternatif}}{\valinitdef}
      Cette clĂ© permet de remplacer dans la table des matiĂ¨res et dans les
      signets le \meta{titre} par un \meta{titre alternatif}. Si cette option
      est utilisĂ©e avec un \meta{titre alternatif} vide, l'annonce ne figure ni
      dans la table des matiĂ¨res, ni dans les signets.
    \end{docKey}
    \begin{docKey}[][doc new={2023-05-21}]{color}{=\meta{couleur}}{\valinitdef[\docValue*{black}]}
      Cette clĂ© permet une \meta{couleur} d'ornement et de titre autre que celle
      appliquĂ©e par dĂ©faut.
    \end{docKey}
  \end{itemize}
\end{docEnvironment}

\begin{ltx-code-result}[title addon=annonces]
\begin{announcement}[toc title={Exemple d'annonce},color=red!35!black]{Convocation \acs{ag} ordinaire}
  Les adhĂ©rents de l'\assogut{} sont invitĂ©s Ă&nbsp; participer Ă&nbsp;
  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 Ă&nbsp; paraĂ®tre dans la
\lettre{}, la \letgutcls{} fournit l'environnement \refEnv{rebus}.

\begin{docEnvironment}[doclang/environment content=rĂ©bus,doc new={2023-01-14}]{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}[doc new={2023-01-14}]{solution}{}
    Cette commande dĂ©bute la solution d'un rĂ©bus Ă&nbsp; 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 Ă&nbsp;, 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}[][doc new={2023-01-14}]{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}[][doc new={2023-01-14}]{no solution}{}{\valinitdef[\docValue*{false}][\docValue*{true}]}
      Cette option est Ă&nbsp; 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 Ă&nbsp; 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}[doc new={2023-01-14}]{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 Ă&nbsp;, 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 Ă&nbsp; 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}

\begin{docCommand}{alertbox}{ \oarg{couleur}\marg{texte} }
  \index{alerte}%
  Cette commande insĂ¨re une boĂ®te d'alerte :
  \begin{itemize}
  \item optionnellement de \meta{couleur} de fond (Ă&nbsp; spĂ©cifier selon le modĂ¨le
    \enquote{\foreignloc{named}}) autre que celle par dĂ©faut\footnote{C'est-Ă&nbsp;-dire
      \colorbox{letgut_default_alert_box_color}{celle-ci}% , nommĂ©e
      % \docColor{letgut_default_alert_box_color} et Ă©gale
      % Ă&nbsp; \docValue*{\letgutalertboxdefaultcolor}
      .} ;
  \item contenant le \meta{texte} (qui peut contenir plusieurs paragraphes).
  \end{itemize}
\end{docCommand}

\begin{ltx-code-result}[title addon=boĂ®tes d'alertes]
\alertbox{%
  AdhĂ©rez, adhĂ©rez, il en restera toujours quelque chose !%
}
\alertbox[yellow]{%
  AdhĂ©rez, adhĂ©rez !

  Il en restera toujours quelque chose...%
}
\end{ltx-code-result}

\section{Fichier local de configuration}
\label{sec:fichier-local-de}

Chaque numĂ©ro de la \lettre{} nĂ©cessite certaines configurations locales :
configuration dĂ©diĂ©e au numĂ©ro en question, packages particuliers utilisĂ©s dans
les articles, configurations propres du \package*{listings}, etc. Afin de ne pas
encombrer le \file*{.tex} principal de la \lettre{}, un fichier de configuration
locale nommĂ©
%
\ExplSyntaxOn
\file{
  \tl_use:N \c__letgut_local_config_file_tl.tex
}~
\ExplSyntaxOff
%
est, si prĂ©sent dans le rĂ©pertoire courant, automatiquement inclus Ă&nbsp; la fin
du prĂ©ambule.

\title{Aspects de la 1\iere{} page}
\label{sec:mise-en-page}

La premiĂ¨re page de la \lettre{} comporte :
\begin{itemize}
\item une banniĂ¨re sous forme d'un trĂ¨s grand \enquote{L} en noir sur lequel
  figurent de la couleur de fond de la page, en gras, dans sa partie :
  \begin{itemize}
  \item verticale, \enquote{La} puis, chacune sur une ligne, les lettres du mot
    \enquote{Lettre} en grandes capitales ;
  \item horizontale, \enquote{\gut}.
  \end{itemize}
\item un trĂ¨s grand \enquote{g}, en filigrane et en gris clair.
\end{itemize}
La fonte de ces deux Ă©lĂ©ments est la principale utilisĂ©e (spĂ©cifiĂ©e au moyen de
\docAuxCommand{setmainfont}).

Pour ce faire, la classe charge le package maison \package{letgut-banner} qui
n'est pas dĂ©crit ici.

\title{Les dinosaures, leur Ă©cosystĂ¨me et \letgut}
\label{recours-docker}

Pour Ă&nbsp; la fois :
\begin{itemize}
\item disposer d'une version suffisamment rĂ©cente de \hologo{LuaLaTeX}
  pour la prĂ©sente \letgutcls{} (cf. \vref{wa-lualatex-recent}) ;
\item Ă©viter de perturber une installation existante de \hologo{(La)TeX} ;
\end{itemize}
on pourra recourir Ă&nbsp; \docker{}\footnote{Cerise sur le gĂ˘teau : un temps de
  compilation Ă©ventuellement rĂ©duit de faĂ§on significative. Ainsi, celui de la
  prĂ©sente documentation est-il sur la machine de \person{BitouzĂ©, Denis} d'un
  peu plus de \SI{13}{\s} avec \docker{} et de plus de \SI{30}{\s} par le biais
  habituel.} dont cette section est un mode d'emploi :
\begin{itemize}
\item express ;
\item axĂ© sur Linux, mais qui devant s'appliquer au moins en partie aux autres
  systĂ¨mes d'exploitation ;
\item axĂ© sur la \tl{}.
\end{itemize}

\begin{dbwarning}{Commande \software{sudo} peut-ĂŞtre nĂ©cessaire}{}
  Les commandes \docker*{} ci-aprĂ¨s ne sont pas prĂ©cĂ©dĂ©es de \software{sudo}
  mais, selon les systĂ¨mes d'exploitation, elles peuvent devoir l'ĂŞtre.
\end{dbwarning}

On commence par installer \docker*{} puis Ă&nbsp; lancer le service
\docker*\footnote{Pour Ubuntu, cf. par exemple
  \href{https://doc.ubuntu-fr.org/docker}{ce guide}.}.

Ensuite, par exemple depuis un dossier oĂą se trouve un \file*{mon-fichier.tex} (disons
Ă&nbsp; compiler avec \hologo{LuaLaTeX}), on lance la longue commande suivante
(\emph{qui doit ĂŞtre sur une seule ligne}\footnote{%
  Pour la copier d'un seul bloc, il devrait suffire de \emph{copier} (et non de
  \emph{cliquer sur}) l'icĂ´ne suivante
% \marginpar{%
  \BeginAccSupp{method=plain,ActualText={%
      docker run -i --rm --name latex -v "$PWD":/usr/src/app -w /usr/src/app registry.gitlab.com/islandoftex/images/texlive:latest-with-cache lualatex mon-fichier
    }%
  }%
  \faCopy[regular]%$$
  \EndAccSupp{}%
% }%
}) :

\terminal{docker run -i --rm --name latex -v "$PWD":/usr/src/app -w /usr/src/app registry.gitlab.com/islandoftex/images/texlive:latest-with-cache lualatex mon-fichier}{}%$

La toute premiĂ¨re fois, cela provoque le tĂ©lĂ©chargement de plusieurs fichiers,
dont celui assez lourd de l'image d'une version allĂ©gĂ©e de la \tl{}~2021
(dĂ©lestĂ©e des sources et des documentations) puis lance la compilation
demandĂ©e.

Pour simplifier les compilations ultĂ©rieures, on aura intĂ©rĂŞt Ă&nbsp; crĂ©er dans son
\file*{.bashrc} (ou \file{.zshrc}, etc.) un ou plusieurs alias de la forme :

\begin{tcblisting}{listing only,breakable,listing options={style=tcblatex,language=bash}}
alias docker-texlive='docker run -i --rm --name latex -v "$PWD":/usr/src/app -w /usr/src/app registry.gitlab.com/islandoftex/images/texlive:latest-with-cache'
alias docker-pdflatex='docker-texlive pdflatex'
alias docker-xelatex='docker-texlive xelatex'
alias docker-lualatex='docker-texlive lualatex'
alias docker-biber='docker-texlive biber'
alias docker-makeglossaries='docker-texlive makeglossaries'
alias docker-latexmk-pdf='docker-texlive latexmk -pdf'
alias docker-latexmk-xe='docker-texlive latexmk -pdfxe'
alias docker-latexmk-lua='docker-texlive latexmk -pdflua'
\end{tcblisting}

pour pouvoir compiler au moyen de seulement\footnote{En lanĂ§ant prĂ©alablement
  \lstinline[language=bash]+source ~/.bashrc+ (ou assimilĂ©) afin de pouvoir en
  bĂ©nĂ©ficier dans un terminal dĂ©jĂ&nbsp; ouvert.} :

\terminal{docker-latexmk-lua mon-fichier}{}

\title{Packages chargĂ©s par \letgut{}}
\label{sec:packages-charges-par}

La \letgutcls{} charge en sous-main un certain nombre de packages utiles, voire
nĂ©cessaires, Ă&nbsp; son codage. Elle en charge Ă©galement certains pas indispensables,
mais considĂ©rĂ©s comme \enquote{incontournables} pour que les auteurs de la
\lettre{} puissent (aisĂ©ment) composer un \enquote{joli} document. Nous en
dressons ci-aprĂ¨s la liste en les regroupant selon ces deux catĂ©gories.

\section{Packages utiles aux auteurs de la \lettre{}}
\label{sec:utiles-aux-auteurs}

\begin{ctannews}
\item[fontspec] fontes \otf{}.
\item[microtype] raffinements subliminaux vers la perfection typographique.
  \begin{description}
  \item[Options :] \docAuxKey*{stretch=30}, \docAuxKey*{shrink=25},
    \docAuxKey*{letterspace=150}.
  \end{description}
\item[graphicx] prise en charge amĂ©liorĂ©e des graphiques.
\item[array] extension des environnements \docAuxEnvironment*{array} et
  \docAuxEnvironment*{tabular}.
\item[fancyvrb] notamment pour permettre l'usage de commandes \enquote{verbatim}
  dans les notes de bas de page.
\item[booktabs] tableaux de qualitĂ©.
\item[csquotes] facilitĂ©s de citations, en ligne et hors-texte, sensibles au
  contexte.
\item[amsmath] nombreux outils utiles pour la composition mathĂ©matique.
\item[mathtools] Ă©tend les fonctionnalitĂ©s et corrige certaines dĂ©ficiences
  d'\package{amsmath} et de \hologo{LaTeX}.
  \begin{description}
  \item[Option :] \docAuxKey*{fleqn}.
  \end{description}
\item[siunitx] aide Ă&nbsp; la saisie et Ă&nbsp; l'affichage cohĂ©rent des nombres, unitĂ©s et
  quantitĂ©s.
  \begin{description}
  \item[Options :] \docAuxKey*{locale=FR}, \docAuxKey*{mode=text}.
  \end{description}
\item[hologo] collection de logos habituels (\hologo{LaTeX}, \hologo{LaTeX2e},
  etc.) avec support pour les signets.
\item[xcolor] accĂ¨s facile, indĂ©pendant du pilote, Ă&nbsp; plusieurs types de teintes,
  de nuances, de tons et de mĂ©langes de couleurs arbitraires.
  \begin{description}
  \item[Option :] \docAuxKey*{table}.
  \end{description}
\item[ninecolors] sĂ©lection de couleurs avec contraste \wcag{} appropriĂ©.
\item[tabularray] mise en page de tableaux et de matrices offrant une sĂ©paration
  complĂ¨te des contenus et styles. Ce package trĂ¨s rĂ©cent (sorti le 14 mai 2021)
  est utilisĂ© dans le code de la classe pour la crĂ©ation de boĂ®tes d'alertes
  \enquote{lĂ©gĂ¨res}, c.-Ă&nbsp;-d. ne nĂ©cessitant notamment pas le chargement
  (indirect) du package \ac{tikz} qui augmente significativement le temps de
  compilation ; mais il pourrait (devrait) ĂŞtre utile Ă©galement aux auteurs de
  la \lettre{}.
\item[babel] support multilingue.
  \begin{description}
  \item[Options :] \docAuxKey*{english}, \docAuxKey*{french} ;
  \item[Configuration] â„˘\renewcommand*\frenchtablename{Tableau}â„˘.
  \end{description}
\item[varioref] rĂ©fĂ©rences de pages intelligentes.
  \begin{description}
  \item[Options :] \docAuxKey*{nospace}, \docAuxKey*{french}.
  \end{description}
\item[eurosym] symbole et montants en \euro{}.
  \begin{description}
  \item[Option :] \docAuxKey*{right}.
  \end{description}
\item[listings] composition des listings informatiques.
  \begin{description}
  \item[Options :] \docAuxKey*{basicstyle=\ttfamily}, \docAuxKey*{frame=single},
    \docAuxKey*{belowskip=0pt}\footnote{Cette derniĂ¨re option du fait
      d'\href{https://github.com/FrankMittelbach/fmitex-parskip/issues/3}{un
        problĂ¨me actuel} impliquant les packages \package{parskip} et
      \package{listings}.}.
  \end{description}
\item[floatrow] nombreuses possibilitĂ©s de personnalisation de la disposition
  des flottants.
  \begin{description}
  \item[Options :]\leavevmode{}
    \begin{itemize}
    \item \docAuxKey*{objectset=justified} ;
    \item \docAuxKey*{style=__letgut_ruled}\footnote{Style propre Ă&nbsp; la classe.}
      et \docAuxKey*{margins=hangleft} pour les figures ;
    \item \docAuxKey*{capposition=top} pour les tableaux.
    \end{itemize}
  \end{description}
\item[biblatex] bibliographies sophistiquĂ©es.
  \begin{description}
  \item[Option :] \docAuxKey*{sorting=none}.
  \end{description}
\item[acro] crĂ©ation simple d'acronymes\footnote{Pour la gestion des acronymes,
    il Ă©tait initialement prĂ©vu de recourir au \package*{glossaries-extra} mais
    celui-ci augmente significativement le temps de compilation.}.
  \begin{description}
  \item[Options :]\leavevmode{}
    \begin{itemize}
    \item \docAuxKey*{first-style=footnote} ;
    \item \docAuxKey*{format/short=}â„˘\scshapeâ„˘ ;
    \item \docAuxKey*{format/foreign=}â„˘\emâ„˘ ;
    \item \docAuxKey*{foreign/display} ;
    \item \docAuxKey*{locale/display} ;
    \item \docAuxKey*{locale/format=}â„˘\upshapeâ„˘.
    \end{itemize}
  \end{description}
\item[hyperref] prise en charge Ă©tendue de l'hypertexte.
  \begin{description}
  \item[Options :]\leavevmode{}
    \begin{itemize}
    \item \docAuxKey*{draft} si l'option de classe \refKey{paper} est utilisĂ©e ;
    \item \docAuxKey*{colorlinks}, \docAuxKey*{allcolors={letgut_allcolors_links}}
      sinon.
    \end{itemize}
  \end{description}
\item[hypcap] ajustement des ancres des lĂ©gendes.
  \begin{description}
  \item[Option :] \docAuxKey*{all}.
  \end{description}
\item[cleveref] dĂ©termination automatique du format des rĂ©fĂ©rences en fonction
  du type de rĂ©fĂ©rence.
  \begin{description}
  \item[Option :] \docAuxKey*{french}.
  \end{description}
\item[lua-typo] mise en lumiĂ¨re, par un changement de couleur, des lignes
  typographiquement imparfaites avec \hologo{LuaLaTeX}.
  \begin{description}
  \item[Option :] \docAuxKey*{All}.
  \end{description}
\end{ctannews}

\section{Packages utiles au codage de la classe \letgut}
\label{sec:utiles-au-codage}

\begin{ctannews}
\item[l3keys2e] traitement \hologo{LaTeX2e} des options de classe en utilisant
  les clĂ©s \hologo{LaTeX3}.
\item[parskip] mise en page de paragraphes sĂ©parĂ©s par un blanc vertical au lieu
  (ou en plus) d'un retrait.
\item[fancyhdr] contrĂ´le Ă©tendu des en-tĂŞtes et des pieds de page.
\item[geometry] interface flexible et complĂ¨te pour les dimensions des
  documents.
  \begin{description}
  \item[Options :] \docAuxKey*{a4paper}, \docAuxKey*{asymmetric}.
  \end{description}
\item[etoc] tables des matiĂ¨res entiĂ¨rement personnalisables.
\item[enumitem] contrĂ´le de la mise en page de \docAuxEnvironment*{itemize},
  \docAuxEnvironment*{enumerate}, \docAuxEnvironment*{description} et permet de
  cloner les environnements standards et crĂ©er de nouveaux
  environnements. UtilisĂ© pour la crĂ©ation de l'environnement \refEnv{ctannews}.
\item[titlesec] personnalisation aisĂ©e des titres de sections, etc.
\item[placeins] contrĂ´le du placement des flottants permettant de s'assurer que
  ceux d'une section (donc d'un article dans le cas de la \lettre{})
  apparaissent avant la commande \docAuxCommand*{section} suivante.
  \begin{description}
  \item[Options :] \docAuxKey*{section}, \docAuxKey*{above}.
  \end{description}
\item[accsupp] notamment remplacement de texte lors des copiĂ©s-collĂ©s, utilisĂ©
  en particulier pour que les acronymes, composĂ©s en petites capitales par
  \letgut{}, une fois copiĂ©s, soient collĂ©s en grandes capitales.
\item[letgut-banner] banniĂ¨re de la 1\iere{} page de la \lettre{}.
\end{ctannews}

\section{Exemple de dĂ©claration de dialecte du langage \hologo{TeX}}
\label{sec:exemple-de-decl}

Nous fournissons ci-dessous un exemple de dĂ©claration de dialecte (ici le
package \hologo{(La)TeX} \package{graphicx}) du langage \hologo{TeX}
(cf. section~\enquote{\nameref{sec:coloration}}, \vpageref{sec:coloration}).

\begin{ltx-code}[listing options app={deletekeywords={[3]{
  ,draft
  ,final
  ,setpagesize
  ,dvips
  ,dvipdfm
  ,dvipdfmx
  ,xetex
  ,pdftex
  ,dvipsone
  ,dviwindo
  ,textures
  ,vtex
  ,alt
  ,width
  ,height
  ,totalheight
  ,scale
  ,clip
  ,draft
  ,type
  ,command
  ,page
}}},
listing options app={deletekeywords={[4]{
  ,draft
  ,final
  ,dvips
  ,dvipdfm
  ,dvipdfmx
  ,xetex
  ,pdftex
  ,luatex
  ,vtex
  ,scale
  ,true
  ,false
}}}]
\lst@definelanguage[graphicx]{TeX}[LaTeX]{TeX}{%
  % Control sequences names
  moretexcs={%
    DeclareGraphicsExtensions,DeclareGraphicsRule,graphicspath,%
    includegraphics*,includegraphics,reflectbox,resizebox*,%
    resizebox,rotatebox,scalebox,%
  },%
  % Keywords of class 1 : keywords that contain other characters
  % (since of the same class as the ones specified as
  % 'otherkeywords')
  morekeywords={%
  },%
  % Keywords of class 2 : environments names
  morekeywords=[2]{%
  },%
  % Keywords of class 3 : mandatory arguments (not environments)
  % &amp; optional arguments which are keys (in key=value)
  morekeywords=[3]{%
    draft,final,hiresbb,demo,setpagesize,nosetpagesize,dvips,xdvi,%
    dvipdf,dvipdfm,dvipdfmx,xetex,pdftex,luatex,dvisvgm,dvipsone,%
    dviwindo,emtex,dviwin,oztex,textures,pctexps,pctexwin,pctexhp,%
    pctex32,truetex,tcidvi,vtex,debugshow,hiderotate,hidescale,%
    alt,%
    %
    bb,bbllx,bblly,bburx,bbury,natwidth,natheight,hiresbb,pagebox,%
    viewport,trim,angle,origin,width,height,totalheight,%
    keepaspectratio,scale,clip,type,ext,read,command,quiet,page,%
    interpolate,decodearray,origin,x,y,units,%
  },%
  % Keywords of class 4 : values of keys (in key=value)
  morekeywords=[4]{%
    mediabox,cropbox,bleedbox,trimbox,artbox,true,false,%
  },%
  % Keywords of class 5 : arguments specifications (after ":"
  % in expl3 syntax)
  morekeywords=[5]{%
  },%
  % Keywords of class 6 : current package name (and possibly
  % derived packages)
  morekeywords=[6]{%
    graphicx,%
  },%
  % otherkeywords={},%
  alsoletter={23},%
  % alsodigit={},%
  sensitive,%
}[keywords,tex,comments]%
\end{ltx-code}

\printacronyms[
, heading=title
% , template=longtable
, preamble={\label{liste-acronymes}}
, display=all
, exclude=thisdocument
, name={Liste des acronymes prĂ©dĂ©finis par \letgut}
]

\printbibliography[heading=title]

% \listoffigures
% \listoftables
\tcblistof[\title]{dbwarninglist}{Table des avertissements}%
% \tcblistof[\title]{dbremarklist}{Table des remarques}%
%
\phantomsection
\indexprologue{%
  Afin de diffĂ©rencier leurs natures, les entrĂ©es de cet index sont affichĂ©es
  en couleurs (variĂ©es) lorsqu'elles correspondent Ă&nbsp; des :
  \begin{itemize}
  \item commandes ;
  \item environnements ;
  \item clĂ©s ;
  \item valeurs de clĂ©.
  \end{itemize}
}%
% \renewcommand{\indexname}{Index des commandes}
% \printindex[\jobname-commands]
% %
% \phantomsection
% \indexprologue{%
%   Dans cet index, un numĂ©ro de page :
%   \begin{description}
%   \item[en gras] indique une page contenant une information importante sur
%     l'entrĂ©e correspondante, par exemple sa dĂ©finition ;
%   \item[en italique] indique une page contenant un exemple qui illustre
%     l'entrĂ©e correspondante.
%   \end{description}
% }%
% \renewcommand{\indexname}{Index des concepts}
\printindex
\end{document}

%%% Local Variables:
%%% mode: latex
%%% TeX-engine: luatex
%%% TeX-master: t
%%% End:
</pre></body></html>