summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/nwejm/french/documentation/nwejm-fr.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/nwejm/french/documentation/nwejm-fr.tex')
-rw-r--r--Master/texmf-dist/doc/latex/nwejm/french/documentation/nwejm-fr.tex447
1 files changed, 330 insertions, 117 deletions
diff --git a/Master/texmf-dist/doc/latex/nwejm/french/documentation/nwejm-fr.tex b/Master/texmf-dist/doc/latex/nwejm/french/documentation/nwejm-fr.tex
index a004e1facf5..1aa617a01bd 100644
--- a/Master/texmf-dist/doc/latex/nwejm/french/documentation/nwejm-fr.tex
+++ b/Master/texmf-dist/doc/latex/nwejm/french/documentation/nwejm-fr.tex
@@ -1,12 +1,18 @@
\documentclass[french,nolocaltoc]{nwejmart}
%
-\DTMsavedate{release-date}{2018-04-07}
-\newcommand{\releaseversion}{0.98e}
+\DTMsavedate{release-date}{2019-03-18}
+\newcommand{\releaseversion}{0.98f}
%
\usepackage{denisbdoc}
\usepackage{tabulary}
\usepackage[firstpage]{draftwatermark}
%
+\makeatletter
+\patchcmd{\@mn@margintest}{\@tempswafalse}{\@tempswatrue}{}{}
+\patchcmd{\@mn@margintest}{\@tempswafalse}{\@tempswatrue}{}{}
+\reversemarginpar
+\makeatother
+%
\indexsetup{level=\section*,toclevel=section,noclearpage}
\makeindex[columns=2]
\tcbset{index format=off}
@@ -33,7 +39,14 @@
\newacronym{tdm}{tdm}{table des matières}
%
\newtheorem{article}
-\newtheorem[title=Fait,style=definition]{fact}
+\newtheorem[style=definition]{fait}
+\newtheorem[title=expérience]{experience}
+\newtheorem[title-plural=anneaux]{anneau}
+\newtheorem[title=idéal,title-plural=idéaux]{ideal}
+%
+\newenumeration{conventions}
+\newenumeration[singular=cas]{cas}
+\newenumeration[singular=règle,plural=règles]{regles}
%
\DeclareMathOperator{\cat}{Cat}
\newcommand{\mybinop}{\mathbin{*}}
@@ -58,9 +71,9 @@ affiliation={%
\etocarticlestylenomarks
\localtableofcontents
%
-\DeclareFixedFootnote{\conseilslatex}{Et donne de façon subliminale quelques conseils
- \LaTeX{}. On consultera \autocite{Ensenbach} pour un panorama plus complet des
- commandes et extensions obsolètes (et autres erreurs).}
+\DeclareFixedFootnote{\conseilslatex}{Et donne de façon subliminale quelques
+ conseils \LaTeX{}. On consultera \autocite{Ensenbach} pour un panorama plus
+ complet des commandes et extensions obsolètes (et autres erreurs).}
\DeclareFixedFootnote{\suitecompilations}{Pour automatiser ces compilations, on
pourra recourir au \enquote{compilateur} \program{latexmk}, fourni par toute
distribution \TeX{} moderne, en s'aidant du fichier de configuration
@@ -158,10 +171,10 @@ options de classe suivantes.
\begin{docKey}{english}{}{pas de valeur, option par défaut}
Cette option définit l'anglais comme langue de l'article.
\end{docKey}
-\begin{docKey}{french}{}{}
+\begin{docKey}{french}{}{pas de valeur}
Cette option définit le français comme langue de l'article.
\end{docKey}
-\begin{docKey}{german}{}{}
+\begin{docKey}{german}{}{pas de valeur}
Cette option définit l'allemand comme langue de l'article. Elle a pour alias
\docAuxKey{ngerman}.
\begin{dbremark}{Option de \package*{babel} sous-jacente à l'option
@@ -169,9 +182,9 @@ options de classe suivantes.
L'option de langue \refKey{german} de la \nwejmauthorcl{} appelle en
sous-main l'option \docAuxKey*{ngerman} du \Package*{babel}.
\end{dbremark}
- \begin{docKey}{dutch}{}{}
- Cette option définit le néerlandais comme langue de l'article.
\end{docKey}
+\begin{docKey}{dutch}{}{pas de valeur}
+ Cette option définit le néerlandais comme langue de l'article.
\end{docKey}
\begin{dbremark}{Langue par défaut de l'article}{}
@@ -273,7 +286,7 @@ finale.
\end{itemize}
\end{docCommand}
-\begin{bodycode}
+\begin{bodycode}[listing options={deletekeywords={[2]title}}]
\title[Le Traité du calcul des probabilités]{Le Traité du calcul des
probabilités et de ses applications}
\subtitle[Étendue et limites d'un projet borélien]{Étendue et limites
@@ -321,8 +334,7 @@ La commande \refCom{author} admet un argument optionnel permettant de spécifier
la ou les affiliations de l'auteur au moyen d'une des clés \refKey{affiliation}
et \refKey{affiliationtagged} suivantes.
-\begin{docKey}{affiliation}{={\oarg{tag}\marg{affiliation}}}{pas de valeur par défaut,
- initialement vide}
+\begin{docKey}{affiliation}{={\oarg{tag}\marg{affiliation}}}{pas de valeur par défaut,\\initialement vide}
Cette clé permet de définir une (unique) \meta{affiliation}. Pour un auteur
ayant plusieurs affiliations, cette clé est utilisée autant de fois que
nécessaire.
@@ -396,10 +408,10 @@ et \refKey{affiliationtagged} suivantes.
forme d'une liste séparée par des virgules.
La métadonnée \enquote{Mots-clés} du \File{PDF} produit contient
- automatiquement les \meta{mots clés} spécifiés. % Dans le cas où ceux-ci
- % contiennent des caractères non admis en métadonnées des fichiers \file{PDF}
- % (notamment des mathématiques), on spécifiera en argument optionnel une
- % \meta{variante des mots clés} ne contenant que des caractères autorisés.
+ automatiquement les \meta{mots clés} spécifiés. Dans le cas où ceux-ci
+ contiennent des caractères (notamment des mathématiques) non admis en
+ métadonnées des fichiers \file{PDF} , on spécifiera en argument optionnel une
+ \meta{variante des mots clés} ne contenant que des caractères autorisés.
\end{docCommand}
\begin{bodycode}[listing options={deletekeywords={[5]keywords}}]
@@ -434,7 +446,7 @@ Le titre proprement dit de l'article, regroupant tous les éléments saisis à l
\end{itemize}
\end{docCommand}
-\begin{bodycode}[listing options={deletekeywords={[5]keywords}}]
+\begin{bodycode}[listing options={deletekeywords={[2]title,article},deletekeywords={[5]keywords}}]
\title[Le Traité du calcul des probabilités]{Le Traité du calcul des
probabilités et de ses applications}
\subtitle[Étendue et limites d'un projet borélien]{Étendue et limites
@@ -469,7 +481,7 @@ Le titre proprement dit de l'article, regroupant tous les éléments saisis à l
un article.
\end{docCommand}
-\begin{bodycode}
+\begin{bodycode}[listing options={deletekeywords={[2]first}}]
\acknowledgments{%
The first author's research was supported by the Hungarian National
Science Foundation Grants K81658 and K104183. Research conducted
@@ -539,20 +551,23 @@ cf. par exemple][en français]{Bitouze}.
\item Construire, dans un \meta{fichier bibliographique}\footnote{De tels
fichiers sont d'extension \file{.bib}.}, une base bibliographique.
- Nous conseillons pour ce faire de recourir à un logiciel dédié, par exemple
- \href{http://jabref.sourceforge.net/}{\program{JabRef}} à configurer en se
- rendant dans le menu \menuentry{Options>Preferences} et, dans l'onglet :
- \begin{itemize}
- \item \menuentry{Général}\footnote{On pourra en profiter pour changer la langue de
- l'interface dans la liste déroulante \menuentry{Language}.}, en choisissant
- \menuentry{UTF8} dans la liste déroulante \menuentry{Default encoding} ;
- \item \menuentry{Advanced}, en cochant l'option \menuentry{BibLaTeX mode} ;
- \end{itemize}
+ Pour ce faire, nous recommandons de recourir à un logiciel dédié, par exemple
+ \href{http://jabref.sourceforge.net/}{\program{JabRef}} que nous conseillons
+ de configurer en visitant le menu
+ \menuentry{Options>Preferences>General} et en choisissant dans les listes
+ déroulantes :
+ \begin{description}
+ \item[\menuentry{Default encoding} :] \menuentry{UTF8} ;
+ \item[\menuentry{Default bibliography mode} :] \menuentry{biblatex}.
+ \end{description}
+ On pourra en profiter pour changer la langue de l'interface dans la liste
+ déroulante \menuentry{Language}.
On n'oubliera pas de donner à chaque référence bibliographique une \meta{clé}
permettant de l'identifier de façon unique dans la base
- bibliographique\footnote{Sous \program{JabRef}, on pourra se faire aider pour
- cela par l'icône en forme de \enquote{baguette magique} ou de clé.}.
+ bibliographique\footnote{Sous \program{JabRef}, l'icône en forme de
+ \enquote{baguette magique} ou de clé aide à générer ladite
+ \meta{clé}.}.
\item Dans le fichier source \file{.tex} :
\begin{enumerate}
\item \emph{En préambule}, utiliser la commande \docAuxCommand{addbibresource}
@@ -565,11 +580,11 @@ cf. par exemple][en français]{Bitouze}.
\docAuxCommand{cite}.}\footnote{La référence est alors détaillée en note
de bas de page.} ou, éventuellement, \docAuxCommand{textcite}\footnote{La
référence est alors affichée au fil du texte, mais avec moins de détails.}
- du \Package*{biblatex} pour citer les références bibliographiques (pourvue
- d'une \meta{clé}) :
+ du \Package*{biblatex} pour citer des références bibliographiques (chacune
+ pourvue d'une \meta{clé}) :
\begin{bodycode}[listing options={alsolanguage={[biblatex]TeX}}]
-\autocite{"\meta{clé}"}
-\textcite{"\meta{clé}"}
+...\autocite{"\meta{clé1}"}... \textcite{"\meta{clé2}"} ...
+...\autocite{"\meta{clé3,clé4}"}... \textcite{"\meta{clé5,clé6}"} ...
\end{bodycode}
\item À la fin du document, faire figurer la liste des références
bibliographiques au moyen de la commande \refCom{printbibliography}.
@@ -587,7 +602,7 @@ cf. par exemple][en français]{Bitouze}.
Par exemple, si le \File{.bib} contient :
-\begin{bodycode}[listing only,listing options={alsolanguage={[biblatex]TeX},deletekeywords={[2]series}}]
+\begin{bodycode}[listing only,listing options={alsolanguage={[biblatex]TeX},deletekeywords={[2]series,geometry}}]
@Book{ har,
author = {Hartshorne, Robin},
title = {Algebraic geometry},
@@ -621,8 +636,8 @@ alors, le source \file{.tex} suivant :
\begin{bodycode}[listing only,listing options={alsolanguage={[biblatex]TeX},deletekeywords={[1]theorem},deletekeywords={[2]first,and,see,theorem},deletekeywords={[3]theorem}}]
The first assertion is a direct consequence of the Riemann-Roch
formula for threefolds\autocite[See e.g.][437]{har} and
-Kawamata-Viehweg vanishing\autocite[theorem~4.3.1]{laz1}. For the
-second assertion, see \textcite[theorem~(0.4)]{shin}.
+Kawamata-Viehweg vanishing\autocite[Theorem~4.3.1]{laz1}. For the
+second assertion, see \textcite[Theorem~(0.4)]{shin}.
%
\printbibliography
\end{bodycode}
@@ -637,14 +652,19 @@ donne le texte figurant dans l'encadré intitulé \enquote{Exemple de
}
\makeatother
\ExplSyntaxOff
+\renewcommand{\thempfootnote}{\arabic{mpfootnote}}
+%
\begin{bodycode}[text only,float,title={Exemple de bibliographie},label=biblio]
+\StandardFootnotes
The first assertion is a direct consequence of the Riemann-Roch formula for
threefolds\autocite[See e.g.][437]{har} and Kawamata-Viehweg
-vanishing\autocite[theorem~4.3.1]{laz1}. For the second assertion, see
-\textcite[theorem~(0.4)]{shin}.
+vanishing\autocite[Theorem~4.3.1]{laz1}. For the second assertion, see
+\textcite[Theorem~(0.4)]{shin}.
%
\printbibliography[heading=origsectionnotintoc,category=examples]
\end{bodycode}
+%
+\renewcommand{\thempfootnote}{\alph{mpfootnote}}
\section{Commandes propres aux mathématiques}
\label{sec:comm-propr-aux}
@@ -750,7 +770,7 @@ La \nwejmauthorcl{} :
\subsubsection{Ensembles définis}
-\begin{docCommand}{set}{\marg{définition}\oarg{caractérisation}}
+\begin{docCommand}[doc updated=2019-03-18]{set}{\marg{définition}\oarg{caractérisation}}
Cette commande affiche l'ensemble défini par \meta{définition}, avec une
éventuelle \meta{caractérisation}\footnote{Partie suivant \enquote{tels
que}.}.
@@ -935,7 +955,7 @@ de délimiteurs au moyen de la commande \refCom{NewPairedDelimiter}.
right=\rfloor,
subscript=\text{eff}
}
-\begin{preamblecode}
+\begin{preamblecode}[listing options={morekeywords={[2]left,right,subscript}}]
\NewPairedDelimiter{\floor}{
left=\lfloor,
right=\rfloor,
@@ -1011,8 +1031,7 @@ usuelle \refCom{DeclareMathOperator}.
\DeclareMathOperator{\cat}{Cat}
\end{preamblecode}
\begin{bodycode}[listing and text,listing options={deletekeywords={example},deletekeywords={[4]all}}]
-A standard example is $\cat$, the $2$-category of all (small)
-categories.
+A standard example is $\cat$, the $2$-category of all (small) ideals.
\end{bodycode}
\subsubsection{(Usage avancé) Précautions en cas d'opérations binaires non
@@ -1047,7 +1066,7 @@ le déclarer au moyen de la commande \refCom{BinaryOperators}.
\subsection{Divers}
\begin{dbremark}{Commandes propres au français (bis)}{}
- Les commandes suivantes ne sont définies redéfinies que pour les articles en
+ Les commandes suivantes ne sont redéfinies que pour les articles en
français.
\end{dbremark}
@@ -1064,7 +1083,7 @@ Pour faciliter la composition des théorèmes et objets analogues, la
\nwejmauthorcl{} fournit des environnements prêts à l'emploi et permet d'en
créer de nouveaux si besoin est (cf. commande \refCom{newtheorem}).
-\subsubsection{Environnements de type \enquote{théorème} prédéfinis}
+\subsubsection{Environnements prédéfinis}
\label{sec:envir-de-type}
La \vref{env-theorems} liste les théorèmes et objets analogues prédéfinis par la
@@ -1107,13 +1126,10 @@ La \vref{env-theorems} liste les théorèmes et objets analogues prédéfinis pa
\end{theorem}
\begin{definition}[congruence modulo $n$]
Soit $n$ un entier supérieur ou égal à $2$. Deux entiers $a$ et $b$
- sont dits congruents modulo $n$ si $a - b \in n\bbZ$
+ sont dits congruents modulo $n$ si $a - b \in n\bbZ$.
\end{definition}
\begin{remark*}
- Une des plus belles relations mathématiques est :
- \[
- e^{i\pi}+1=0.
- \]
+ Une des plus belles relations mathématiques est $\E[i\pi]+1=0$.
\end{remark*}
\begin{proof}
Tout ce qui est rare est cher. Or un cheval bon marché est rare.
@@ -1141,7 +1157,7 @@ Style & Titre récurrent & Contenu
\label{env-theorems-styles}
\end{table}
-\subsubsection{Environnements de type \enquote{théorème} personnels}
+\subsubsection{Environnements définis par l'utilisateur}
\label{sec:envir-de-type-1}
Si les environnements de \enquote{théorème} fournis par la classe ne suffisent
@@ -1159,65 +1175,138 @@ pas, la commande \refCom{newtheorem} permet d'en créer de nouveaux.
Cette commande crée également l'environnement étoilé \meta{nom}|*| produisant
des occurrences \emph{non} numérotées de ce \enquote{théorème}.
- Si les valeurs par défaut du titre récurrent (\meta{Nom}) ou du style
- (\docValue{theorem}) ne conviennent pas, il suffit spécifier celles souhaitées
- en \meta{option(s)} au moyen des clés \refKey{title} et \refKey{style}
- suivantes.
- \begin{docKey}{title}{={\meta{titre récurrent}}}{pas de
- valeur par défaut, initialement vide}
- Cette clé permet de spécifier un \meta{titre récurrent} différent de
- \meta{Nom}, valable quelle que soit la langue de l'article.
- \end{docKey}
+\begin{preamblecode}[listing options={deletekeywords={[2]article}}]
+\newtheorem{article}
+\end{preamblecode}
+\begin{bodycode}[listing and text,listing options={deletekeywords={[2]article,label}}]
+\begin{article*}[dit premier]
+Les hommes naissent et demeurent libres et égaux en droits [...]
+\end{article*}
+\begin{article}[dit premier]\label{premier}
+Les hommes naissent et demeurent libres et égaux en droits [...]
+\end{article}
+L'\vref{premier} est le plus célèbre.
+\end{bodycode}
+
+ Si la valeur par défaut du style (\docValue{theorem}) ne convient pas, il
+ suffit de spécifier en \meta{option(s)} celle souhaitée au moyen de la clé
+ \refKey{style} suivante.
\begin{docKey}{style}{=\docValue{theorem}\textbar\docValue{definition}\textbar\docValue{proof}}{pas
de valeur par défaut,\\initialement \docValue{theorem}}
Cette clé permet de spécifier le style du \enquote{théorème} à créer, au
moyen des valeurs \docValue{theorem}, \docValue{definition} et
\docValue{proof}.
\end{docKey}
+\begin{preamblecode}
+\newtheorem[style=definition]{fait}
+\end{preamblecode}
+\begin{bodycode}[listing and text,listing options={deletekeywords={[2]label}}]
+\begin{fait}\label{majeure}
+Tout ce qui est rare est cher.
+\end{fait}
+\begin{fait}\label{mineure}
+Un cheval bon marché est rare.
+\end{fait}
+En vertu des \cref{mineure,majeure}, un cheval bon marché est
+cher.
+\end{bodycode}
- Si besoin est, il est même possible de spécifier des titres récurrents
- différents selon la langue utilisée au moyen des clés suivantes :
- \begin{docKey}{title/english}{={\meta{titre récurrent en anglais}}}{pas de
- valeur par défaut,\\initialement vide}
- \end{docKey}
- \begin{docKey}{title/french}{={\meta{titre récurrent en français}}}{pas de
- valeur par défaut,\\initialement vide}
- \end{docKey}
- \begin{docKey}{title/german}{={\meta{titre récurrent en allemand}}}{pas de
- valeur par défaut,\\initialement vide}
+ Si la valeur par défaut du titre récurrent (\meta{Nom}) ne convient pas, il
+ suffit de spécifier en \meta{option(s)} celle souhaitée au moyen de la clé
+ \refKey{title} suivante.
+ \begin{docKey}{title}{={\meta{titre récurrent}}}{pas de
+ valeur par défaut, initialement vide}
+ Cette clé permet de spécifier un \meta{titre récurrent} différent de
+ \meta{Nom}, valable quelle que soit la langue de l'article.
\end{docKey}
- \begin{docKey}{title/dutch}{={\meta{titre récurrent en néerlandais}}}{pas de
- valeur par défaut,\\initialement vide}
- Ces clés permettent de spécifier un \meta{titre récurrent} différent
- de \meta{Nom} pour la langue correspondante.
+\begin{preamblecode}
+\newtheorem[title=expérience]{experience}
+\end{preamblecode}
+\begin{bodycode}[listing and text,listing options={deletekeywords={[2]label}}]
+\begin{experience}\label{un}
+On lance un dé à 6 faces [...]
+\end{experience}
+\begin{experience}\label{deux}
+On lance deux dés à 6 faces [...]
+\end{experience}
+Les \vref{un,deux} mettent en évidence [...]
+\end{bodycode}
+
+ On remarque que, en cas de références croisées au moyen de la commande
+ recommandée\footnote{Cf. \vref{sec-references-croisees}} \refCom{vref} (ou
+ \refCom{cref}), le titre récurrent du ou des \enquote{théorèmes} référencés
+ est automatiquement ajouté à la référence et ce, éventuellement sous sa forme
+ plurielle. Par défaut, cette dernière est obtenue en ajoutant un \enquote{s}
+ final à \meta{nom} ou au \meta{titre récurrent} fixée par l'option
+ \refKey{title}. Si cette forme plurielle doit être construite différemment, il
+ convient de le spécifier en \meta{option(s)} au moyen de la clé
+ \refKey{title-plural} suivante.
+ \begin{docKey}{title-plural}{={\meta{forme plurielle du titre récurrent}}}{pas de
+ valeur\\par défaut, initialement vide}
+ Cette clé permet de spécifier la forme plurielle du titre récurrent.
\end{docKey}
+\begin{preamblecode}
+\newtheorem[title-plural=anneaux]{anneau}
+\end{preamblecode}
+\begin{bodycode}[listing and text,listing options={deletekeywords={[2]label}}]
+\begin{anneau}\label{anneau}
+Considérons un anneau : [...]
+\end{anneau}
+\begin{anneau}\label{anneau-bis}
+Considérons un autre anneau : [...]
+\end{anneau}
+Les \vref{anneau,anneau-bis} admettent [...]
+\end{bodycode}
\begin{preamblecode}
-\newtheorem{article}
-\newtheorem[title/french=Fait,style=definition]{fact}
+\newtheorem[title=idéal,title-plural=idéaux]{ideal}
\end{preamblecode}
-\begin{bodycode}[listing and text]
-\begin{article}[dit premier]
-Les hommes naissent et demeurent libres et égaux en droits [...]
-\end{article}
-\begin{fact*}
-Tout ce qui est rare est cher.
-\end{fact*}
-\begin{fact}
-Un cheval bon marché est rare.
-\end{fact}
+\begin{bodycode}[listing and text,listing options={deletekeywords={[2]label}}]
+\begin{ideal}\label{ideal}
+Considérons un idéal : [...]
+\end{ideal}
+\begin{ideal}\label{ideal-bis}
+Considérons un autre idéal : [...]
+\end{ideal}
+Les \vref{ideal,ideal-bis} admettent [...]
\end{bodycode}
+
+ % Si besoin est, il est même possible de spécifier des titres récurrents
+ % différents selon la langue utilisée au moyen des clés suivantes :
+ % \begin{docKey}{title/english}{={\meta{titre récurrent en anglais}}}{pas de
+ % valeur par défaut,\\initialement vide}
+ % \end{docKey}
+ % \begin{docKey}{title/french}{={\meta{titre récurrent en français}}}{pas de
+ % valeur par défaut,\\initialement vide}
+ % \end{docKey}
+ % \begin{docKey}{title/german}{={\meta{titre récurrent en allemand}}}{pas de
+ % valeur par défaut,\\initialement vide}
+ % \end{docKey}
+ % \begin{docKey}{title/dutch}{={\meta{titre récurrent en néerlandais}}}{pas de
+ % valeur par défaut,\\initialement vide}
+ % Ces clés permettent de spécifier un \meta{titre récurrent} différent
+ % de \meta{Nom} pour la langue correspondante.
+ % \end{docKey}
\end{docCommand}
-\subsection{Listes d'hypothèses ou d'assertions}
+\subsection{Énumérations}
\label{sec:list-dhyp-ou}
-Dans les articles en mathématiques, il est fréquent que les auteurs aient
-à lister des assertions ou des hypothèses et à s'y référer. Pour ce faire, la
-\nwejmauthorcl{} fournit deux environnements qui s'emploient comme l'habituel
-environnement \docAuxEnvironment{enumerate} de listes ordonnées (numérotées) :
-\refEnv{assertions} et \refEnv{hypotheses}, dans lesquels chaque assertion ou
-hypothèse est introduite par la commande \docAuxCommand{item}.
+Pour faciliter la composition des énumérations (d'hypothèses, d'assertions, de
+conditions, etc.), la \nwejmauthorcl{} fournit des environnements prêts
+à l'emploi et permet d'en créer de nouveaux si besoin est (cf. commande
+\refCom{newenumeration}).
+
+\subsubsection{Énumérations prédéfinies}
+\label{sec:predefinies-:-listes}
+
+Dans les articles en mathématiques, il est fréquent d'énumérer des assertions,
+hypothèses ou conditions et de s'y référer. Pour ce faire, la \nwejmauthorcl{}
+fournit trois environnements qui s'emploient comme l'habituel environnement
+\docAuxEnvironment{enumerate} de listes ordonnées (numérotées) :
+\refEnv{assertions}, \refEnv{hypotheses} et \refEnv{conditions}, dans lesquels
+chaque assertion, hypothèse ou condition est introduite par la commande
+\docAuxCommand{item}.
\begin{docEnvironment}[doclang/environment content=assertions]{assertions}{}
Cet environnement compose une liste d'assertions.
@@ -1225,10 +1314,13 @@ hypothèse est introduite par la commande \docAuxCommand{item}.
\begin{docEnvironment}[doclang/environment content=hypothèses]{hypotheses}{}
Cet environnement compose une liste d'hypothèses.
\end{docEnvironment}
+\begin{docEnvironment}[doc new=2019-03-18,doclang/environment content=conditions]{conditions}{}
+ Cet environnement compose une liste de conditions.
+\end{docEnvironment}
-\begin{bodycode}[listing and text]
+\begin{bodycode}[listing and text,listing options={deletekeywords={[2]label}}]
\begin{axiom}\label{mon-axiome}
- Chacune des assertions suivantes est admise.
+ Chaque assertion suivante est admise.
\begin{assertions}
\item\label{rare-cher} Tout ce qui est rare est cher.
\item\label{cheval} Un cheval bon marché est rare.
@@ -1238,6 +1330,103 @@ En vertu des \vref{rare-cher,cheval} de l'\vref{mon-axiome},
un cheval bon marché est cher.
\end{bodycode}
+\subsubsection{Énumérations définies par l'utilisateur}
+
+Si les énumérations fournies par la classe ne suffisent pas, il est possible
+d'en créer de nouvelles au moyen de la commande \refCom{newenumeration}.
+
+\begin{docCommand}[doc new=2019-03-18]{newenumeration}{\oarg{option(s)}\marg{nom}}
+ Cette commande crée un nouvel environnement \LaTeX{}, \meta{nom}, qui
+ s'emploie comme l'habituel environnement \docAuxEnvironment{enumerate} de
+ listes ordonnées (numérotées) dans lequel chaque item à énumérer
+ est introduit par la commande \docAuxCommand{item}.
+
+\begin{preamblecode}
+\newenumeration{conventions}
+\end{preamblecode}
+\begin{bodycode}[listing and text]
+\begin{conventions}
+\item Le cheval est bon marché.
+\item Le cheval est cher.
+\end{conventions}
+\end{bodycode}
+
+ On constate que chaque item énuméré est introduit par un label par défaut
+ constitué de l'initiale du \meta{nom} et indexé par un chiffre arabe, le tout
+ entre parenthèses. Si ce label ne convient pas, il suffit de spécifier celui
+ souhaité en \meta{option(s)} au moyen de la clé \refKey{label}.
+ \begin{docKey}{label}{={\meta{label}}}{pas de
+ valeur par défaut, initialement initiale du \meta{nom}}
+ Cette clé permet de spécifier un \meta{label} différent de l'initiale du
+ \meta{nom} de l'environnement.
+ \end{docKey}
+\renewenumeration[label=K]{conventions}
+\begin{preamblecode}
+\newenumeration[label=K]{conventions}
+\end{preamblecode}
+\begin{bodycode}[listing and text,listing options={deletekeywords={[2]label}}]
+\begin{conventions}
+\item\label{k-one} Le cheval est bon marché.
+\item\label{k-two} Le cheval est cher.
+\end{conventions}
+Cf. \vref{k-one}. Cf. \vref{k-one,k-two}.
+\end{bodycode}
+
+On remarque que, en cas de références croisées au moyen de la commande
+recommandée\footnote{Cf. \vref{sec-references-croisees}} \refCom{vref} (ou
+\refCom{cref}), le \meta{nom} de la ou des énumérations référencées est
+automatiquement ajouté à la référence et ce, sous ses formes singulière ou
+plurielle selon les cas. Par défaut, la forme :
+\begin{description}
+\item[plurielle] est le \meta{nom} ;
+\item[singulière] est obtenue en supprimant la dernière lettre\footnote{Supposée être
+ souvent un \enquote{s}.} du \meta{nom}.
+\end{description}
+Si ces formes singulière ou plurielle doivent être construites différemment, il
+convient de le spécifier en \meta{option(s)} au moyen des clés
+\refKey{singular} et \refKey{plural} suivantes.
+ \begin{docKey}{singular}{={\meta{forme singulière de l'énumération}}}{pas de
+ valeurpar défaut,\\initialement vide}
+ Cette clé permet de spécifier la forme singulière de l'énumération.
+ \end{docKey}
+ \begin{docKey}{plural}{={\meta{forme plurielle de l'énumération}}}{pas de
+ valeur par défaut,\\initialement vide}
+ Cette clé permet de spécifier la forme plurielle de l'énumération.
+ \end{docKey}
+\begin{preamblecode}
+\newenumeration[singular=cas]{cas} % Sinon, forme sing. = « ca ».
+\end{preamblecode}
+\begin{bodycode}[listing and text,listing options={deletekeywords={[2]label}}]
+\begin{cas}
+\item\label{case-one} Le cheval est bon marché.
+\item\label{case-two} Le cheval est cher.
+\end{cas}
+Cf. \vref{case-one}. Cf. \vref{case-one,case-two}.
+\end{bodycode}
+
+\begin{preamblecode}
+\newenumeration[singular=règle,plural=règles]{regles}
+\end{preamblecode}
+\begin{bodycode}[listing and text,listing options={deletekeywords={[2]label}}]
+\begin{regles}
+\item\label{regle-one} Le cheval est bon marché.
+\item\label{regle-two} Le cheval est cher.
+\end{regles}
+Cf. \vref{regle-one}. Cf. \vref{regle-one,regle-two}.
+\end{bodycode}
+%
+\end{docCommand}
+
+Au besoin, la commande \refCom{renewenumeration} permet de redéfinir une
+énumération préalablement définie au moyen de la commande
+\refCom{newenumeration}.
+
+\begin{docCommand}[doc new=2019-03-18]{renewenumeration}{\oarg{option(s)}\marg{nom}}
+ Cette commande reféfinit l'environnement d'énumération \meta{nom}. Ses
+ \meta{option(s)} sont les mêmes que celles de la commande
+ \refCom{newenumeration}.
+\end{docCommand}
+
\section{Commandes généralistes}
\label{sec:comm-gener}
@@ -1312,8 +1501,8 @@ On soupçonne que non \aside*{par exemple on s'attend à ce que
\section{Sélection d'outils fournis par des packages tiers}
-Cette section donne une liste d'outils (commandes et environnements) fournis par
-des packages automatiquement chargés par la
+Cette section liste un certain nombre d'outils (commandes et environnements)
+fournis par des packages automatiquement chargés par la
\nwejmauthorcl\footnote{L'\vref{sec-packages-charges-ou-pas} liste ceux dont les
fonctionnalités peuvent être utiles aux auteurs.}.
@@ -1332,30 +1521,52 @@ des packages automatiquement chargés par la
\subsection{Références croisées}
\label{sec-references-croisees}
-Le \Package*{cleveref}, utilisé conjointement avec le \Package*{varioref}, rend la
-commande \refCom{vref} de ce dernier très puissante.
+\DeclareFixedFootnote{\objets}{Section, équation, théorème, figure, tableau,
+ etc.}
+
+Le \Package*{cleveref} rend puissante la gestion des références croisées. Il
+fournit notamment les commandes \refCom{cref} et \refCom{vref} suivantes.
+
+\begin{docCommand}{cref}{\brackets{\meta{label$_1$},...,\meta{label$_n$}}}
+ Si un ou plusieurs objets\objets{} sont labellisés au moyen de
+ \lstinline[deletekeywords={[2]label}]|\label{|\meta{label$_1$}|}|,...,
+ \lstinline[deletekeywords={[2]label}]|\label{|\meta{label$_n$}|}|, la commande
+ \refCom{cref} :
+ \begin{itemize}
+ \item en affiche les numéros\footnote{Entourés de parenthèses quand c'est
+ l'usage, p. ex. pour les équations.} ;
+ \item en détecte les natures\objets{} et affiche avant leurs numéros les mots clés
+ correspondants\footnote{Fonctionnalité fournie par le \Package{cleveref}.},
+ automatiquement traduit dans la langue de l'article\footnote{Fonctionnalité
+ fournie par la \nwejmauthorcl.}.
+ \end{itemize}
+ %
+\begin{bodycode}[listing and text]
+On se reportera aux \cref{sec-titre,sec-auteurs} [...]
+\end{bodycode}
+\end{docCommand}
-\begin{docCommand}{vref}{\marg{label}}
- Cette commande affiche le numéro d'un objet\footnote{Section, équation,
- théorème, figure, tableau, etc.} labellisé par la commande
- |\label{|\meta{label}|}| et :
+\begin{docCommand}{vref}{\brackets{\meta{label$_1$},...,\meta{label$_n$}}}
+ Cette commande :
\begin{itemize}
- \item affiche (ou pas selon le contexte) le numéro de la page où se situe cet
- objet\footnote{Fonctionnalité fournie par le \Package{varioref}.} ;
- \item détecte la nature de cet objet et fait précéder le numéro de celui-ci du
- mot clé correspondant\footnote{Fonctionnalité fournie par le
- \Package{cleveref}.} automatiquement traduit dans la langue de
- l'article\footnote{Fonctionnalité fournie par la \nwejmauthorcl.} ;
- \item fait de la référence à l'objet (numéro et éventuel numéro de page) un
- lien hypertexte vers l'objet\footnote{Fonctionnalité fournie par le
- \Package{hyperref}.}.
+ \item reprend les fonctionnalités de \refCom{cref} ;
+ \item affiche\footnote{Ou pas selon le contexte.} après les numéros des objets
+ référencés les (numéros de) pages où ils se situent\footnote{Fonctionnalité
+ fournie par le \Package{varioref}.}.
\end{itemize}
+
+ %
\begin{bodycode}[listing and text]
-[...] on se reportera à l'\vref{sec-canevas-de-fichier} pour un
-canevas de fichier source [...]
+On se reportera aux \vref{sec-titre,sec-auteurs} [...]
\end{bodycode}
\end{docCommand}
+\begin{dbremark}{Liens hypertextes vers l'objet référencé}{}
+ Les numéros et éventuels \aside{numéros de} pages des références croisées
+ créées avec \refCom{cref} et \refCom{vref} sont des liens hypertextes vers les
+ objets référencés\footnote{Fonctionnalité fournie par le \Package{hyperref}.}.
+\end{dbremark}
+
% \begin{dbremark}{\docAuxCommand{ref} et \docAuxCommand{eqref} : clones de \protect\refCom{vref}}{}
% Les traditionnelles commandes \docAuxCommand{ref} et \docAuxCommand{eqref} ont
% été redéfinies par la \nwejmauthorcl pour fonctionner de façon identique
@@ -1504,6 +1715,7 @@ Il lui répondit : \enquote{Courteline disait: \enquote{Passer
ajoutés\footnote{Au moyen de la commande \docAuxCommand{addbibresource}} et
y étant identifiée par la clé \meta{clé}.
+\renewcommand{\thempfootnote}{\arabic{mpfootnote}}
\begin{bodycode}[listing and text,listing options={alsolanguage={[biblatex]TeX},alsolanguage={[csquotes]TeX},deletekeywords={[3]footnote}}]
\citeauthor{Bitouze} précise que :
\blockcquote{Bitouze}{%
@@ -1513,6 +1725,7 @@ Il lui répondit : \enquote{Courteline disait: \enquote{Passer
dépassant 3~lignes.}.%
}.
\end{bodycode}
+\renewcommand{\thempfootnote}{\alph{mpfootnote}}
\end{docCommand}
La commande \refCom{blockcquote} admet des arguments optionnels permettant
@@ -1574,10 +1787,10 @@ versions étoilées de ces environnements qui composent ces listes \enquote{en
Cet environnement compose une liste \enquote{de description} en ligne.
\end{docEnvironment}
-\begin{bodycode}[listing and text,listing options={alsolanguage={[hyperref]TeX},deletekeywords={math},deletekeywords={[2]url}}]
+\begin{bodycode}[listing and text,listing options={alsolanguage={[hyperref]TeX},deletekeywords={math},deletekeywords={[2]url,math}}]
\begin{enumerate}
-\item Les données que j’ai rassemblées [...]
-\item Les données que j’ai recueillies sont
+\item Les données que j'ai rassemblées [...]
+\item Les données que j'ai recueillies sont
\begin{enumerate*}
\item disponibles publiquement sur internet : pages Web et CV des
conférenciers ;