summaryrefslogtreecommitdiff
path: root/Master/texmf-dist
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2022-09-22 20:05:30 +0000
committerKarl Berry <karl@freefriends.org>2022-09-22 20:05:30 +0000
commitf6f59051b1089b0409fa1f06800b22119ab95137 (patch)
tree327447ce5c36d044e83f2e9e688d974801d09258 /Master/texmf-dist
parent3c02a12e8424d3edf518d7651ce50a31e820d626 (diff)
nwejm (22sep22)
git-svn-id: svn://tug.org/texlive/trunk@64462 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist')
-rw-r--r--Master/texmf-dist/doc/latex/nwejm/CHANGELOG.md23
-rw-r--r--Master/texmf-dist/doc/latex/nwejm/README.md6
-rw-r--r--Master/texmf-dist/doc/latex/nwejm/english/README-TRANSLATION.md5
-rw-r--r--Master/texmf-dist/doc/latex/nwejm/english/nwejm-en.bib65
-rw-r--r--Master/texmf-dist/doc/latex/nwejm/english/nwejm-en.pdfbin0 -> 324653 bytes
-rw-r--r--Master/texmf-dist/doc/latex/nwejm/english/nwejm-en.tex1973
-rw-r--r--Master/texmf-dist/doc/latex/nwejm/examples/article-in-dutch.pdfbin113934 -> 199039 bytes
-rw-r--r--Master/texmf-dist/doc/latex/nwejm/examples/article-in-english.pdfbin194646 -> 194867 bytes
-rw-r--r--Master/texmf-dist/doc/latex/nwejm/examples/article-in-french.pdfbin251468 -> 251488 bytes
-rw-r--r--Master/texmf-dist/doc/latex/nwejm/examples/article-in-german.pdfbin202038 -> 202196 bytes
-rw-r--r--Master/texmf-dist/doc/latex/nwejm/examples/issue.pdfbin397553 -> 397932 bytes
-rw-r--r--Master/texmf-dist/doc/latex/nwejm/examples/latexmkrc2
-rw-r--r--Master/texmf-dist/doc/latex/nwejm/examples/sample.pdfbin193330 -> 108033 bytes
-rw-r--r--Master/texmf-dist/doc/latex/nwejm/examples/template.tex2
-rw-r--r--Master/texmf-dist/doc/latex/nwejm/french/latexmkrc2
-rw-r--r--Master/texmf-dist/doc/latex/nwejm/french/nwejm-fr.pdfbin339118 -> 345097 bytes
-rw-r--r--Master/texmf-dist/doc/latex/nwejm/french/nwejm-fr.tex27
-rw-r--r--Master/texmf-dist/source/latex/nwejm/nwejm-examples-template.dtx4
-rw-r--r--Master/texmf-dist/source/latex/nwejm/nwejm.dtx79
-rw-r--r--Master/texmf-dist/tex/latex/nwejm/nwejm.cls6
-rw-r--r--Master/texmf-dist/tex/latex/nwejm/nwejmart.cls33
21 files changed, 1172 insertions, 1055 deletions
diff --git a/Master/texmf-dist/doc/latex/nwejm/CHANGELOG.md b/Master/texmf-dist/doc/latex/nwejm/CHANGELOG.md
index 66300a01188..b4dc25d266f 100644
--- a/Master/texmf-dist/doc/latex/nwejm/CHANGELOG.md
+++ b/Master/texmf-dist/doc/latex/nwejm/CHANGELOG.md
@@ -1,5 +1,16 @@
# [Unreleased]
+# [1.0.5] - 2022-09-21
+
+## Fixed
+(First) Page numbers could be not the same in whole issue and in standalone articles.
+
+## Added
+English translation of the documentation.
+
+## Changed
+ `\fixpagenumber` restricted to preamble (`nwejm` class only, not used by the authors).
+
# [1.0.4] - 2022-02-21
## Changed
@@ -13,8 +24,8 @@ Logo file renamed for consistency.
## Fixed
- Authors in headers appeared one page too early.
-- `\begin{alignat}{X}...` displayed "X".
-- Boring warning "unable to apply patch 'eqnum'".
+- `\begin{alignat}{X}...` displayed “X”.
+- Boring warning “unable to apply patch 'eqnum'”.
- Conflicts between `tikzcd` and (Dutch) `babel`.
# [1.0.2] - 2021-10-12
@@ -43,11 +54,11 @@ Logo file renamed for consistency.
# [0.98f] - 2019-03-18
## Added
-- Built-in "conditions" enumeration.
+- Built-in “conditions” enumeration.
- New public command for easily create new enumerations.
## Changed
-- "Such that" symbol in sets definitions now is `\vert` instead of `\slash`.
+- “Such that” symbol in sets definitions now is `\vert` instead of `\slash`.
- `authoryear` bib and cite style changed for `authoryear-comp`.
- Hyperfootnotes now true.
- Documentation improved.
@@ -63,7 +74,7 @@ Logo file renamed for consistency.
## Changed
- Track changes in `expl3`.
- Support for `biblatex` 3.8 changes.
-- "Cont. next page" notifications for `align` and `multline` across page breaks.
+- “Cont. next page” notifications for `align` and `multline` across page breaks.
- *Breaking change* `flalign(*)` and `alignat(*)` now are aliases of `align(*)`
(needed for the previous feature).
- *Breaking change* Package `autonum` not loaded anymore: `equation`, `align`,
@@ -85,7 +96,7 @@ Logo file renamed for consistency.
- Adjustments because of deprecated functions removed from `expl3`.
## Fixed
-- Fix "n.d." appeared in case `.bib` files use `year` field instead of `date`
+- Fix “n.d.” appeared in case `.bib` files use `year` field instead of `date`
field.
- Other minor bug fix.
diff --git a/Master/texmf-dist/doc/latex/nwejm/README.md b/Master/texmf-dist/doc/latex/nwejm/README.md
index 6c30fc79fef..51b2bfc3918 100644
--- a/Master/texmf-dist/doc/latex/nwejm/README.md
+++ b/Master/texmf-dist/doc/latex/nwejm/README.md
@@ -1,14 +1,14 @@
-nwejm - Support for the journal "North-Western European Journal of Mathematics"
+nwejm - Support for the journal “North-Western European Journal of Mathematics”
===============================================================================
About
-------
This bundle includes LaTeX classes and `biblatex` styles files dedicated to the
-new journal "North-Western European Journal of Mathematics".
+new journal “North-Western European Journal of Mathematics”.
Release
-------
-2022-02-21 v1.0.4
+2022-09-21 v1.0.5
Development
-----------
diff --git a/Master/texmf-dist/doc/latex/nwejm/english/README-TRANSLATION.md b/Master/texmf-dist/doc/latex/nwejm/english/README-TRANSLATION.md
deleted file mode 100644
index 07d496fd45a..00000000000
--- a/Master/texmf-dist/doc/latex/nwejm/english/README-TRANSLATION.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Contributions welcome!
-
-Currently, the `yathesis` documentation is not translated in English. In case
-you're interested, please contact the maintainer:
-`denis.bitouze@lmpa.univ-littoral.fr`
diff --git a/Master/texmf-dist/doc/latex/nwejm/english/nwejm-en.bib b/Master/texmf-dist/doc/latex/nwejm/english/nwejm-en.bib
new file mode 100644
index 00000000000..941f6aa0f57
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/nwejm/english/nwejm-en.bib
@@ -0,0 +1,65 @@
+% This file was created with JabRef 2.10.
+% Encoding: UTF8
+
+
+@Online{Bitouze,
+ Title = {Conférence \LaTeX{} \no6},
+ Author = {Bitouzé, Denis},
+ Date = {2022-02-04},
+ Url = {https://mt2e.univ-littoral.fr/Members/denis-bitouze/pub/latex/diapositives-cours-d/conference-n-6/@@download/file/en-ligne6.pdf},
+ Language = {french},
+ Organization = {Université du Littoral Côte d'Opale},
+ Subtitle = {Bibliographie (biber/biblatex), citations d'extraits},
+}
+
+@Online{Bitouze7,
+ Title = {Conférence \LaTeX{} \no7},
+ Author = {Bitouzé, Denis},
+ Date = {2022-02-04},
+ Url = {https://mt2e.univ-littoral.fr/Members/denis-bitouze/pub/latex/diapositives-cours-d/conference-n-7/@@download/file/en-ligne7.pdf},
+ Language = {french},
+ Organization = {Université du Littoral Côte d'Opale},
+ Subtitle = {Glossaires et (liste d’)acronymes, index},
+}
+
+@Manual{Ensenbach,
+ Title = {Liste des péchés des utilisateurs de \LaTeXe},
+ Author = {Ensenbach, Marc and Trettin, Mark and Alfonsi, Bernard},
+ Date = {2011-09-20},
+ Language = {french},
+ Subtitle = {Commandes et extensions obsolètes, et autres erreurs},
+ Url = {http://mirrors.ctan.org/info/l2tabu/french/l2tabufr.pdf},
+
+ Owner = {bitouze},
+ Timestamp = {2015.03.18}
+}
+
+@Book{har,
+ author = {Hartshorne, Robin},
+ title = {Algebraic geometry},
+ note = {Graduate Texts in Mathematics, No. 52},
+ publisher = {Springer-Verlag},
+ address = {New York},
+ date = {1977}
+}
+
+@Book{ laz1,
+ author = {Lazarsfeld, Robert},
+ title = {Positivity in algebraic geometry. {I}},
+ volume = {48},
+ note = {Classical setting: line bundles and linear series},
+ publisher = {Springer-Verlag},
+ address = {Berlin},
+ date = {2004}
+}
+
+@Article{shin,
+ author = {Shin, Kil-Ho},
+ title = {{$3$}-dimensional {F}ano varieties with canonical
+ singularities},
+ journal = {Tokyo J. Math.},
+ volume = {12},
+ date = {1989},
+ number = {2},
+ pages = {375-385}
+}
diff --git a/Master/texmf-dist/doc/latex/nwejm/english/nwejm-en.pdf b/Master/texmf-dist/doc/latex/nwejm/english/nwejm-en.pdf
new file mode 100644
index 00000000000..b6723ddf7d5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/nwejm/english/nwejm-en.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/nwejm/english/nwejm-en.tex b/Master/texmf-dist/doc/latex/nwejm/english/nwejm-en.tex
index e0fc72e5345..57e382120f1 100644
--- a/Master/texmf-dist/doc/latex/nwejm/english/nwejm-en.tex
+++ b/Master/texmf-dist/doc/latex/nwejm/english/nwejm-en.tex
@@ -1,9 +1,18 @@
+\ExplSyntaxOn
+\msg_new:nnn{nwejm}{LuaLaTeX~mandatory}{This~ documentation~ has~ to~ be~
+ compiled~ with~ LuaLaTeX~ only}
+\sys_if_engine_luatex:F
+{
+ \msg_error:nn{nwejm}{LuaLaTeX~mandatory}
+}
+\ExplSyntaxOff
+
\documentclass[english,nolocaltoc]{nwejmart}
%
-\DTMsavedate{release-date}{2020-01-28}
-\newcommand{\releaseversion}{1.0.0}
+\DTMsavedate{release-date}{2022-09-21}
+\newcommand{\releaseversion}{1.0.5}
%
-\usepackage{denisbdoc}
+\usepackage[nwejm]{denisbdoc}
\usepackage{tabulary}
\usepackage[firstpage]{draftwatermark}
%
@@ -11,14 +20,29 @@
\patchcmd{\@mn@margintest}{\@tempswafalse}{\@tempswatrue}{}{}
\patchcmd{\@mn@margintest}{\@tempswafalse}{\@tempswatrue}{}{}
\reversemarginpar
+
+\lst@InputCatcodes
+\def\lst@DefEC{%
+ \lst@CCECUse \lst@ProcessLetter
+ ^^80^^81^^82^^83^^84^^85^^86^^87^^88^^89^^8a^^8b^^8c^^8d^^8e^^8f%
+ ^^90^^91^^92^^93^^94^^95^^96^^97^^98^^99^^9a^^9b^^9c^^9d^^9e^^9f%
+ ^^a0^^a1^^a2^^a3^^a4^^a5^^a6^^a7^^a8^^a9^^aa^^ab^^ac^^ad^^ae^^af%
+ ^^b0^^b1^^b2^^b3^^b4^^b5^^b6^^b7^^b8^^b9^^ba^^bb^^bc^^bd^^be^^bf%
+ ^^c0^^c1^^c2^^c3^^c4^^c5^^c6^^c7^^c8^^c9^^ca^^cb^^cc^^cd^^ce^^cf%
+ ^^d0^^d1^^d2^^d3^^d4^^d5^^d6^^d7^^d8^^d9^^da^^db^^dc^^dd^^de^^df%
+ ^^e0^^e1^^e2^^e3^^e4^^e5^^e6^^e7^^e8^^e9^^ea^^eb^^ec^^ed^^ee^^ef%
+ ^^f0^^f1^^f2^^f3^^f4^^f5^^f6^^f7^^f8^^f9^^fa^^fb^^fc^^fd^^fe^^ff%
+ ^^^^20ac^^^^0153^^^^0152% nouveau pour xetex
+ ^^^^27e8% Left-Pointing Angle Bracket
+ ^^^^27e9% Right-Pointing Angle Bracket
+ ^^00}
+\lst@RestoreCatcodes
\makeatother
%
\indexsetup{level=\section*,toclevel=section,noclearpage}
\makeindex[columns=2]
\tcbset{index format=off}
%
-\lstMakeShortInline[style=dbtex]|
-%
\tcbset{listing options={escapechar=+}}
%
\SetWatermarkColor{gray!10}%
@@ -30,41 +54,48 @@
\addtocategory{examples}{shin,laz1,har}
\addtocategory{documentation}{Bitouze,Bitouze7}
+\newcommand{\no}{\# }
+
\addbibresource{nwejm-fr.bib}
%
\newacronym{nwejm}{nwejm}{North-Western European Journal of Mathematics}
\newacronym{bap}{bap}{bounded approximation property}
\newacronym{msc}{msc}{Mathematical Subject Classification}
\newacronym{url}{url}{Uniform Resource Locator}
-\newacronym{tdm}{tdm}{table des matières}
+\newacronym{toc}{toc}{table of contents}
%
\newtheorem{article}
-\newtheorem[style=definition]{fait}
-\newtheorem[title=expérience]{experience}
-\newtheorem[title-plural=anneaux]{anneau}
-\newtheorem[title=idéal,title-plural=idéaux]{ideal}
+\newtheorem[style=definition]{fact}
+\newtheorem[title=experience]{experience}
+\newtheorem[title-plural=rings]{ring}
+\newtheorem[title=ideal,title-plural=ideals]{ideal}
%
\newenumeration{conventions}
-\newenumeration[singular=cas]{cas}
-\newenumeration[singular=règle,plural=règles]{regles}
+\newenumeration[singular=criterion]{criteria}
+\newenumeration[singular=rôle,plural=rôles]{roles}
%
\DeclareMathOperator{\cat}{Cat}
\newcommand{\mybinop}{\mathbin{*}}
%
\begin{document}
-\title[Documentation de la classe \LaTeX{} du
-\texorpdfstring{\nwejm}{NWEJM}]{Documentation de la classe \LaTeX{} du \nwejm*{}
- destinée aux auteurs}%
+\title[Documentation of the \LaTeX{} class of
+\texorpdfstring{\nwejm}{NWEJM}]{Documentation of the \LaTeX{} class of \nwejm*{}
+ for authors}%
%
-\subtitle[Version \releaseversion{} (\DTMusedate{release-date})]{\small Version \releaseversion{} en
- date du \DTMusedate{release-date}}%
+\subtitle[Version \releaseversion{} (\DTMusedate{release-date})]{\small Version
+ \releaseversion{} as of \DTMusedate{release-date}}%
%
\author[%
affiliation={%
- Université du Littoral Côte d'Opale, Laboratoire de mathématiques pures et
- appliquées (\nolinkurl{denis.bitouze@univ-littoral.fr})%
+ Université du Littoral Côte d'Opale, Laboratoire de math\'ematiques pures et
+ appliqu\'ees (\nolinkurl{denis.bitouze@univ-littoral.fr})%
},%
]{Bitouzé, Denis}
+\author[%
+affiliation={%
+ Université de Lille, Laboratoire Paul Painlevé UMR CNRS 8524 (\nolinkurl{philippe.heinrich@univ-lille.fr})%
+},%
+]{Heinrich, Philippe}
%
\maketitle
%
@@ -74,182 +105,159 @@ affiliation={%
\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
- \file{latexmkrc} joint à la présente classe.}
+\DeclareFixedFootnote{\suitecompilations}{To automate these
+ compilations, one can use the \program{latexmk} \enquote{compiler},
+ provided by any recent \TeX{} distribution, with the help of the
+ \file{latexmkrc} configuration file attached to this class.}
\section{Introduction}
\label{sec-introduction}
-\begin{dbremark}{Documentation : travail en cours}{}
- La présente documentation est un travail en cours. Nous prions les lecteurs
- qui ont des remarques à formuler ou qui trouveront des erreurs de bien vouloir
- nous les signaler à l'adresse courriel figurant en page de titre.
+\begin{dbremark}{Documentation: work in progress}{}
+This documentation is a work in progress. Readers finding errors or with comments are invited to send them via the email address on the title page.
\end{dbremark}
-\begin{dbwarning}{Classe à utiliser}{}
- Le \gls{nwejm} fournit deux classes \LaTeX{} :
+\begin{dbwarning}{Class to be used}{}
+ The \gls{nwejm} provides two \LaTeX{} classes:
\begin{enumerate}
- \item la \nwejmcl{} conçue pour les numéros entiers de la revue, donc destinée
- à l'équipe du \nwejm{} (et normalement pas aux auteurs d'articles) ;
- \item la \nwejmauthorcl{} destinée aux auteurs d'articles à paraître dans le
- \gls{nwejm}.
+ \item The \nwejmcl{} designed for entire issues of the journal, and thus intended for the \nwejm{} managing team (and not for authors of articles);
+ \item The \nwejmauthorcl{} for authors of articles to be published in \gls{nwejm}.
\end{enumerate}
- Les auteurs d'articles prendront donc soin de recourir à la \nwejmauthorcl{}
- et \emph{pas} à la \nwejmcl{}.
+ Authors of articles should therefore take care to use the \nwejmauthorcl{}
+ and \emph{not} the \nwejmcl{}.
+\end{dbwarning}
+
+\begin{dbwarning}{Required packages}{}
+ In order to use the \nwejmauthorcl{}, it is necessary to have:
+ \begin{itemize}
+ \item A reasonably recent \hologo{TeX} distribution;
+ \item The \Package{biblatex};
+ \item The
+ \href{https://www.ctan.org/pkg/biber}{\program{biber}}\footnote{Attention!
+ The bibliography must be compiled not with the usual
+ \program{bibtex}, but with \program{biber}. More details in
+ \vref{wa-affichage-auteurs} and \vref{sec-bibliographie}.} program.
+ \end{itemize}
+ With Ubuntu for example, if \hologo{TeX}~Live is installed via the GNU/Linux distribution packages, those named \package{texlive-bibtex-extra} and
+ \package{biber} are required.
\end{dbwarning}
-La classe \LaTeX{} \nwejmauthor{} est destinée aux auteurs souhaitant publier un
-article dans le \href{http://math.univ-lille1.fr/~nwejm/}{\gls{nwejm}}. Cette
-classe a pour but :
+The \LaTeX{} class \nwejmauthor{} is intended for authors wishing to publish an article in \href{http://math.univ-lille1.fr/~nwejm/}{\gls{nwejm}}. The purpose of this class is:
\begin{enumerate}
-\item de reproduire fidèlement la maquette de la \nwejm{}, permettant ainsi
- aux auteurs de pouvoir travailler la mise en page de leur document dans des
- conditions réelles ;
-\item de fournir un certain nombre d'outils (commandes et environnements)
- destinés à faciliter la rédaction de documents, notamment ceux contenant des
- formules de mathématiques.
+\item To accurately reproduce the \nwejm{}'s layout, allowing thus authors to work on the layout of their document under real conditions;
+\item To provide some tools (commands et environments) to facilitate the writing of documents, especially those containing mathematics.
\end{enumerate}
-\begin{dbwarning}{Codage d'entrée \protect\lstinline+UTF-8+ obligatoire}{}
- La \nwejmauthorcl{} du \nwejm{} repose de façon cruciale sur un codage
- d'entrée en |UTF-8| :
+\begin{dbwarning}{\protect\lstinline+UTF-8+ input encoding required}{}
+ The \nwejmauthorcl{} of \nwejm{} relies crucially on ×UTF-8× input encoding:
\begin{itemize}
- \item elle charge le \Package{inputenc}\footnote{%
- Il convient donc de \emph{ne pas} charger ce package : on se reportera
- à l'\vref{sec-canevas-de-fichier} pour un canevas de fichier source
- destiné à la \nwejm{} et notamment pour un préambule typique.%
+ \item It loads the \Package{inputenc}\footnote{%
+ It is therefore advisable \emph{not} to load this package: see \vref{sec-canevas-de-fichier} for an outline of the source file for \nwejm{} and in particular for a typical preamble.%
%
}
%
- avec l'option \docAuxKey{utf8} ;
- \item elle suppose que les fichiers sources \file{.tex} sont effectivement
- codés en |UTF-8| : on veillera donc à ce que l'éditeur utilisé soit réglé
- sur ce codage d'entrée.
+ with the \docAuxKey{utf8} option;
+ \item It assumes that \file{.tex} source files are indeed encoded in ×UTF-8×: make sure that your computer editor is correctly set for this input encoding.
\end{itemize}
\end{dbwarning}
-\begin{dbwarning}{Format et compilation \hologo{pdfLaTeX}}{}
- La composition des numéros du \nwejm*{} met en œuvre :
+\begin{dbwarning}{Format and \hologo{pdfLaTeX} compilation}{}
+ The composition of the \nwejm*{} volumes involves:
\begin{itemize}
- \item le format \hologo{LaTeX}\footnote{Sous sa version \hologo{LaTeXe}, la
- plus courante de nos jours.}. On évitera donc les commandes des autres
- formats tels que \hologo{plainTeX} ;
- \item le compilateur privilégié est \hologo{pdfLaTeX}. En particulier, le
- compilateur \hologo{LaTeX} n'étant \emph{a priori} pas utilisé, nous
- préférons :
+ \item The \hologo{LaTeX} format\footnote{In its \hologo{LaTeXe} version, the most
+ common today.}. Commands of other formats such as \hologo{plainTeX} should therefore be avoided;
+ \item The preferred compiler is \hologo{pdfLaTeX}. In particular, as the \hologo{LaTeX} is not used \emph{a priori}, we prefer:
\begin{enumerate}
- \item comme formats d'images : \format{jpg}, \format{png} et
- \format{pdf}\footnote{Le format recommandé est \format{pdf} car il est
- vectoriel si bien que la qualité des images n'est pas dégradée en cas de
- redimensionnement.} ;
- \item éviter l'usage de code \program{PostScript}, notamment via
- \program{PSTricks} et, comme outil de dessin, privilégions par exemple le
- \Package{TikZ}.
+ \item \format{jpg}, \format{png} et
+ \format{pdf}\footnote{The recommended format is \format{pdf} since it is vector-based so that the quality of the images is not degraded by resizing.} as image formats;
+ \item Avoid \program{PostScript} code, especially via
+ \program{PSTricks}, and use the \Package{TikZ} as drawing tool
+ for instance.
\end{enumerate}
\end{itemize}
\end{dbwarning}
-\section{Configuration de l'article}
+\section{Article's configuration}
-\subsection{Langue de l'article}
+\subsection{Language}
\label{sec:langue-de-larticle}
-Le \nwejm{} accepte des articles dans chacune des quatre langues
+The \nwejm{} accepts articles in four languages:
\begin{itemize}
-\item anglais ;
-\item français ;
-\item allemand ;
-\item néerlandais ;
+\item English
+\item French
+\item German
+\item Dutch
\end{itemize}
-et la \nwejmauthorcl{} permet de spécifier la langue choisie\footnote{La gestion
- des langues est assurée en sous-main par le \Package{babel}.} au moyen des
-options de classe suivantes.
+and the \nwejmauthorcl{} allows to specify the language\footnote{The language is managed underhand by the \Package{babel}.} by using the following classes.
% \refKey{english}, \refKey{french}, \refKey{ngerman} \refKey{dutch}
-\begin{docKey}{english}{}{pas de valeur, option par défaut}
- Cette option définit l'anglais comme langue de l'article.
+\begin{docKey}{english}{}{no value, default option}
+ This option sets English as article language.
\end{docKey}
-\begin{docKey}{french}{}{pas de valeur}
- Cette option définit le français comme langue de l'article.
+\begin{docKey}{french}{}{no value}
+ This option sets French as article language.
\end{docKey}
-\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
- \protect\refKey{german}}{}
- L'option de langue \refKey{german} de la \nwejmauthorcl{} appelle en
- sous-main l'option \docAuxKey*{ngerman} du \Package*{babel}.
+\begin{docKey}{german}{}{no value}
+ This option sets German as article language. It as \docAuxKey{ngerman} as alias.
+ \begin{dbremark}{\package*{babel} option underlying the \protect\refKey{german} option}{}
+ The \refKey{german} language option of \nwejmauthorcl{} calls underhand the \docAuxKey*{ngerman} option of \Package*{babel}.
\end{dbremark}
\end{docKey}
-\begin{docKey}{dutch}{}{pas de valeur}
- Cette option définit le néerlandais comme langue de l'article.
+\begin{docKey}{dutch}{}{no value}
+ This option sets Dutch as article language.
\end{docKey}
-\begin{dbremark}{Langue par défaut de l'article}{}
- Si aucune de ces options n'est spécifiée, la langue de l'article est par
- défaut l'anglais.
+\begin{dbremark}{Default article language}{}
+ If none of these options are specified, the default language is English.
\end{dbremark}
-\subsection{Autres configurations}
+\subsection{Other configurations}
\label{sec:autr-conf}
\begin{docCommand}{articlesetup}{\marg{options}}
- Cette commande permet de configurer les \meta{options} de l'article en cours
- sous la forme clés/valeurs.
-
- La seule clé fournie pour l'instant est \refKey{gradient}.
- \begin{docKey}{gradient}{=\docValue{grad}\textbar\docValue{nabla}}{pas
- de valeur par défaut, initialement \docValue{grad}}
- Cette clé permet de spécifier la façon dont est affiché le gradient grâce
- à la commande \refCom{grad}.
+ This command allows you to configure the \meta{options} of the current article in key/value form.
+
+ The only key provided for the time being is \refKey{gradient}.
+ \begin{docKey}{gradient}{=\docValue{grad}\textbar\docValue{nabla}}{no default value, initially \docValue{grad}}
+ This key allows you to specify how the gradient is displayed using the command \refCom{grad}.
\end{docKey}
\end{docCommand}
-\begin{dbwarning}{Commande \protect\refCom{articlesetup} : pas en préambule !}{}
- La commande \refCom{articlesetup} doit être utilisée \emph{exclusivement} dans
- le corps du document (de préférence juste après |\begin{document}|) sans quoi
- la configuration choisie, certes prise en compte dans l'article isolé,
- risque de ne pas l'être dans le volume complet !
+\begin{dbwarning}{\protect\refCom{articlesetup} command: not in the preamble!}{}
+ The\refCom{articlesetup} command must be \emph{exclusively} used in the body of the document (preferably just after ×\begin{document}×), otherwise the chosen configuration, although taken into account in the article alone, may not be taken into account in the complete volume!
\end{dbwarning}
-\section{Préparation du \enquote{titre} de l'article}
+\section{Preparing the article \enquote{title}}
\label{sec-prep-de-lart}
-Cette section liste les commandes, options et environnement permettant de
-\emph{préparer} le \enquote{titre} de l'article ainsi que son éventuelle partie
-finale.
+This section lists commands, options and environment for \emph{preparing} the \enquote{title} of the article and its possible final part.
-\subsection{Titre, sous-titre}
-\label{sec-titre}
+\subsection{Title, subtitle}
+\label{sec-title}
-\begin{docCommand}[doc new=2017-10-23]{title}{\oarg{titre alternatif {\normalfont\ttfamily\acrshort*{tdm}}}\oarg{titre alternatif entête}\marg{titre}}
- Cette commande définit, pour l'article en cours :
+\begin{docCommand}[doc new=2017-10-23]{title}{\oarg{alternative title {\normalfont\ttfamily\acrshort*{toc}}}\oarg{header alternative title}\marg{title}}
+ This command defines for the current article:
\begin{itemize}
- \item son \meta{titre} figurant en 1\iere{} page ;
- \item son \emph{éventuel} \meta{titre alternatif
- {\normalfont\ttfamily\acrshort*{tdm}}} figurant :
+ \item Its \meta{title} on the first page;
+ \item Its \emph{possible} \meta{alternative title
+ {\normalfont\ttfamily\acrshort*{toc}}} listed in:
\begin{itemize}
- \item dans le volume où l'article sera publié :
+ \item The volume in which the article will be published:
\begin{itemize}
- \item en \gls{tdm} ;
- \item en signet ;
+ \item In the \gls{toc};
+ \item In the bookmarks;
\end{itemize}
- \item dans le fichier \textsc{pdf} de l'article autonome, en métadonnée
- \enquote{Titre} ;
+ \item In the \textsc{pdf} file of the stand-alone article, in the \enquote{Title} metadata;
\end{itemize}
- \item son \emph{éventuel} \meta{titre alternatif entête} figurant en
- entête\footnote{\Ie{} en titre courant.} sur les pages paires.
+ \item Its \emph{possible} \meta{header alternative title} as a header\footnote{\Ie{} in current title.} on even-numbered pages.
\end{itemize}
- L'usage précis de cette commande est synthétisé à la
- \vref{tab-commande-title}.
+ The precise use of this command is summarized in \vref{tab-commande-title}.
\end{docCommand}
\begin{table}[htb]
\centering
- \caption{Usage (des deux arguments optionnels) de la commande
- \protect\refCom{title} }
+ \caption{Using the \protect\refCom{title} command (with two optional arguments)}
\label{tab-commande-title}
\footnotesize%
\lstset{%
@@ -257,96 +265,84 @@ finale.
}
\begin{tabular}{|l|c|c|c|}
\cline{2-4}
- \multicolumn{1}{c|}{} & 1\iere{} page & \gls{tdm} & entête \\\hline
- \lstinline+\title{+\meta{titre}\lstinline+}+ & \multicolumn{3}{c|}{\meta{titre}} \\\hline
- \lstinline+\title[+\meta{alt. {\normalfont\ttfamily\acrshort*{tdm}}}\lstinline+]{+\meta{titre}\lstinline+}+ & \meta{titre} & \multicolumn{2}{c|}{\meta{alt. {\normalfont\ttfamily\acrshort*{tdm}}}} \\\hline
- \lstinline+\title[][+\meta{alt. entête}\lstinline+]{+\meta{titre}\lstinline+}+ & \multicolumn{2}{c|}{\meta{titre}} & \meta{alt. entête} \\\hline
- \lstinline+\title[+\meta{alt. {\normalfont\ttfamily\acrshort*{tdm}}}\lstinline+][+\meta{alt. entête}\lstinline+]{+\meta{titre}\lstinline+}+ & \meta{titre} & \meta{alt. {\normalfont\ttfamily\acrshort*{tdm}}} & \meta{alt. entête} \\\hline
+ \multicolumn{1}{c|}{} & first page & \gls{toc} & header \\\hline
+ \lstinline+\title{+\meta{title}\lstinline+}+ & \multicolumn{3}{c|}{\meta{title}} \\\hline
+ \lstinline+\title[+\meta{alt. {\normalfont\ttfamily\acrshort*{toc}}}\lstinline+]{+\meta{titre}\lstinline+}+ & \meta{title} & \multicolumn{2}{c|}{\meta{alt. {\normalfont\ttfamily\acrshort*{toc}}}} \\\hline
+ \lstinline+\title[][+\meta{alt. header}\lstinline+]{+\meta{title}\lstinline+}+ & \multicolumn{2}{c|}{\meta{title}} & \meta{alt. header} \\\hline
+ \lstinline+\title[+\meta{alt. {\normalfont\ttfamily\acrshort*{toc}}}\lstinline+][+\meta{alt. header}\lstinline+]{+\meta{titre}\lstinline+}+ & \meta{title} & \meta{alt. {\normalfont\ttfamily\acrshort*{toc}}} & \meta{alt. header} \\\hline
\end{tabular}
\end{table}
-\begin{docCommand}{subtitle}{\oarg{sous-titre alternatif {\normalfont\ttfamily\acrshort*{tdm}}}\marg{sous-titre}}
- Cette commande définit \emph{éventuellement}, pour l'article en cours :
+\begin{docCommand}{subtitle}{\oarg{alternative subtitle {\normalfont\ttfamily\acrshort*{toc}}}\marg{subtitle}}
+ This command defines \emph{if needed}, for the current article:
\begin{itemize}
- \item son \meta{sous-titre} figurant en 1\iere{} page à la suite
- du \meta{titre} ;
- \item son \emph{éventuel} \meta{sous-titre alternatif
- {\normalfont\ttfamily\acrshort*{tdm}}} figurant à la suite du
- \meta{titre}\footnote{Ou éventuel \meta{titre alternatif
- {\normalfont\ttfamily\acrshort*{tdm}}}.} :
+ \item Its \meta{subtitle} following the \meta{title} on the first page;
+ \item Its \emph{possible} \meta{alternative subtitle
+ {\normalfont\ttfamily\acrshort*{toc}}} following the
+ \meta{title}\footnote{Or possible \meta{alternative title
+ {\normalfont\ttfamily\acrshort*{toc}}}.} :
\begin{itemize}
- \item dans le volume où l'article sera publié :
+ \item In the issue where the article will be published:
\begin{itemize}
- \item en \gls{tdm} ;
- \item en signet ;
+ \item In the \gls{toc};
+ \item In the bookmarks;
\end{itemize}
- \item dans le fichier \textsc{pdf} de l'article autonome, en métadonnée
- \enquote{Titre}.
+ \item In the \textsc{pdf} file of the stand-alone, in the \enquote{Title} metadata.
\end{itemize}
\end{itemize}
\end{docCommand}
\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
- d'un projet borélien de grande envergure (1921-1939)}
+\title[Treatise on Probability Calculus]{Treatise on Probability Calculus and its Applications}
+\subtitle[Scope and limits of a Borelian project]{Scope and limits of a large-scale Borelian project (1921-1939)}
\end{bodycode}
-\begin{dbremark}{Affichage des titre et sous-titre}{}
- Pour que les titre et sous-titre soient affichés, il est nécessaire de
- recourir à la commande habituelle \refCom{maketitle}.
+\begin{dbremark}{Displaying titles ansd subtitles}{}
+ In order to display the title and subtitle, it is necessary use the usual command \refCom{maketitle}.
\end{dbremark}
-\subsection{Auteur(s)}
-\label{sec-auteurs}
+\subsection{Author(s)}
+\label{sec-authors}
-Un auteur d'article est spécifié au moyen de la commande \refCom{author}
-suivante. En cas d'auteurs multiples, il suffit de (et il faut) recourir
-à plusieurs occurrences de cette commande.
+An article author is specified by means of the \refCom{author} command. In case of mutliple authors, it suffices to use several instances of the command.
-\begin{docCommand}{author}{\oarg{options}\brackets{\meta{Nom}, \meta{Prénom}}}
- Cette commande, facultative, définit un auteur d'article.
+\begin{docCommand}{author}{\oarg{options}\brackets{\meta{Last name}, \meta{First name}}}
+ This optional command defines an article author.
\end{docCommand}
%
-\begin{dbwarning}{Format des prénom et nom de l'auteur}{}
- On veillera à ce que :
+\begin{dbwarning}{Format of the author's first and last name}{}
+ Care should be taken to ensure that:
\begin{enumerate}
- \item la saisie des prénom et nom de l'auteur soit conforme à la syntaxe
- (identique à celle de \hologo{BibTeX} et \package{biblatex}) :
+ \item The entry of the author's first and last name has the right syntax (identical to the one for \hologo{BibTeX} and \package{biblatex}):
%
\begin{bodycode}[listing options={showspaces}]
-"\meta{Nom}", "\meta{Prénom}"
+"\meta{Last Name}", "\meta{First name}"
\end{bodycode}
%
- \item les éventuels caractères diacritiques (accents, etc.) figurent dans les
- \meta{Prénom} et \meta{Nom} ;
- \item le \meta{Nom} \emph{ne} soit \emph{pas} saisi en capitales (sauf pour la
- ou les majuscules)\footnote{Dans les articles en français, ce nom sera
- automatiquement composé en petites capitales.}.
+ \item Any diacritical characters (accents, ...) are included in the \meta{First name} et \meta{Last name} ;
+ \item The \meta{Last name} be \emph{not} entered in upper case (except for the capital letter(s))\footnote{In French articles, this name will automatically be written in small capitals.}.
\end{enumerate}
- La métadonnée \enquote{Auteur} du \File{PDF} produit contient automatiquement
- le ou les auteurs spécifiés.
+ The \enquote{Author} metadata of the generated \File{PDF} automatically contains the specified author(s).
\end{dbwarning}
-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.
+The \refCom{author} command admits an optional argument to specify the
+author's affilation(s) with one of the \refKey{affiliation}
+and \refKey{affiliationtagged} keys.
-\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.
+\begin{docKey}{affiliation}{={\oarg{tag}\marg{affiliation}}}{no
+ default value,\\initially empty}
+ This key is used to define a (unique) \meta{affiliation}. For an
+ author with several affiliation, this key is used as many times as necessary.
- En outre, chaque affiliation peut recevoir un \meta{tag} en vue d'être
- réutilisée pour un autre auteur.
+ In addition, each affiliation can take a \meta{tag} for reuse by
+ another author.
\end{docKey}
-\begin{docKey}{affiliationtagged}{={\marg{tag}}}{pas de valeur par défaut,
- initialement vide}
- Cette clé permet de spécifier une (unique) affiliation déjà définie et taguée
- pour un auteur précédent.
+\begin{docKey}{affiliationtagged}{={\marg{tag}}}{no
+ default value, initially empty}
+ This key allows you to specify a (unique) affiliation already
+ defined and tagged for a previous author.
\end{docKey}
% \begin{bodycode}
@@ -363,55 +359,56 @@ et \refKey{affiliationtagged} suivantes.
\begin{bodycode}
\author[
- affiliation={Laboratoire \textsc{sphere}, Université Paris Diderot}
+ affiliation={Laboratoire \textsc{sphere}, Universit\'e Paris Diderot}
]{Bustamante, Martha-Cecilia}
\author[
- affiliation=[aff2]{\textsc{lpma}, Université Pierre et Marie Curie},
- affiliation={\textsc{ghdso}, Université Paris-Sud}]{Cléry, Matthias}
+ affiliation=[aff2]{\textsc{lpma}, Universit\'e Pierre et Marie Curie},
+ affiliation={\textsc{ghdso}, Universit\'e Paris-Sud}]{Cl\'ery, Matthias}
\author[
affiliationtagged={aff2}
]{Mazliak, Laurent}
\end{bodycode}
-\begin{dbwarning}{Paires d'accolades
+\begin{dbwarning}{Brace pairs
% des clés \refKey{affiliation} et \refKey{minibio}
- (relativement) obligatoires}{}
- Au cas (probable) où une valeur \meta{affiliation} contienne une ou plusieurs
- virgules, la paire d'accolades l'entourant est obligatoire.
+ }{}
+ In the presence of commas in the \meta{affiliation} value, a pair of braces
+ around it is mandatory.
\end{dbwarning}
-\begin{dbwarning}{Affichage des prénoms et noms du ou des auteurs}{}
- Pour que les prénoms et noms du ou des auteurs soient affichés, il est
- nécessaire :
+\begin{dbwarning}{Dislpay of first and last names of author(s)}{affichage-auteurs}
+ To display the first and last names of the author(s), it is
+ necessary:
\begin{enumerate}
- \item de recourir à la commande habituelle \refCom{maketitle} ;
- \item de procéder à une suite de compilations\suitecompilations{} :
+ \item To use the usual \refCom{maketitle} command;
+ \item To do several compilations\suitecompilations{}:
\begin{enumerate}
\item \hologo{pdfLaTeX} ;
- \item \hologo{biber} ;
+ \item \program{biber} ;
\item \hologo{pdfLaTeX}.
\end{enumerate}
\end{enumerate}
\end{dbwarning}
-\subsection{Résumé}
+\subsection{Summary}
\label{sec-resume}
-\begin{docEnvironment}[doc description=\mandatory,doclang/environment content=résumé]{abstract}{}
- Cet environnement est destiné à recevoir le \meta{résumé} de l'article.
+\begin{docEnvironment}[doc description=\mandatory,doclang/environment content=abstract]{abstract}{}
+ This environment is intended to receive the article's \meta{abstract}.
\end{docEnvironment}
-\subsection{Mots clés}
+\subsection{Keywords}
-\begin{docCommand}[doc description=\mandatory]{keywords}{\oarg{variante des mots clés}\marg{mots clés}}
- Cette commande permet de spécifier les \meta{mots clés} de l'article sous la
- forme d'une liste séparée par des virgules.
+\begin{docCommand}[doc
+ description=\mandatory]{keywords}{\oarg{variant of keywords}\marg{keywords}}
+ This command allows you to specify the article \meta{keywords} in
+ the form of a comma-separated list.
- 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 (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.
+ The \enquote{Keywords} metadata of the generated \File{PDF} automatically
+ contains the specified \meta{keywords}. If these contains
+ characters (notably mathematical ones) that are not allowed in the
+ metadata of \file{PDF} files, an optional argument is to specify a
+ \meta{variant of keywords} containing only allowed characters.
\end{docCommand}
\begin{bodycode}[listing options={deletekeywords={[5]keywords}}]
@@ -421,36 +418,35 @@ et \refKey{affiliationtagged} suivantes.
\subsection{\texorpdfstring{\acrfull{msc}}{MSC}}
\begin{docCommand}[doc description=\mandatory]{msc}{\marg{\acrshort{msc}}}
- Cette commande permet de spécifier le (ou les) \meta{\acrshort{msc}} de
- l'article sous la forme d'une liste séparée par des virgules.
+ This command allows you to specify the \meta{\acrshort{msc}} of the article
+ l'article in the form of a comma-separated list.
\end{docCommand}
-\section{Production du titre de l'article}
+\section{Generating the article title}
\label{sec-creation-du-titre}
-Le titre proprement dit de l'article, regroupant tous les éléments saisis à la
-\vref{sec-prep-de-lart}, est produit par la commande standard
-\refCom{maketitle}.
+The actual title of the article, combining all the elements entered in
+\vref{sec-prep-de-lart}, is generated by the standard
+\refCom{maketitle} command.
\begin{docCommand}[doc description=\mandatory]{maketitle}{}
- Cette commande \emph{produit} l'affichage du \enquote{titre} de l'article,
- c'est-à-dire :
+ This command \emph{displays} the article's \enquote{title}, i.e.:
\begin{itemize}
- \item son titre et son éventuel sous-titre (commandes \refCom{title} et
- \refCom{subtitle}) ;
- \item son ou ses auteurs, sous la forme de leurs noms et prénoms (commande(s)
- \refCom{author}) et, en note de bas de page, leurs affiliations respectives ;
- \item son éventuel résumé (environnement \refEnv{abstract}) ;
- \item son ou ses mots clés (commande \refCom{keywords}) ;
- \item son ou ses \acrshort{msc} (commande \refCom{msc}).
+ \item Its title and possible subtitle (\refCom{title} and
+ \refCom{subtitle} commands);
+ \item Its author(s), in the form of their full name(s)
+ (\refCom{author} command) and, in footnote, their respective affiliations;
+ \item Its possible abstract (\refEnv{abstract} environment) ;
+ \item Its keyword(s) (\refCom{keywords} command) ;
+ \item Its \acrshort{msc} (\refCom{msc} command).
\end{itemize}
\end{docCommand}
\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
- d'un projet borélien de grande envergure (1921-1939)}
+\subtitle[Étendue et limites d'un projet borélien]{Étendue et
+ limites d'un projet borélien de grande envergure (1921-1939)}
%
\author[
affiliation={Laboratoire \textsc{sphere}, Université Paris Diderot}
@@ -473,12 +469,11 @@ Le titre proprement dit de l'article, regroupant tous les éléments saisis à l
\maketitle
\end{bodycode}
-\section{Remerciements}
+\section{Acknowledgements}
\label{sec:remerciements}
-\begin{docCommand}{acknowledgements}{\marg{remerciements}}
- Cette commande, facultative, permet de spécifier des \meta{remerciements} pour
- un article.
+\begin{docCommand}{acknowledgements}{\marg{thanks}}
+ This optional command allows you to specify \meta{thanks} for an article.
\end{docCommand}
\begin{bodycode}[listing options={deletekeywords={[2]first}}]
@@ -491,40 +486,41 @@ Le titre proprement dit de l'article, regroupant tous les éléments saisis à l
}
\end{bodycode}
-\begin{dbremark}{Affichage des remerciements sur les auteurs}{}
- Pour que les remerciements soient affichés, il est nécessaire de recourir à la
- commande \refCom{printbibliography} destinée à être utilisée en fin d'article.
+\begin{dbremark}{Displaying acknowledgements}{}
+ For the acknowledgements to be displayed, it is necessary to use the
+ \refCom{printbibliography} command at the end of the article.
\end{dbremark}
-\section{Commandes de structuration}
+\section{Structuring commands}
-La \nwejmauthorcl{} modifie la commande usuelle de structuration
-\docAuxCommand{section} pour permettre d'en différencier le titre alternatif
-figurant en \gls{tdm} de celui figurant en entête\footnote{On notera, de ce
- point de vue, la similitude avec la commande \protect\refCom{title}.}.
+The \nwejmauthorcl{} modifies the usual
+\docAuxCommand{section} structuring command in order to differentiate
+the alternative title in \gls{toc} from that in the
+header\footnote{Note, from this point of view, the similarity with the
+ \protect\refCom{title} command.}.
-\begin{docCommand}[doc new=2017-10-23]{section}{\oarg{titre alternatif {\normalfont\ttfamily\acrshort*{tdm}}}\oarg{titre alternatif entête}\marg{titre}}
- Cette commande définit, pour la section en cours :
+\begin{docCommand}[doc new=2017-10-23]{section}{\oarg{alternative title {\normalfont\ttfamily\acrshort*{toc}}}\oarg{alternative title header}\marg{title}}
+ This command defines for the current section:
\begin{itemize}
- \item son \meta{titre} figurant au fil du texte ;
- \item son \emph{éventuel} \meta{titre alternatif
- {\normalfont\ttfamily\acrshort*{tdm}}} figurant, dans le volume où
- l'article sera publié :
+ \item Its \meta{title} appearing throughout the text;
+ \item Its \emph{possible} \meta{alternative title
+ {\normalfont\ttfamily\acrshort*{toc}}} appearing in the issue
+ where the article will be published:
\begin{itemize}
- \item en \gls{tdm} ;
- \item en signet.
+ \item In the \gls{toc};
+ \item As a bookmark.
\end{itemize}
- \item son \emph{éventuel} \meta{titre alternatif entête} figurant en
- entête\footnote{\Ie{} en titre courant.} sur les pages impaires.
+ \item Its \emph{possible} \meta{alternative title
+ header}\footnote{\Ie{} in the current title.} appearing
+ on odd-numbered pages.
\end{itemize}
- L'usage précis de cette commande est synthétisé à la
- \vref{tab-commande-section}.
+ The precise use of this command is summarised in \vref{tab-commande-section}.
\end{docCommand}
\begin{table}[htb]
\centering
- \caption{Usage (des deux arguments optionnels) de la commande
- \protect\refCom{section} }
+ \caption{Use (of the two optional arguments) of the
+ \protect\refCom{section} command}
\label{tab-commande-section}
\footnotesize%
\lstset{%
@@ -532,75 +528,74 @@ figurant en \gls{tdm} de celui figurant en entête\footnote{On notera, de ce
}
\begin{tabular}{|l|c|c|c|}
\cline{2-4}
- \multicolumn{1}{c|}{} & fil du texte & \gls{tdm} & entête \\\hline
- \lstinline+\section{+\meta{titre}\lstinline+}+ & \multicolumn{3}{c|}{\meta{titre}} \\\hline
- \lstinline+\section[+\meta{alt. {\normalfont\ttfamily\acrshort*{tdm}}}\lstinline+]{+\meta{titre}\lstinline+}+ & \meta{titre} & \multicolumn{2}{c|}{\meta{alt. {\normalfont\ttfamily\acrshort*{tdm}}}} \\\hline
- \lstinline+\section[][+\meta{alt. entête}\lstinline+]{+\meta{titre}\lstinline+}+ & \multicolumn{2}{c|}{\meta{titre}} & \meta{alt. entête} \\\hline
- \lstinline+\section[+\meta{alt. {\normalfont\ttfamily\acrshort*{tdm}}}\lstinline+][+\meta{alt. entête}\lstinline+]{+\meta{titre}\lstinline+}+ & \meta{titre} & \meta{alt. {\normalfont\ttfamily\acrshort*{tdm}}} & \meta{alt. entête} \\\hline
+ \multicolumn{1}{c|}{}
+ & text flow & \gls{toc} & header \\\hline
+ \lstinline+\section{+\meta{title}\lstinline+}+ & \multicolumn{3}{c|}{\meta{title}} \\\hline
+ \lstinline+\section[+\meta{alt. {\normalfont\ttfamily\acrshort*{toc}}}\lstinline+]{+\meta{title}\lstinline+}+ & \meta{title} & \multicolumn{2}{c|}{\meta{alt. {\normalfont\ttfamily\acrshort*{toc}}}} \\\hline
+ \lstinline+\section[][+\meta{alt. header}\lstinline+]{+\meta{title}\lstinline+}+ & \multicolumn{2}{c|}{\meta{title}} & \meta{alt. header} \\\hline
+ \lstinline+\section[+\meta{alt. {\normalfont\ttfamily\acrshort*{toc}}}\lstinline+][+\meta{alt. header}\lstinline+]{+\meta{title}\lstinline+}+ & \meta{title} & \meta{alt. {\normalfont\ttfamily\acrshort*{toc}}} & \meta{alt. header} \\\hline
\end{tabular}
\end{table}
-\section{Bibliographie}
+\section{Bibliography}
\label{sec-bibliographie}
-Pour composer les bibliographies, la \nwejmauthorcl{} recourt aux outils
-modernes que sont le \Package*{biblatex} et le moteur \hologo{biber} dont
-l'usage peut être brièvement résumé comme suit\autocite[Pour plus de détails,
-cf. par exemple][en français]{Bitouze}.
+To compose bibliographies, the \nwejmauthorcl{} uses modern tools such
+as the \Package*{biblatex} and \hologo{biber} engine. Their use can
+be summarized as follows\autocite[for more details, see e.g.][in French]{Bitouze}.
\begin{enumerate}
-\item Construire, dans un \meta{fichier bibliographique}\footnote{De tels
- fichiers sont d'extension \file{.bib}.}, une base bibliographique.
-
- 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 :
+\item Build a bibliographic database in a \meta{bibliographic file}\footnote{Such
+ files have a \file{.bib} extension.}.
+
+ To do this, we recommend to use a dedicated software,
+ \href{http://jabref.sourceforge.net/}{\program{JabRef}} for
+ instance, configured via the menu
+ \menuentry{Options>Preferences>General} and by choosing:
\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}, 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} :
+ By the way, we can change the interface language in the
+ \menuentry{Language} drop-down list.
+
+ Don't forget to assign a unique \meta{key} to each bibliographic
+ reference\footnote{In \program{JabRef}, the
+ \enquote{magic wand} or key icon helps to generate the \meta{key}.}.
+\item In the \file{.tex} source file:
\begin{enumerate}
- \item \emph{En préambule}, utiliser la commande \docAuxCommand{addbibresource}
- pour indiquer le \meta{fichier bibliographique} à considérer :
+ \item \emph{In the preamble}, use the \docAuxCommand{addbibresource}
+ command to specify the \meta{bibliographic file}:
\begin{preamblecode}[listing options={alsolanguage={[biblatex]TeX}}]
-\addbibresource{"\meta{fichier bibliographique}".bib}
+\addbibresource{"\meta{bibliographic file}".bib}
\end{preamblecode}
- \item Dans le corps du document, utiliser la commande
- \docAuxCommand{autocite}\footnote{De préférence à la commande
- \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 des références bibliographiques (chacune
- pourvue d'une \meta{clé}) :
+ \item In the body of the document, use the \docAuxCommand{autocite}
+ command\footnote{Preferably to the \docAuxCommand{cite}
+ command.}\footnote{The reference is then detailed in a
+ footnote.} or, optionally, the \docAuxCommand{textcite}
+ command\footnote{The reference is then displayed throughout the
+ text, but with less details.} from the \Package*{biblatex} to
+ cite bibliographic references (each with a \meta{key}):
\begin{bodycode}[listing options={alsolanguage={[biblatex]TeX}}]
-...\autocite{"\meta{clé1}"}... \textcite{"\meta{clé2}"} ...
-...\autocite{"\meta{clé3,clé4}"}... \textcite{"\meta{clé5,clé6}"} ...
+...\autocite{"\meta{key1}"}... \textcite{"\meta{key2}"} ...
+...\autocite{"\meta{key3,key4}"}... \textcite{"\meta{key5,key6}"} ...
\end{bodycode}
- \item À la fin du document, faire figurer la liste des références
- bibliographiques au moyen de la commande \refCom{printbibliography}.
+ \item At the end of the document, list the bibliographic
+ references by using the \refCom{printbibliography} command.
\end{enumerate}
-\item Procéder à une suite de compilations \hologo{pdfLaTeX}, \hologo{biber} et
+\item Perform the successive compilations \hologo{pdfLaTeX}, \hologo{biber}
+ and
\hologo{pdfLaTeX}\suitecompilations.
\end{enumerate}
\begin{docCommand}{printbibliography}{}
- Cette commande produit la liste des références bibliographiques saisies selon
- la syntaxe du \Package*{biblatex}. Elle a été redéfinie de sorte
- à automatiquement afficher, avant la liste des références, les éventuels
- remerciements (commande \refCom{acknowledgements}).
+ This command produces the bibliographic references list entered
+ with respect to the \Package*{biblatex} syntax. It has been
+ redefined to automatically display the possible
+ acknowledgements
+ (\refCom{acknowledgements} command) before the references list.
\end{docCommand}
-Par exemple, si le \File{.bib} contient :
+For example, if the \File{.bib} contains:
\begin{bodycode}[listing only,listing options={alsolanguage={[biblatex]TeX},deletekeywords={[2]series,geometry}}]
@Book{ har,
@@ -632,7 +627,7 @@ Par exemple, si le \File{.bib} contient :
}
\end{bodycode}
-alors, le source \file{.tex} suivant :
+then the following \file{.tex} source file:
\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
@@ -642,8 +637,8 @@ second assertion, see \textcite[Theorem~(0.4)]{shin}.
\printbibliography
\end{bodycode}
-donne le texte figurant dans l'encadré intitulé \enquote{Exemple de
- bibliographie} \vpageref{biblio}.
+provides the text appeating in the box entitled \enquote{An example
+ of a bibliography} \vpageref{biblio}.
\ExplSyntaxOn
\makeatletter
@@ -654,8 +649,7 @@ donne le texte figurant dans l'encadré intitulé \enquote{Exemple de
\ExplSyntaxOff
\renewcommand{\thempfootnote}{\arabic{mpfootnote}}
%
-\begin{bodycode}[text only,float,title={Exemple de bibliographie},label=biblio]
-\StandardFootnotes
+\begin{bodycode}[text only,float,title={An example of a bibliography},label=biblio]
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
@@ -666,39 +660,37 @@ vanishing\autocite[Theorem~4.3.1]{laz1}. For the second assertion, see
%
\renewcommand{\thempfootnote}{\alph{mpfootnote}}
-\section{Commandes propres aux mathématiques}
+\section{Mathematics-specific commands}
\label{sec:comm-propr-aux}
-La \nwejmauthorcl{} :
+The \nwejmauthorcl{}:
\begin{itemize}
-\item charge les packages :
+\item loads the following packages:
\begin{itemize}
- \item \package*{kpfonts} qui fournit tous les symboles standard, y compris
- ceux du \Package{amssymb}, mais en propose également de nombreux autres ;
- \item \package*{mathtools} qui lui-même charge \package*{amsmath} (mais en
- l'étendant et en corrigeant certains de ses défauts), si bien que toutes les
- commandes de ces deux packages sont disponibles ;
- \item \package*{rsfso} qui fournit de jolies lettres calligraphiques (via
- la commande \docAuxCommand{mathscr}) ;
+ \item \package*{kpfonts} which provides all the standards symbols,
+ including those in the \Package{amssymb}, but also offers many others;
+ \item \package*{mathtools} which itself loads \package*{amsmath}
+ (but extends it and fixes some flaws), so that all the commands of
+ both packages are available;
+ \item \package*{rsfso} which provides nice calligraphic letters (via
+ the \docAuxCommand{mathscr} command);
\end{itemize}
-\item redéfinit certaines commandes et en fournit quelques nouvelles, listées
- ci-dessous ;
-\item fournit (en s'appuyant sur les packages \package*{amsthm} et
- \package*{thmtools}) des environnements de type \enquote{théorème} classiques,
- listés ci-dessous.
+\item redefines some commands and provides some new ones, listed below;
+\item provides classical \enquote{theorem} environments (based on the
+ \package*{amsthm} and \package*{thmtools} packages), listed below.
\end{itemize}
-\subsection{Constantes universelles et fonctions courantes}
+\subsection{Universal constants and usual functions}
\begin{docCommand}{I}{}
- Cette commande affiche l'unité imaginaire : \enquote{$\I$}.
+ This command displays the imaginary unit: \enquote{$\I$}.
\end{docCommand}
\begin{docCommand}{E}{\oarg{argument}}
- Selon que son argument optionnel est utilisé ou pas, cette commande affiche :
+ Depending on its optional argument, this command displays:
\begin{itemize}
- \item la fonction exponentielle appliquée à l'\meta{argument} ;
- \item le nombre d'Euler \enquote{$\E$}.
+ \item The exponential function applied to \meta{argument};
+ \item The Euler number \enquote{$\E$}.
\end{itemize}
\end{docCommand}
@@ -709,71 +701,70 @@ La \nwejmauthorcl{} :
\end{align}
\end{bodycode}
-\begin{dbremark}{Syntaxes équivalentes pour la fonction exponentielle}{}
- Il y a équivalence entre les commandes :
+\begin{dbremark}{Equivalent syntaxes for the exponential function}{}
+ There is equivalence between:
\begin{itemize}
- \item |\E[|\meta{argument}|]| qui est fournie par la classe ;
- \item |\E^{|\meta{argument}|}| qui est plus habituelle.
+ \item ×\E[×\meta{argument}×]× which is provided by the class;
+ \item ×\E^{×\meta{argument}×}× which is more frequent.
\end{itemize}
\end{dbremark}
\begin{docCommand}{log(*)}{}
- Cette commande affiche, sous sa forme :
+ This command displays in its:
\begin{description}
- \item[\emph{non} étoilée :] \enquote{$\log$} ;
- \item[étoilée :] \enquote{$\log*$}.
+ \item[\emph{not} starred form:] \enquote{$\log$};
+ \item[starred form:] \enquote{$\log*$}.
\end{description}
\end{docCommand}
\begin{docCommand}{lg(*)}{}
- Cette commande affiche, sous sa forme :
+ This command displays in its:
\begin{description}
- \item[\emph{non} étoilée :] \enquote{$\lg$} ;
- \item[étoilée :] \enquote{$\lg*$}.
+ \item[\emph{not} starred form:] \enquote{$\lg$};
+ \item[starred form:] \enquote{$\lg*$}.
\end{description}
\end{docCommand}
-\subsection{Ensembles}
+\subsection{Sets}
-\subsubsection{Ensembles courants}
+\subsubsection{Usual sets}
\begin{docCommand}{bbN}{}
- Cette commande affiche l'ensemble des nombres entiers positifs :
+ This command displays the set of positive integers:
\enquote{$\bbN$}.
\end{docCommand}
\begin{docCommand}{bbZ}{}
- Cette commande affiche l'ensemble des nombres entiers relatifs :
+ This command displays the set of relative integers:
\enquote{$\bbZ$}.
\end{docCommand}
\begin{docCommand}{bbD}{}
- Cette commande affiche l'ensemble des nombres décimaux : \enquote{$\bbD$}.
+ This command displays the set of decimal numbers: \enquote{$\bbD$}.
\end{docCommand}
\begin{docCommand}{bbQ}{}
- Cette commande affiche l'ensemble des nombres rationnels : \enquote{$\bbQ$}.
+ This command displays the set of rational numbers: \enquote{$\bbQ$}.
\end{docCommand}
\begin{docCommand}{bbR}{}
- Cette commande affiche l'ensemble des nombres réels : \enquote{$\bbR$}.
+ This command displays the set of real numbers: \enquote{$\bbR$}.
\end{docCommand}
\begin{docCommand}{bbC}{}
- Cette commande affiche l'ensemble des nombres complexes : \enquote{$\bbC$}.
+ This command displays the set of complex numbers: \enquote{$\bbC$}.
\end{docCommand}
\begin{docCommand}{bbK}{}
- Cette commande peut être utilisée pour dénoter un corps quelconque. Elle
- affiche \enquote{$\bbK$}.
+ This command can be used to denote any field. It displays \enquote{$\bbK$}.
\end{docCommand}
-\subsubsection{Ensembles définis}
+\subsubsection{Defining sets}
-\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}.}.
+\begin{docCommand}[doc updated=2019-03-18]{set}{\marg{definition}\oarg{characterization}}
+ This command displays the set defined by \meta{definition}, with an
+ optional \meta{characterization}\footnote{The part after
+ \enquote{such that}.}.
\begin{bodycode}[listing and text]
\begin{align}
\bbN & = \set{0,1,2,3,\dots} \\
@@ -784,79 +775,82 @@ La \nwejmauthorcl{} :
\end{bodycode}
\end{docCommand}
-\subsection[Fonctions trigonométriques circulaires et hyperboliques]{Fonctions
- trigonométriques circulaires et hyperboliques, directes et réciproques}
+\subsection[Trigonometric and hyperbolic functions]{Trigonometric and
+ hyperbolic functions, direct and inverse}
-\begin{dbremark}{Commandes propres au français}{}
- Les commandes de cette section ne sont définies (ou redéfinies) que pour les
- articles en français.
+\begin{dbremark}{French-specific commands}{}
+ The commands in this section are only defined (or redefined) for articles in French.
\end{dbremark}
\begin{docCommand}{cot}{}
- Cette commande affiche la cotangente : \enquote{$\cot$}. Elle a pour alias
- \docAuxCommand{cotan}.
+ This command displays the cotangent function: \enquote{$\cot$}. Its
+ alias is \docAuxCommand{cotan}.
\end{docCommand}
\begin{docCommand}{arccos}{}
- Cette commande affiche (la détermination principale de) l'arc cosinus :
- \enquote{$\arccos$}.
+ This command displays (the principal value of) the arccosine function:
+ \enquote{\selectlanguage{French}$\arccos$}.
\end{docCommand}
\begin{docCommand}{arcsin}{}
- Cette commande affiche (la détermination principale de) l'arc sinus :
- \enquote{$\arcsin$}.
+ This command displays (the principal value of) the arcsine function:
+ \enquote{\selectlanguage{French}$\arcsin$}.
\end{docCommand}
\begin{docCommand}{arctan}{}
- Cette commande affiche (la détermination principale de) l'arc tangente :
- \enquote{$\arctan$}.
+ This command displays (the principal value of) the arctangent function:
+ \enquote{\selectlanguage{French}$\arctan$}.
\end{docCommand}
\begin{docCommand}{cosh}{}
- Cette commande affiche le cosinus hyperbolique : \enquote{$\cosh$}. Elle a pour
- alias \docAuxCommand{ch}.
+ This command displays the hyperbolic cosine function:
+ \enquote{\selectlanguage{French}$\cosh$}. Its alias is \docAuxCommand{ch}.
\end{docCommand}
\begin{docCommand}{sinh}{}
- Cette commande affiche le sinus hyperbolique : \enquote{$\sinh$}. Elle a pour
- alias \docAuxCommand{sh}.
+ This command displays the hyperbolic sine function:
+ \enquote{\selectlanguage{French}$\sinh$}. Its alias is \docAuxCommand{sh}.
\end{docCommand}
\begin{docCommand}{tanh}{}
- Cette commande affiche la tangente hyperbolique : \enquote{$\tanh$}.
- \begin{dbremark}{Pas de commande \protect\docAuxCommand{th} pour la tangente hyperbolique}{}
- La commande |\th| est déjà définie dans \LaTeX{} et ne peut donc pas être
- utilisée pour la tangente hyperbolique.
+ This command displays the hyperbolic tangent function:
+ \enquote{\selectlanguage{French}$\tanh$}.
+ \begin{dbremark}{No \protect\docAuxCommand{th} command for the hyperbolic tangent function}{}
+ The ×\th× command is already defined in \LaTeX{} and therefore
+ cannot be used for the hyperbolic tangent function.
\end{dbremark}
\end{docCommand}
\begin{docCommand}{arccosh}{}
- Cette commande affiche l'argument cosinus hyperbolique :
- \enquote{$\arccosh$}. Elle a pour alias \docAuxCommand{Argch}.
+ This command displays the inverse hyperbolic cosine function:
+ \enquote{\selectlanguage{French}$\arccosh$}.
+ Its alias is \docAuxCommand{Argch}.
\end{docCommand}
\begin{docCommand}{arcsinh}{}
- Cette commande affiche l'argument sinus hyperbolique :
- \enquote{$\arcsinh$}. Elle a pour alias \docAuxCommand{Argsh}.
+ This command displays the inverse hyperbolic sine function:
+ \enquote{\selectlanguage{French}$\arcsinh$}. Its alias is
+ \docAuxCommand{Argsh}.
\end{docCommand}
\begin{docCommand}{arctanh}{}
- Cette commande affiche l'argument tangente hyperbolique :
- \enquote{$\arctanh$}. Elle a pour alias \docAuxCommand{Argth}.
+ This command displays the inverse hyperbolic tangent function:
+ \enquote{\selectlanguage{French}$\arctanh$}. Its alias is
+ \docAuxCommand{Argth}.
\end{docCommand}
-\subsection{Paires de délimiteurs}
-\subsubsection{Commandes prédéfinies}
+\subsection{Pairs of delimiters}
+
+\subsubsection{Preset commands}
-La classe offre un certain nombre de commandes listées \vref{com-paired},
-facilitant la saisie de paires de délimiteurs courants, par exemple pour les
-normes, les valeurs absolues, etc.
+The class provides some commands listed in \vref{com-paired}, enabling
+the entry of delimiter pairs, e.g. for norms, absolute values, etc.
\begin{table}
\centering
\begin{tabular}{ll}
- Commandes & Exemple \\\toprule
+ Commands & Example \\\toprule
\docAuxCommand{norm} & $\norm{\cdot}$ \\\midrule
\docAuxCommand{lnorm} & $\lnorm{\cdot}$ \\\midrule
\docAuxCommand{llnorm} & $\llnorm{\cdot}$ \\\midrule
@@ -869,36 +863,35 @@ normes, les valeurs absolues, etc.
\docAuxCommand{leqgeq} & $\leqgeq{\cdot}$ \\\midrule
\docAuxCommand{lrangle} & $\lrangle{\cdot}$ \\\bottomrule
\end{tabular}
- \caption{Commandes facilitant la saisie de paires de
- délimiteurs courants}
+ \caption{Commands enabling
+the entry of usual delimiter pairs}
\label{com-paired}
\end{table}
-Ces commandes ayant toutes la même syntaxe, seule celle de la commande
-\docAuxCommand{norm} est détaillée.
+Since these commands all have the same syntax, only the
+\docAuxCommand{norm} command is detailed.
-\begin{docCommand*}{norm}{\oarg{paramètre de taille}\marg{argument}}
- Cette commande affiche la norme de l'\meta{argument}.
+\begin{docCommand*}{norm}{\oarg{parameter size}\marg{argument}}
+ This command displays the norm of \meta{argument}.
- Par défaut, la hauteur des délimiteurs est automatiquement adaptée à celle de
- l'\meta{argument} mais il est possible de spécifier en argument optionnel un
- \meta{paramètre de taille} :
+ The default delimeters height is automatically adjusted to the
+ height of the \meta {argument} but it is possible to specify a
+ \meta{size parameter} as an optional argument:
\begin{itemize}
- \item \docValue{0} : taille par défaut du délimiteur\footnote{Taille du
- délimiteur en mode texte.} ;
- \item \docValue{1} ou \docAuxCommand{big} : taille du délimiteur plus grande
- que la précédente ;
- \item \docValue{2} ou \docAuxCommand{Big} : taille du délimiteur plus grande
- que la précédente ;
- \item \docValue{3} ou \docAuxCommand{bigg} : taille du délimiteur plus grande
- que la précédente ;
- \item \docValue{4} ou \docAuxCommand{Bigg} : taille du délimiteur plus grande
- que la précédente.
+ \item \docValue{0}: default delimiter size\footnote{Delimiter size in text mode.} ;
+ \item \docValue{1} or \docAuxCommand{big}: delimiter size larger
+ than the previous one;
+ \item \docValue{2} or \docAuxCommand{Big}: delimiter size larger
+ than the previous one;
+ \item \docValue{3} or \docAuxCommand{bigg}: delimiter size larger
+ than the previous one;
+ \item \docValue{4} or \docAuxCommand{Bigg}: delimiter size larger
+ than the previous one;
\end{itemize}
\end{docCommand*}
\begin{docCommand}{norm*}{\marg{argument}}
- Cette commande est équivalente à |\norm[0]{|\meta{argument}|}|.
+ This command is equivalent to ×\norm[0]{×\meta{argument}×}×.
\end{docCommand}
\begin{bodycode}[listing and text]
@@ -913,9 +906,9 @@ Ces commandes ayant toutes la même syntaxe, seule celle de la commande
\end{equation}
\end{bodycode}
-\begin{dbremark}{Indices des paires de délimiteurs qui n'en sont pas pourvues par défaut}{}
- Il est toujours possible d'ajouter manuellement un indice à une commande de
- paire de délimiteurs qui n'en est pas pourvue par défaut.
+\begin{dbremark}{Subscripts of delimiter pairs that do not have default ones}{}
+ It is always possible to manually add a subscript to a delimiter
+ pair command that does not have one by default.
\begin{bodycode}[listing and text]
\begin{equation}
\norm{\frac{A}{2}}_3
@@ -923,30 +916,25 @@ Ces commandes ayant toutes la même syntaxe, seule celle de la commande
\end{bodycode}
\end{dbremark}
-\subsubsection{Commandes à définir}
+e\subsubsection{Defining new commands}
-Il est possible de définir de nouvelles commandes facilitant la saisie de paires
-de délimiteurs au moyen de la commande \refCom{NewPairedDelimiter}.
+New commands that facilitate the entry of delimiter pairs can be
+defined by using the \refCom{NewPairedDelimiter} command.
%
-\begin{docCommand}{NewPairedDelimiter}{\marg{commande}\marg{options}}
- Cette commande définit une \meta{commande} similaire à la commande
- \docAuxCommand{norm} mais dont les délimiteurs gauche et droit et l'indice
- sont ceux spécifiés en \meta{options} au moyen des clés \refKey{left},
- \refKey{right} et \refKey{subscript}.
- \begin{docKey}{left}{=\meta{délimiteur}}{pas de valeur par défaut,
- initialement vide}
- Cette clé permet de spécifier le \meta{délimiteur} gauche de la \meta{commande} ainsi
- créée.
+\begin{docCommand}{NewPairedDelimiter}{\marg{command}\marg{options}}
+ This command defines a \meta{command} similar to the
+ \docAuxCommand{norm} command but with left and right delimiters and
+ subscript specified in \meta{options} by using the \refKey{left},
+ \refKey{right} and \refKey{subscript} keys.
+ \begin{docKey}{left}{=\meta{delimiter}}{no default value, initially empty}
+ This key is used to specify the left \meta{delimiter} of the created \meta{command}.
\end{docKey}
- \begin{docKey}{right}{=\meta{délimiteur}}{pas de valeur par défaut,
- initialement vide}
- Cette clé permet de spécifier le \meta{délimiteur} droit de la
- \meta{commande} ainsi créée.
+ \begin{docKey}{right}{=\meta{delimiter}}{no default value, initially empty}
+ This key is used to specify the right \meta{delimiter} of the created \meta{command}.
\end{docKey}
- \begin{docKey}{subscript}{=\meta{indice}}{pas de valeur par défaut,
- initialement vide}
- Cette clé permet de spécifier l'\meta{indice} de la \meta{commande} ainsi
- créée.
+ \begin{docKey}{subscript}{=\meta{subscript}}{no default value, initially empty}
+ This key is used to specify the \meta{subscript} of the
+ created \meta{command}.
\end{docKey}
\end{docCommand}
@@ -968,13 +956,13 @@ de délimiteurs au moyen de la commande \refCom{NewPairedDelimiter}.
\end{equation}
\end{bodycode}
-\subsection{Opérateurs}
+\subsection{Operators}
-\subsubsection{Opérateurs prédéfinis}
+\subsubsection{Preset operators}
\begin{docCommand}{dif}{}
- Cette commande affiche l'opérateur différentiel employé notamment dans les
- intégrales : \enquote{$\dif$}.
+ This command displays the \enquote{$\dif$} differential operator used in particular in
+ integrals.
\begin{bodycode}[listing and text]
\begin{equation}
\iiint_T f(x,y,z)\dif x \dif y \dif z=0
@@ -983,26 +971,25 @@ de délimiteurs au moyen de la commande \refCom{NewPairedDelimiter}.
\end{docCommand}
\begin{docCommand}{grad}{}
- Cette commande affiche le gradient :
+ This command displays the gradient:
\begin{itemize}
- \item sous la forme \enquote{$\grad$} par défaut ;
- \item sous la forme \enquote{$\nabla$} si la valeur \docValue{nabla} est
- passée à la clé \refKey{gradient} en argument de la commande
- \refCom{articlesetup}.
+ \item in the \enquote{$\grad$} form by default;
+ \item in the \enquote{$\nabla$} form if the \docValue{nabla} value
+ is put in the \refKey{gradient} key in argument of \refCom{articlesetup} command.
\end{itemize}
\end{docCommand}
\begin{docCommand}{Div}{}
- Cette commande affiche la divergence : \enquote{$\Div$}.
- \begin{dbremark}{Pas de commande \protect\docAuxCommand{div} pour la divergence}{}
- La commande |\div| est déjà définie dans \LaTeX{} et ne peut donc pas être
- utilisée pour la divergence.
+ This command displays the divergence operator: \enquote{$\Div$}.
+ \begin{dbremark}{No command \protect\docAuxCommand{div} for divergence}{}
+ The ×\div× command is already defined in \LaTeX{} and therefore
+ cannot be used for divergence.
\end{dbremark}
\end{docCommand}
\begin{docCommand}{curl}{}
- Cette commande affiche le rotationnel :
- \enquote{$\curl$}. Elle a pour alias \docAuxCommand{rot}.
+ This command displays the rotational operator:
+ \enquote{$\curl$}. Its alias is \docAuxCommand{rot}.
\end{docCommand}
\begin{bodycode}[listing and text]
@@ -1013,18 +1000,17 @@ de délimiteurs au moyen de la commande \refCom{NewPairedDelimiter}.
\end{bodycode}
\begin{docCommand}{supp}{}
- Cette commande affiche le support (d'une fonction, d'une mesure, etc.) :
+ This command displays the support (of a function, of a measure, etc.):
\enquote{$\supp$}.
\end{docCommand}
-\subsubsection{Opérateurs à définir}
+\subsubsection{Defining new operators}
-Il est possible de définir de nouveaux noms d'opérateurs au moyen de la commande
-usuelle \refCom{DeclareMathOperator}.
+New operators can be defined by using the usual \refCom{DeclareMathOperator} command.
-\begin{docCommand}{DeclareMathOperator}{\marg{commande}\marg{nom}}
- Cette commande définit la \meta{commande} qui affiche l'opérateur nommé
- \meta{nom}.
+\begin{docCommand}{DeclareMathOperator}{\marg{command}\marg{name}}
+ This command defines the \meta{command} displaying the operator
+ named \meta{name}.
\end{docCommand}
\begin{preamblecode}
@@ -1034,22 +1020,21 @@ usuelle \refCom{DeclareMathOperator}.
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
- courantes}
+\subsubsection{(Advanced use) Precautions for unusual binary operations}
-Si, dans des opérations binaires, un opérateur\footnote{Prédéfini ou défini au
- moyen de la commande \protect\refCom{DeclareMathOperator}.} est suivi par un
-opérateur binaire courant de \LaTeX{} (\docAuxCommand{circ},
-\docAuxCommand{cdot}, \docAuxCommand{wedge}, etc.), les espaces horizontales les
-séparant seront correctes.
+If, in binary operations, an operator\footnote{Preset or defined with
+ the \protect\refCom{DeclareMathOperator} command.} is followed by a
+usual binary \LaTeX{} operator (\docAuxCommand{circ},
+\docAuxCommand{cdot}, \docAuxCommand{wedge}, etc.), the horizontal
+spaces between them will be correct.
-En revanche, si l'opérateur binaire impliqué n'est pas courant, il convient de
-le déclarer au moyen de la commande \refCom{BinaryOperators}.
+However, if the binary operator is not common, it should be declared by
+using the \refCom{BinaryOperators} command.
-\begin{docCommand}{BinaryOperators}{\marg{opérateurs binaires}}
- Cette commande assure que les \meta{opérateurs binaires}\footnote{Séparés par
- des virgules.} seront, dans des opérations binaires, correctement espacés
- des opérateurs les précédant.
+\begin{docCommand}{BinaryOperators}{\marg{binary operators}}
+ This command ensures that the \meta{binary operators}\footnote{Separated
+ by commas.} will, in binary operations, properly space from the
+ preceding operators.
\end{docCommand}
\begin{preamblecode}[listing options={moretexcs={mybinop}}]
@@ -1057,47 +1042,47 @@ le déclarer au moyen de la commande \refCom{BinaryOperators}.
\end{preamblecode}
\begin{bodycode}[listing and text,listing options={moretexcs={mybinop}}]
\begin{tabular}{>{$}l<{$}@{ : }l}
- \grad \cdot F & bon \\
- \grad \mybinop F & mauvais \\ \BinaryOperators{\mybinop}%
- \grad \mybinop F & bon (grâce à \verb|\BinaryOperators{\mybinop}|)
+ \grad \cdot F & good \\
+ \grad \mybinop F & bad \\ \BinaryOperators{\mybinop}%
+ \grad \mybinop F & good (thanks to \verb+\BinaryOperators{\mybinop}+)
\end{tabular}
\end{bodycode}
-\subsection{Divers}
+\subsection{Miscellaneous}
-\begin{dbremark}{Commandes propres au français (bis)}{}
- Les commandes suivantes ne sont redéfinies que pour les articles en
- français.
+\begin{dbremark}{French-specific commands (bis)}{}
+ The following commands are only redefined for French articles.
\end{dbremark}
\begin{docCommand}{leq}{}
- Cette commande affiche \enquote{$\leq$}.
+ This command displays \enquote{\selectlanguage{French}$\leqslant$}.
\end{docCommand}
\begin{docCommand}{geq}{}
- Cette commande affiche \enquote{$\geq$}.
+ This command displays \enquote{\selectlanguage{French}$\geqslant$}.
\end{docCommand}
-\subsection{Environnements de type \enquote{théorème}}
+\subsection{\enquote{Theorem} environments}
-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}).
+To easily compose theorems and similar objects, the
+\nwejmauthorcl{} provides ready-to-use environments and allows to
+create new ones if needed (cf. \refCom{newtheorem} command).
-\subsubsection{Environnements prédéfinis}
+\subsubsection{Preset environments}
\label{sec:envir-de-type}
-La \vref{env-theorems} liste les théorèmes et objets analogues prédéfinis par la
-\nwejmauthorcl{} avec :
+\vref{env-theorems} on the next page lists theorems and similar
+objects predefined by the
+\nwejmauthorcl{} with:
\begin{description}
-\item[en colonne~1] le nom des environnements correspondants ;
-\item[en colonne~2] leurs titres récurrents (automatiquement traduits dans la
- langue de l'article).
+\item[in column~1] The names of the corresponding environments;
+\item[in column~2] Their recurring titles (automatically translated into
+ the article language).
\end{description}
\begin{table}
\centering
\begin{tabular}{ll}
- Environnement & Titre (ici en français) \\\toprule
+ Environment & Title (here in French) \\\toprule
\docAuxEnvironment{theorem} & Théorème \\\midrule
\docAuxEnvironment{corollary} & Corollaire \\\midrule
\docAuxEnvironment{conjecture} & Conjecture \\\midrule
@@ -1106,169 +1091,175 @@ La \vref{env-theorems} liste les théorèmes et objets analogues prédéfinis pa
\docAuxEnvironment{axiom} & Axiome \\\midrule[.75pt]
\docAuxEnvironment{definition} & Définition \\\midrule
\docAuxEnvironment{remark} & Remarque \\\midrule
- \docAuxEnvironment{example} & Exemple \\\midrule
+ \docAuxEnvironment{example} & Example \\\midrule
\docAuxEnvironment{notation} & Notation \\\midrule[.75pt]
\docAuxEnvironment{proof} & Preuve \\\bottomrule
\end{tabular}
- \caption{Environnements de type \enquote{théorème} fournis}
+ \caption{\enquote{theorem}-like environments}
\label{env-theorems}
\end{table}
-\begin{dbremark}{\enquote{Théorèmes} non numérotés}{}
- Chacun des environnements de la \vref{env-theorems} admet une version étoilée
- créant une version non numérotée de l'objet de type \enquote{théorème}
- correspondant.
+\begin{dbremark}{Unnumbered \enquote{theorem}}{}
+ Each environment in \vref{env-theorems} has a starred version
+ that creates an unnumbered version of a \enquote{theorem}-like
+ object.
\end{dbremark}
\begin{bodycode}[listing and text]
\begin{theorem}
- Tout espace métrisable séquentiellement compact est compact.
+ Every metrizable and sequentially compact space is compact.
\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$.
+ Let $n$ be an integer greater than or equal to $2$. Two integers $a$ and $b$
+ are said to be congruent modulo $n$ if $a - b \in n\bbZ$.
\end{definition}
\begin{remark*}
- Une des plus belles relations mathématiques est $\E[i\pi]+1=0$.
+ One of the most beautiful mathematical relationships is $\E[i\pi]+1=0$.
\end{remark*}
\begin{proof}
- Tout ce qui est rare est cher. Or un cheval bon marché est rare.
- Donc un cheval bon marché est cher.
+ Everything that is rare is expensive. A cheap horse is rare.
+ So a cheap horse is expensive.
\end{proof}
\end{bodycode}
-On remarque dans l'exemple précédent que les \enquote{théorèmes} ont des mises
-en forme variables. La \nwejmauthorcl{} fournit effectivement trois styles de
-\enquote{théorèmes}, \docValue{theorem}, \docValue{definition} et
-\docValue{proof}, dont les caractéristiques sont indiquées à la
+In the previous example, the \enquote{theorems} have different
+formattings. The \nwejmauthorcl{} provides three \enquote{theorem}
+styles, \docValue{theorem}, \docValue{definition} and
+\docValue{proof}, see their characteristics in
\vref{env-theorems-styles}.
\begin{table}
\centering
% \setlength{\tymin}{\widthof{romain, terminé}}
\begin{tabulary}{\linewidth}{lLLL}
-Style & Titre récurrent & Contenu & \enquote{Théorèmes} concernés \\\toprule
-\docValue{theorem} & gras, romain, numéroté & italique
- & théorèmes, corollaires, conjectures, propositions, lemmes, axiomes \\\midrule
-\docValue{definition} & gras, romain, numéroté & romain & définitions, remarques, exemples, notations \\\midrule
-\docValue{proof} & non gras, italique, non numéroté & romain, terminé par un carré blanc & preuves \\\bottomrule
+ Style & Recurrent title & Content
+ & Relevant \enquote{theorems} \\\toprule
+ \docValue{theorem} & bold, roman, numbered & italic
+ & theorems, corollaries, conjectures, propositions, lemmas, axioms \\\midrule
+ \docValue{definition} & bold, roman, numbered & roman & definitions, remarks, examples, notations \\\midrule
+ \docValue{proof} & non bold, italic, non numbered & roman,
+ ended
+ with a
+ white square & proofs \\\bottomrule
\end{tabulary}
- \caption{Styles de \enquote{théorèmes} fournis}
+ \caption{Provided \enquote{theorems} styles}
\label{env-theorems-styles}
\end{table}
-\subsubsection{Environnements définis par l'utilisateur}
+\subsubsection{User-defined environments}
\label{sec:envir-de-type-1}
-Si les environnements de \enquote{théorème} fournis par la classe ne suffisent
-pas, la commande \refCom{newtheorem} permet d'en créer de nouveaux.
+If the \enquote{theorem} environments provided by the class are not
+enough, the \refCom{newtheorem} command can create new ones.
-\begin{docCommand}{newtheorem}{\oarg{option(s)}\marg{nom}}
- Cette commande crée un nouvel environnement \LaTeX{}, \meta{nom}, destiné à la
- composition d'un \enquote{théorème} dont, par défaut :
+\begin{docCommand}{newtheorem}{\oarg{option(s)}\marg{name}}
+ This command creates a new \LaTeX{} environment, \meta{name}, which
+ has by default:
\begin{itemize}
- \item le titre récurrent est \meta{Nom}\footnote{\Ie*{}, quelle que soit la
- langue de l'article, le \meta{nom} de l'environnement \LaTeX{} dont
- l'initiale est en majuscule.} ;
- \item le style est \docValue{theorem}.
+ \item \meta{Name}\footnote{\Ie*{}, regardless of the article
+ language, the \meta{name} of the \LaTeX{} environment with a
+ capital initial letter.} as recurring title;
+ \item \docValue{theorem} as a style.
\end{itemize}
- Cette commande crée également l'environnement étoilé \meta{nom}|*| produisant
- des occurrences \emph{non} numérotées de ce \enquote{théorème}.
+ This command also creates the starry environment \meta{name}×*×
+ which produce unnumbered occurrences of this \enquote{theorem}.
+ \end{docCommand}
\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 [...]
+\begin{article*}[Establishment of the Union]
+Reflecting the will of the citizens and States of Europe to build a
+common future, this Constitution establishes the European Union [...]
\end{article*}
-\begin{article}[dit premier]\label{premier}
-Les hommes naissent et demeurent libres et égaux en droits [...]
+\begin{article}[Establishment of the Union]\label{premier}
+Reflecting the will of the citizens and States of Europe to build a
+common future, this Constitution establishes the European Union [...]
\end{article}
-L'\vref{premier} est le plus célèbre.
+\vref{premier} is fundamental.
\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}.
+ If the default value of the style (\docValue{theorem}) is not
+ suitable, you can specify in \meta{option(s)} the desired one with
+ the following \refKey{style} key.
+ \begin{docKey}{style}{=\docValue{theorem}\textbar\docValue{definition}\textbar\docValue{proof}}{
+ no default value,\\initially \docValue{theorem}}
+ This key allows you to specify the style of the \enquote{theorem}
+ to be created, using \docValue{theorem}, \docValue{definition} and
+ \docValue{proof} values.
\end{docKey}
\begin{preamblecode}
-\newtheorem[style=definition]{fait}
+\newtheorem[style=definition]{fact}
\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.
+\begin{fact}\label{major}
+Everything that is rare is expensive.
+\end{fact}
+\begin{fact}\label{minor}
+A cheap horse is rare.
+\end{fact}
+According to \cref{minor,major}, a cheap horse is expensive.
\end{bodycode}
- 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.
+ If the default value of the recurring title (\meta{Name}) is not
+ suitable, you can specify in \meta{option(s)} the desired one with
+ the following \refKey{title} key.
+ \begin{docKey}{title}{={\meta{recurring title}}}{no default value,
+ initially empty}
+ This key allows you to specify a \meta{recurring title} different from
+ \meta{Name}, regardless of the article language.
\end{docKey}
\begin{preamblecode}
-\newtheorem[title=expérience]{experience}
+\newtheorem[title=experience]{experience}
\end{preamblecode}
\begin{bodycode}[listing and text,listing options={deletekeywords={[2]label}}]
-\begin{experience}\label{un}
-On lance un dé à 6 faces [...]
+\begin{experience}\label{one}
+A 6-sided dice is rolled [...]
\end{experience}
-\begin{experience}\label{deux}
-On lance deux dés à 6 faces [...]
+\begin{experience}\label{two}
+Two 6-sided dice are rolled [...]
\end{experience}
-Les \vref{un,deux} mettent en évidence [...]
+The \vref{one,two} highlight [...]
\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.
+ Note that, in the case of cross-references using the \refCom{vref}\footnote{Cf. \vref{sec-references-croisees}}(or
+ \refCom{cref}) command, the recurring title of the referenced
+ \enquote{theorem(s)} is automatically added to the reference,
+ possibly on its plural form. By default, this latter is obtained by
+ adding a final \enquote{s} in \meta{name} or in \meta{recurring
+ title} set in the title option. If this form should be constructed
+ differently, this should be specified in \meta{option(s)} using the
+ following \refKey{title-plural} key.
+
+ \begin{docKey}{title-plural}{={\meta{plural form of the recurring
+ title}}}{no default \\value, initially empty}
+ This key is used to specify the plural form of the recurring title.
\end{docKey}
\begin{preamblecode}
-\newtheorem[title-plural=anneaux]{anneau}
+\newtheorem[title-plural=rings]{ring}
\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 [...]
+\begin{ring}\label{ring}
+Consider a ring: [...]
+\end{ring}
+\begin{ring}\label{ring-bis}
+Consider another ring: [...]
+\end{ring}
+The \vref{ring,ring-bis} admit [...]
\end{bodycode}
\begin{preamblecode}
-\newtheorem[title=idéal,title-plural=idéaux]{ideal}
+\newtheorem[title=ideal,title-plural=ideals]{ideal}
\end{preamblecode}
\begin{bodycode}[listing and text,listing options={deletekeywords={[2]label}}]
\begin{ideal}\label{ideal}
-Considérons un idéal : [...]
+Consider an ideal: [...]
\end{ideal}
\begin{ideal}\label{ideal-bis}
-Considérons un autre idéal : [...]
+Consider another ideal: [...]
\end{ideal}
-Les \vref{ideal,ideal-bis} admettent [...]
+The \vref{ideal,ideal-bis} admit [...]
\end{bodycode}
% Si besoin est, il est même possible de spécifier des titres récurrents
@@ -1287,78 +1278,75 @@ Les \vref{ideal,ideal-bis} admettent [...]
% 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}
+%\end{docCommand}
-\subsection{Énumérations}
+\subsection{Enumerations}
\label{sec:list-dhyp-ou}
-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}).
+To make the composition of enumerations (of hypothesis, assertions,
+conditions, etc.) easier, the \nwejmauthorcl{} provides ready-to-use
+environments and allows to create new ones if needed (see the
+\refCom{newenumeration} command).
-\subsubsection{Énumérations prédéfinies}
+\subsubsection{Predefined enumerations}
\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}.
+In mathematical articles, it is common to enumerate assertions,
+hypothesis or conditions and to refer to these. To do this, the
+\nwejmauthorcl{} provides three environments: \refEnv{assertions},
+\refEnv{hypotheses} and \refEnv{conditions}. Each assertion,
+hypothesis or condition is introduced by the \docAuxCommand{item} command.
\begin{docEnvironment}[doclang/environment content=assertions]{assertions}{}
- Cet environnement compose une liste d'assertions.
+ This environment composes a list of assertions.
\end{docEnvironment}
-\begin{docEnvironment}[doclang/environment content=hypothèses]{hypotheses}{}
- Cet environnement compose une liste d'hypothèses.
+\begin{docEnvironment}[doclang/environment content=hypothesis]{hypotheses}{}
+ This environment composes a list of hypothesis
\end{docEnvironment}
\begin{docEnvironment}[doc new=2019-03-18,doclang/environment content=conditions]{conditions}{}
- Cet environnement compose une liste de conditions.
+ This environment composes a list of conditions.
\end{docEnvironment}
\begin{bodycode}[listing and text,listing options={deletekeywords={[2]label}}]
-\begin{axiom}\label{mon-axiome}
- Chaque assertion suivante est admise.
+\begin{axiom}\label{my-axiom}
+ Each of the following assertions are admitted.
\begin{assertions}
- \item\label{rare-cher} Tout ce qui est rare est cher.
- \item\label{cheval} Un cheval bon marché est rare.
+ \item\label{rare-expensive} Everything that is rare is expensive.
+ \item\label{horse}A cheap horse is rare.
\end{assertions}
\end{axiom}
-En vertu des \vref{rare-cher,cheval} de l'\vref{mon-axiome},
-un cheval bon marché est cher.
+According to the \vref{rare-expensive, horse} of \vref{my-axiom}, a
+cheap horse is expensive.
\end{bodycode}
-\subsubsection{Énumérations définies par l'utilisateur}
+\subsubsection{User-defined enumerations}
-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}.
+If the enumerations provided by the class are not enough, it is
+possible to create new ones via the \refCom{newenumeration} command.
-\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{docCommand}[doc new=2019-03-18]{newenumeration}{\oarg{option(s)}\marg{name}}
+ This command create a new \LaTeX{} environment , \meta{name}, which
+ is used as the usual \docAuxEnvironment{enumerate} environment of
+ ordered lists and in which each item is introduced by the
+ \docAuxCommand{item} command.
\begin{preamblecode}
\newenumeration{conventions}
\end{preamblecode}
\begin{bodycode}[listing and text]
\begin{conventions}
-\item Le cheval est bon marché.
-\item Le cheval est cher.
+\item The horse is cheap.
+\item The horse is expensive.
\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.
+We note that each listed item has a default label consisting of the
+initial of the \meta{name} indexed by an Arabic numeral, all in
+parentheses. If this label is not suitable, we can specify the desired
+one in the \meta{option(s)} with the \refKey{label} key.
+ \begin{docKey}{label}{={\meta{label}}}{no default value, initially initial of \meta{name}}
+ This key is used to specify a \meta{label} different from the
+ initial of the environment \meta{name}.
\end{docKey}
\renewenumeration[label=K]{conventions}
\begin{preamblecode}
@@ -1366,205 +1354,206 @@ d'en créer de nouvelles au moyen de la commande \refCom{newenumeration}.
\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.
+\item\label{k-one} The horse is cheap.
+\item\label{k-two} The horse is expensive.
\end{conventions}
-Cf. \vref{k-one}. Cf. \vref{k-one,k-two}.
+See \vref{k-one}. See \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 :
+Note that when cross-referencing using the \refCom{vref} (or
+\refCom{cref}) command\footnote{See \vref{sec-references-croisees}},
+the \meta{name} of the referenced enumerations is automatically added
+to the reference, in its singular or plural form as appropriate. By default,
\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}.
+\item[The plural form] is the \meta{name} ;
+\item[The singular form] is obtained by deleting the last
+ letter\footnote{Supposed to be an \enquote{s}.} of the \meta{name}.
\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.
+
+
+If these singular or plural forms must be built differently, they
+should be specified in the \meta{option(s)} via
+the following \refKey{singular} and \refKey{plural} keys.
+ \begin{docKey}{singular}{={\meta{singular form of the
+ enumeration}}}{no default value,\\initially empty}
+ This key is used to specify the singular form of the enumeration.
\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.
+ \begin{docKey}{plural}{={\meta{plural form of the
+ enumeration}}}{no default value,\\initially empty}
+ This key is used to specify the plural form of the enumeration.
\end{docKey}
\begin{preamblecode}
-\newenumeration[singular=cas]{cas} % Sinon, forme sing. = « ca ».
+\newenumeration[singular=criterion]{criteria} % Otherwise, sing. form = “criteri”.
\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}.
+\begin{criteria}
+\item\label{criterion-one} The horse is cheap.
+\item\label{criterion-two} The horse is expensive.
+\end{criteria}
+See \vref{criterion-one}. See \vref{criterion-one,criterion-two}.
\end{bodycode}
\begin{preamblecode}
-\newenumeration[singular=règle,plural=règles]{regles}
+\newenumeration[singular=rôle,plural=rôles]{roles}
\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}.
+\begin{roles}
+\item\label{role-one} The horse is cheap.
+\item\label{role-two} The horse is expensive.
+\end{roles}
+Cf. \vref{role-one}. Cf. \vref{role-one,role-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}.
+If necessary, the \refCom{renewenumeration} command can be used to
+redefine an enumeration previously defined with the
+\refCom{newenumeration} command.
-\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}.
+\begin{docCommand}[doc new=2019-03-18]{renewenumeration}{\oarg{option(s)}\marg{name}}
+ This command redefines the enumeration environment \meta{name}. Its
+ \meta{option(s)} are the same as those of the
+ \refCom{newenumeration} command.
\end{docCommand}
-\section{Commandes généralistes}
+\section{Generalist commands}
\label{sec:comm-gener}
-En plus des commandes propres aux mathématiques, la \nwejmauthorcl{} fournit des
-commandes généralistes destinées à faciliter la saisie d'un article à paraître
-dans la \nwejm{}.
+In addition to math-specific commands, the \nwejmauthorcl{} provides
+generalist commands to make easier the input of an article to be
+published in \nwejm{}.
+
\begin{docCommand}{ie(*)}{}
- Cette commande affiche l'expression \enquote{\ie*{}} traduite dans la langue
- de l'article, sous sa forme :
+ This command displays the phrase \enquote{\ie*{}} translated into
+ the language of the article, in the form:
\begin{description}
- \item[\emph{non} étoilée :] en version abrégée \enquote{\ie{}} ;
- \item[étoilée :] en version \emph{non} abrégée \enquote{\ie*{}}.
+ \item[\emph{non} starred:] abbreviated to \enquote{\ie{}} ;
+ \item[starred:] in unabbreviated form \enquote{\ie*{}}.
\end{description}
\end{docCommand}
\begin{docCommand}{Ie(*)}{}
- Cette commande affiche l'expression \enquote{\Ie*{}} traduite dans la langue
- de l'article, sous sa forme :
+ This command displays the phrase \enquote{\Ie*{}} translated into
+ the language of the article, in the form:
\begin{description}
- \item[\emph{non} étoilée :] en version abrégée \enquote{\Ie{}} ;
- \item[étoilée :] en version \emph{non} abrégée \enquote{\Ie*{}}.
+ \item[\emph{non} starred:] abbreviated to \enquote{\Ie{}} ;
+ \item[starred:] in unabbreviated form \enquote{\Ie*{}}.
\end{description}
\end{docCommand}
-\begin{docCommand}{century(*)}{\marg{numéro}}
- Cette commande affiche l'ordinal du \meta{numéro}\footnote{Ce numéro doit être
- un nombre entier non nul, le cas échéant négatif.}\footnote{En français et en
- allemand, \meta{numéro} est composé en chiffre romain et en petites
- capitales.} d'un siècle, suivi du mot \enquote{siècle} traduit dans la
- langue de l'article et de la mention éventuelle qu'il s'agit d'un siècle
- précédant notre ère. Ainsi :
+\begin{docCommand}{century(*)}{\marg{number}}
+ This command displays the ordinal of the \meta{number}\footnote{This
+ number must be a non-zero integer, negative if
+ appropriate.}\footnote{In French and German, \meta{number} is
+ written in Roman numerals and small capitals.} of a century,
+ followed by the word \enquote{century} translated into the article language
+ and by the possible mention that it is a century before our era. Thus:
\begin{bodycode}[listing and text]
-Au \century{-1}, [...]. Plus tard, au \century{8}, [...]
+In the \century{-1}, [...]. Later, in the \century{8}, [...]
\end{bodycode}
- Sa version étoilée n'affiche que l'ordinal (sauf si le \meta{numéro} est
- négatif). Ainsi :
+ The starred version displays only the ordinal (unless the \meta{number} is
+ negative). Thus:
\begin{bodycode}[listing and text]
-L'agriculture au \century*{-1} était [...].
-La poésie du \century*{19} aura marqué [...].
+Agriculture in the \century*{-1} was [...].
+The poetry of the \century*{19} has profoundly marked [...].
\end{bodycode}
\end{docCommand}
-\begin{docCommand}{aside(*)}{\marg{texte}}
- Cette commande permet de composer du \meta{texte} entre tirets longs, pour une
- \enquote{incise} (un peu à la manière de parenthèses).
+\begin{docCommand}{aside(*)}{\marg{text}}
+ This command allows you to compose \meta{text} between long dashes.
\begin{description}
- \item[Sous sa forme non étoilée,] elle insère le \meta{texte} entre deux
- tirets longs.
- \item[Sous sa forme étoilée,] elle fait (seulement) précéder le \meta{texte}
- d'un tiret, ce qui est à utiliser en fin de phrase.
+ \item[In the non starred form,] it inserts the \meta{text} between
+ two long dashes.
+ \item[In the starred form,] the \meta{text} is simply preceded by a
+ dash. This is to be used at the end of a sentence.
\end{description}
- Ainsi :
-\begin{bodycode}[listing and text]
-Des expériences \aside{dans le monde \enquote{réel}} ont même été
-suscitées par des expériences numériques.
+ Thus :
+ \begin{bodycode}[listing and text]
+Experiences \aside{in the \enquote{real} word} have been triggered by digital experiences.
\end{bodycode}
- et :
-\begin{bodycode}[listing and text,listing options={deletekeywords={exemple}}]
-On soupçonne que non \aside*{par exemple on s'attend à ce que
- $1/\pi$ ne soit pas une période}.
+ and:
+\begin{bodycode}[listing and text,listing options={deletekeywords={example}}]
+It is suspected not \aside*{for example it is expected that $1/\pi$ is not a period}.
\end{bodycode}
\end{docCommand}
\begin{docCommand}{nwejm}{}
- Cette commande affiche, sous sa forme :
+ This command displays:
\begin{description}
- \item[\emph{non} étoilée :] la version abrégée \enquote{\nwejm{}} ;
- \item[étoilée :] la version \emph{non} abrégée \enquote{\nwejm*{}}.
+ \item[In the \emph{non} starred form:] the abbreviated version \enquote{\nwejm{}};
+ \item[In the starred form:] the \emph{non} abbreviated version \enquote{\nwejm*{}}.
\end{description}
\end{docCommand}
-\section{Sélection d'outils fournis par des packages tiers}
+\section{Selection of tools from third party packages}
-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.}.
+This section lists some tools (commands and environments) provided by
+packages automatically loaded by the
+\nwejmauthorcl\footnote{L'\vref{sec-packages-charges-ou-pas} lists
+ those whose features may be useful for authors.}.
-\begin{dbwarning}{Liste des fonctionnalités des packages tiers non exhaustive}{}
- Cette liste est \emph{non exhaustive} :
+\begin{dbwarning}{Non-exhaustive list of features from third party packages}{}
+ This lists is \emph{non exhaustive}:
\begin{itemize}
- \item seule une infime partie des packages existants est chargée par la
- classe ;
- \item seuls certains packages chargés par la classe sont cités ;
- \item seules certaines fonctionnalités des packages cités sont décrites. Le
- lecteur souhaitant en savoir davantage est invité à lire la documentation de
- ces packages.
+ \item Only a tiny fraction of the existing packages are loaded by
+ the class;
+ \item Only some of the packages loaded by the class are mentioned;
+ \item Only some features of the mentioned packages are
+ described. More information is available in the documentation of
+ these packages.
\end{itemize}
\end{dbwarning}
-\subsection{Références croisées}
+\subsection{Cross-referencing}
\label{sec-references-croisees}
-\DeclareFixedFootnote{\objets}{Section, équation, théorème, figure, tableau,
- etc.}
+\DeclareFixedFootnote{\objets}{Section, equation, theorem, figure,
+ array, 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.
+The \Package*{cleveref} package makes cross-referencing powerful. In
+particular, it provides the following commands \refCom{cref} and \refCom{vref}.
\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} :
+ If one or more objects\objets{} are labelled with
+ \lstinline[deletekeywords={[2]label}]×\label{×\meta{label$_1$}×}×,...,
+ \lstinline[deletekeywords={[2]label}]×\label{×\meta{label$_n$}×}×, the command
+ \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.}.
+ \item displays their numbers\footnote{Surrounded by brackets where
+ customary, e.g. for equations.};
+ \item detects their nature\objets{} and displays the corresponding
+ keywords\footnote{Feature provided by the \Package{cleveref}
+ package.} before their numbers, automatically translated into
+ the article language\footnote{Feature
+ provided by the \nwejmauthorcl.}.
\end{itemize}
%
\begin{bodycode}[listing and text]
-On se reportera aux \cref{sec-titre,sec-auteurs} [...]
+Please refer to \cref{sec-title,sec-authors} [...]
\end{bodycode}
\end{docCommand}
\begin{docCommand}{vref}{\brackets{\meta{label$_1$},...,\meta{label$_n$}}}
- Cette commande :
+ This command:
\begin{itemize}
- \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}.}.
+ \item includes the features of \refCom{cref};
+ \item displays\footnote{Or not, depending on the context.} the
+ (numbers of the) pages where they are located\footnote{Feature
+ provided by the \Package{varioref}.} after the numbers of
+ the referenced objects.
\end{itemize}
%
\begin{bodycode}[listing and text]
-On se reportera aux \vref{sec-titre,sec-auteurs} [...]
+Please refer to \vref{sec-title,sec-authors} [...]
\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}.}.
+\begin{dbremark}{Hyperlinks to a referenced object}{}
+ The numbers and possible \aside{numbers of} pages of the
+ cross-references created with \refCom{cref} and \refCom{vref}
+ are hyperlinks to referenced objects\footnote{Feature provided by the \Package{hyperref}.}.
\end{dbremark}
% \begin{dbremark}{\docAuxCommand{ref} et \docAuxCommand{eqref} : clones de \protect\refCom{vref}}{}
@@ -1579,9 +1568,9 @@ On se reportera aux \vref{sec-titre,sec-auteurs} [...]
% Le lecteur, rompu à la composition de formules de mathématiques, connaît
% certainement le \Package*{amsmath} et les environnements qu'il fournit :
% \begin{itemize}
-% \item |equation|, |align|, |gather|, |multline| et |flalign| qui numérotent
+% \item ×equation×, ×align×, ×gather×, ×multline× et ×flalign× qui numérotent
% leur contenu ;
-% \item |equation*|, |align*|, |gather*|, |multline*| et |flalign*| qui \emph{ne}
+% \item ×equation*×, ×align*×, ×gather*×, ×multline*× et ×flalign*× qui \emph{ne}
% numérotent \emph{pas} leur contenu ;
% \end{itemize}
% et utilise les premiers si (et seulement si, théoriquement) les contenus
@@ -1620,42 +1609,40 @@ On se reportera aux \vref{sec-titre,sec-auteurs} [...]
% \end{equation}
% \end{bodycode}
-\subsection{Acronymes}
+\subsection{Acronyms}
\label{sec:acronymes}
-Il est fréquent que des acronymes doivent figurer dans un article de
-mathématiques et le \Package{glossaries} propose pour cela une fonctionnalité
-à la fois très efficace et très simple : il suffit de recourir à ses commandes :
+Acronyms often need to be used in mathematical articles. To this end,
+the \Package{glossaries} offers a very efficient and simple feature:
+just use the commands:
\begin{itemize}
-\item \refCom{newacronym} pour \emph{définir} un acronyme :
-\item \refCom{gls} (ou \refCom{acrshort}) pour \emph{afficher} un acronyme.
+\item \refCom{newacronym} to \emph{define} an acronym;
+\item \refCom{gls} (or \refCom{acrshort}) to \emph{display} an acronym.
\end{itemize}
-\begin{docCommand}{newacronym}{\marg{clé}\marg{forme courte}\marg{forme longue}}
- Cette commande, à utiliser de préférence en préambule, définit un acronyme
- où :
+\begin{docCommand}{newacronym}{\marg{key}\marg{short form}\marg{long form}}
+ This command, best used in the preamble, defines an acronym where:
\begin{enumerate}
- \item \meta{clé} identifie l'acronyme de manière unique dans le
- document\footnote{À l'auteur de veiller à ne pas utiliser deux fois la même
- clé pour identifier des acronymes distincts.} ;
- \item \meta{forme courte} est l'acronyme en lui-même ;
- \item \meta{forme longue} est la signification de l'acronyme.
+ \item \meta{key} identifies the acronym uniquely in the
+ document\footnote{The author should be careful not to use the same
+ key twice to identify different acronyms.};
+ \item \meta{short form} is the acronym itself;
+ \item \meta{long form} is the meaning of the acronym.
\end{enumerate}
-\begin{dbwarning}{Forme courte des acronymes : en bas de casse}{}
- La \meta{forme courte} d'un acronyme est à saisir exclusivement en bas de
- casse (en minuscules) car elle sera en fait composée en petites capitales.
+\begin{dbwarning}{Short form of acronyms: in lowercase}{}
+ The \meta{short form} of an acronym has to be entered exclusively
+ in lowercase since it will be actually composed in small capitals.
\end{dbwarning}
\end{docCommand}
-\begin{docCommand}{gls}{\marg{clé}}
- Cette commande affiche l'acronyme identifié par \marg{clé} selon le principe
- suivant :
+\begin{docCommand}{gls}{\marg{key}}
+ This command displays the acronym identified by \marg{key}
+ according to the following principle:
\begin{enumerate}
- \item la 1\iere{} occurrence de cette commande dans le document affiche
- l'acronyme sous sa forme \emph{complète}, \ie*{} sa \meta{forme longue}
- suivie de sa \meta{forme courte} entre parenthèses ;
- \item les occurrences suivantes affichent l'acronyme uniquement sous
- \meta{forme courte}.
+ \item The first occurrence of this command in the document displays
+ the acronym in its \emph{complete} form, \ie*{} its \meta{long
+ form} followed by its \meta{short form} in brackets;
+ \item The following ones display the acronym only in \meta{short form}.
\end{enumerate}
\end{docCommand}
@@ -1669,366 +1656,349 @@ mathématiques et le \Package{glossaries} propose pour cela une fonctionnalité
\end{enumerate}
\end{bodycode}
-\begin{docCommand}{acrshort}{\marg{clé}}
- Cette commande affiche la \meta{forme courte} (seule) de l'acronyme, quel que
- soit le contexte\footnote{\Ie*{} même si c'est la 1\iere{} fois que l'acronyme
- est utilisé dans le document.}.
+\begin{docCommand}{acrshort}{\marg{key}}
+ This command displays (only) the \meta{short form} of the acronym,
+ whatever the context\footnote{\Ie*{} even if it is the first time the acronym is used in the document.}.
\end{docCommand}
-\begin{dbremark}{Commande \refCom{acrshort} : utile dans un titre}{}
- La commande \refCom{acrshort} peut être utile notamment dans le titre d'un
- article où l'on ne souhaite pas que soit détaillée la forme complète d'un
- acronyme.
+\begin{dbremark}{The \refCom{acrshort} command: useful in a title}{}
+ The \refCom{acrshort} command can be useful in particular in the
+ article title where you do not want the full form of an acronym to
+ be detailed.
\end{dbremark}
-Le \Package*{glossaries} fournit bien d'autres commandes et offre bien d'autres
-fonctionnalités\autocite[Pour plus de détails, cf. par exemple][]{Bitouze7}.
+The \Package*{glossaries} provides many other commands and
+features\autocite[For more details, see for instance][]{Bitouze7}.
-\subsection{Guillemets, citations}
+\subsection{Quotes, citations}
\label{sec-guillemets-citations}
-Le \Package*{csquotes} est dédié aux citations, formelles et informelles,
-d'extraits de textes. Il propose notamment la commande \refCom{enquote}
-suivante, simple d'emploi.
+The \Package*{csquotes} is dedicated to formal and informal citations,
+and text excerpts. It includes the following easy-to-use \refCom{enquote}
+command.
-\begin{docCommand}{enquote}{\marg{texte}}
- Cette commande compose le \meta{texte} entre guillemets, automatiquement
- adaptés :
+\begin{docCommand}{enquote}{\marg{text}}
+ This command composes the \meta{text} in quotation marks, automatically
+ adapted to:
\begin{itemize}
- \item aux standards typographiques de la langue en cours. On pourra donc
- l'utiliser dès que du texte est à mettre entre guillemets ;
- \item au niveau (1 ou 2) de \enquote{citation} en cas d'emboîtement. On
- pourra donc également l'utiliser dès que du texte est à citer de façon
- informelle.
+ \item The typographic standards of the current language. It will
+ therefore be used whenever text is to be enclosed in quotes;
+ \item The level (1 or 2) of \enquote{citation} in case of
+ nesting. It can therefore be used whenever text is to be
+ informally quoted.
\end{itemize}
-\begin{bodycode}[listing and text,listing options={alsolanguage={[csquotes]TeX}}]
-Il lui répondit : \enquote{Courteline disait: \enquote{Passer
- pour un idiot aux yeux d'un imbécile est une volupté de fin
- gourmet.}}
+\begin{bodycode}[listing and text,listing
+ options={alsolanguage={[csquotes]TeX}}]
+he replied: \enquote{Courteline used to say: \enquote{To be taken for
+ an idiot in the eyes of an imbecile is the pleasure of a fine gourmet.}}
\end{bodycode}
\end{docCommand}
-\begin{docCommand}{blockcquote}{\marg{clé}\marg{extrait}}
- Cette commande permet de citer un \meta{extrait} de façon
- formelle\footnote{\Ie*{} avec précision de la source.}, la référence
- bibliographique correspondante devant figurer dans un des fichiers \file{.bib}
- ajoutés\footnote{Au moyen de la commande \docAuxCommand{addbibresource}} et
- y étant identifiée par la clé \meta{clé}.
+\begin{docCommand}{blockcquote}{\marg{key}\marg{excerpt}}
+ This command allows you to quote an \meta{excerpt}
+ formally\footnote{\Ie*{} with details of the source.}. The
+ corresponding bibliographic reference must be included in one of the
+ added \footnote{Using the \docAuxCommand{addbibresource} command} \file{.bib} files
+ and identified by the key \meta{key}.
\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 :
+\citeauthor{Bitouze} specifies that:
\blockcquote{Bitouze}{%
- \textins{Cette} commande compose les citations en détachant
- automatiquement du paragraphe courant celles qui sont
- longues\footnote{Par défaut, ce sont celles
- dépassant 3~lignes.}.%
+ \textins{This} command composes the citations by detaching
+ automatically from the current paragraph those which are
+ long.%
}.
\end{bodycode}
+% \footnote{By default, those exceeding 3~lines.}
\renewcommand{\thempfootnote}{\alph{mpfootnote}}
\end{docCommand}
-La commande \refCom{blockcquote} admet des arguments optionnels permettant
-d'ajouter du texte \meta{antérieur} et/ou \meta{postérieur} à la citation
-d'extrait\autocite[Pour plus de détails, cf. par exemple][]{Bitouze}.
+The \refCom{blockcquote} command has optional arguments allowing to
+add text \meta{prior} and/or \meta{subsequent} to the excerpt
+citation\autocite[For more details, see for instance][]{Bitouze}.
% (\textsc{À suivre...})
-\subsection{Adresses Web (\texorpdfstring{\acrshort{url}}{URL})}
+\subsection{Web addresses (\texorpdfstring{\acrshort{url}}{URL})}
\label{sec-url}
-Le \Package*{hyperref} fournit (entre autres) la commande \refCom{url} qui
-permet de facilement afficher des adresses Web, aussi appelées
-\enquote{\gls{url}}, même si elles comportent des caractères spéciaux de \TeX{}
-(|#|,
+The \Package*{hyperref} provides (among other things) the \refCom{url}
+command, which makes it easy the display of web adresses, also known
+as \enquote{\gls{url}}, even if they contain special \TeX{} characters (×#×,
%
\lstinline[commentstyle={}]+%+,
%
-|_|, |~|, |&|, etc.) : ces caractères peuvent donc être saisis tels quels, sauf
-si la commande \refCom{url} est utilisée dans l'argument d'une autre
-commande\footnote{Par exemple \protect\docAuxCommand*{footnote}.} auquel cas les
-caractères |#| et
+×_×, ×~×, ×&×, etc.): these characters can therefore be entered as
+they are, unless the \refCom{url} command is used in the argument of
+another command\footnote{For instance
+ \protect\docAuxCommand*{footnote}.}, in which case the ×#× and
%
\lstinline[commentstyle={}]+%+
%
-sont alors à faire précéder de la commande \enquote{d'échappement} |\|
-(contre-oblique).%
+characters must be preceded by the backslash command ×\×.
-\begin{docCommand}{url}{\marg{adresse Web}}
- Cette commande affiche l'\meta{adresse Web} saisie \emph{telle quelle} et fait
- d'elle un lien hypertexte.
+\begin{docCommand}{url}{\marg{Web address}}
+ This command displays the \meta{Web address} entered \emph{as is}
+ and makes it a hypertext link.
\begin{bodycode}[listing and text,listing options={alsolanguage={[hyperref]TeX},deletekeywords={[2]url}}]
-Nous renvoyons aux instructions aux auteurs sur notre site Web
+We refer to the instructions to authors on our website
\url{http://math.univ-lille1.fr/~nwejm/#Authors}.
\end{bodycode}
\end{docCommand}
-\subsection{Listes en ligne}
+\subsection{Lists within paragraphs}
\label{sec:listes-en-ligne}
-Le lecteur est certainement familier des environnements
-\docAuxEnvironment{itemize}, \docAuxEnvironment{enumerate} et
-\docAuxEnvironment{description} permettant de créer des listes respectivement
-non ordonnées\footnote{\enquote{À puces}.}, ordonnées\footnote{\Ie*{}
- numérotées} et \enquote{de description}. Le \Package*{enumitem} fournit des
-versions étoilées de ces environnements qui composent ces listes \enquote{en
- ligne}, c'est-à-dire au sein d'un même paragraphe\footnote{Le but premier de
- ce package est de personnaliser les listes mais cela est déconseillé dans le
- cadre du \nwejm{} car cela pourrait contrevenir à la marche typographique
- qu'il a adoptée.}.
-
-\begin{docEnvironment}[doclang/environment content=liste]{itemize*}{}
- Cet environnement compose une liste \enquote{à puces} en ligne.
+The reader is certainly familiar with the \docAuxEnvironment{itemize}, \docAuxEnvironment{enumerate} and
+\docAuxEnvironment{description} environments for creating respectively
+unordered\footnote{\enquote{Bulleted}.}, ordered\footnote{\Ie*{}
+ numbered} and \enquote{description} lists. The \Package*{enumitem}
+provides starred versions of these environments which compose these
+lists within the same paragraph\footnote{The first aim of this package
+ is to customize lists, but this is not recommended in the \nwejm{}
+ framework as it may contravene its typographic approach.}.
+
+\begin{docEnvironment}[doclang/environment content=list]{itemize*}{}
+ This environment composes a \enquote{bulleted} list.
\end{docEnvironment}
-\begin{docEnvironment}[doclang/environment content=liste]{enumerate*}{}
- Cet environnement compose une liste \enquote{numérotée} en ligne.
+\begin{docEnvironment}[doclang/environment content=list]{enumerate*}{}
+ This environment composes a \enquote{numbered} list.
\end{docEnvironment}
-\begin{docEnvironment}[doclang/environment content=liste]{description*}{}
- Cet environnement compose une liste \enquote{de description} en ligne.
+\begin{docEnvironment}[doclang/environment content=list]{description*}{}
+ This environment composes a \enquote{description} list.
\end{docEnvironment}
\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 The data I have collected [...]
+\item The data I have collected are
\begin{enumerate*}
- \item disponibles publiquement sur internet : pages Web et CV des
- conférenciers ;
- \item accessibles par Wikipédia, par le précieux
+ \item publicly available on the internet: web pages and CVs of speakers;
+ \item accessible via Wikipedia, through the precious
\enquote{mathematics genealogy project}
- (\url{http://genealogy.math.ndsu.nodak.edu/}) ;
- \item pour 60 des conférenciers pour lesquelles mes informations
- étaient trop lacunaires, [...].
+ (\url{http://genealogy.math.ndsu.nodak.edu/});
+ \item for 60 of the speakers for whom my information was too incomplete, [...].
\end{enumerate*}
\end{enumerate}
\end{bodycode}
\appendix
-\section{Canevas de fichier source typique}
+\section{Typical source file outline}
\label{sec-canevas-de-fichier}
-Le lecteur souhaitant écrire un article pour le \nwejm*{} trouvera ci-dessous un
-canevas de fichier source qui est un modèle typique d'article standard où les
-commandes et environnement moins fréquents ont été mis en commentaire. Il est
-attaché au fichier \file{PDF} de la présente documentation\footnote{Pour
- l'extraire, il devrait suffire de cliquer sur l'icône ci-dessous. Il peut
- également être copié-collé : la plupart des afficheurs \textsc{pdf}
- permettent de sélectionner et de copier du texte.}.
+Readers wishing to write an article in the \nwejm*{} will below an
+outline of a source file which is a typical template for a standard
+article. The less frequent commands and environments have been
+commented out. It is attached to the PDF file of this
+documentation\footnote{To extract it, it should be enough to click on
+ the icon below. It can also be copied and pasted: most \textsc{pdf} viewers
+ allow you to select and copy text.}.
%
\newcommand{\attachfilename}{template.tex}%
-\newcommand{\attachfiletextlink}{Canevas de fichier source typique}%
+\newcommand{\attachfiletextlink}{Typical source file outline}%
\tcbinputlisting{%
samples,
fontupper=\scriptsize\ttfamily,
listing only,
- listing file=../../examples/\attachfilename,
- title={\attachfiletextlink\ \attachfile{../../examples/\attachfilename}},%
- listing options={alsolanguage={[biblatex]TeX},deletekeywords={[2]title,author,keywords},deletekeywords={[5]keywords}}
+ listing file=../examples/\attachfilename,
+ title={\attachfiletextlink\ \attachfile{../examples/\attachfilename}},%
+ listing options={alsolanguage={[biblatex]TeX},deletekeywords={[2]title,author,keywords},deletekeywords={[5]keywords},extendedchars=true}
}
-\section{Packages chargés (ou pas) par la
- classe}\label{sec-packages-charges-ou-pas}
+\section{Packages loaded (or not) by the class}\label{sec-packages-charges-ou-pas}
-\subsection{Packages chargés par la classe}\label{sec:packages-charges-par}
+\subsection{Packages loaded by the class}\label{sec:packages-charges-par}
-On a vu que, pour plusieurs de ses fonctionnalités, la \nwejmauthorcl{} s'appuie
-sur des packages qu'elle charge automatiquement. Ceux dont les fonctionnalités
-peuvent être utiles aux auteurs d'articles du \nwejm{} sont répertoriés dans la
-liste suivante qui indique leur fonction et le cas échéant la ou les options
-avec lesquelles ils sont chargés.
+We have seen that, for several of its features, the \nwejmauthorcl{}
+relies on automatically loaded packages. Those whose features can be
+useful to the authors of \nwejm{} articles are listed below. Their
+function and possible option(s) are indicated.
-En sus des outils propres à la \nwejmauthorcl, tous ceux fournis par ces
-différents packages sont donc à disposition des auteurs de la \nwejm{}.
+In addition to the specific tools to the \nwejmauthorcl, all those
+provided by these different packages are therefore available to \nwejm{}
+authors.
\begin{description}
-\item[\package{nag} :] signalement\footnote{Sous forme de \emph{warnings}.} de
- packages, commandes et environnements obsolètes :
+\item[\package{nag}:] reporting\footnote{In the form of \emph{warnings}.} of obsolete packages, commands and environments:
\begin{description}
- \item[options par défaut :] \docAuxKey{l2tabu}, \docAuxKey{orthodox} ;
+ \item[default options:] \docAuxKey{l2tabu}, \docAuxKey{orthodox};
\end{description}
-\item[\package{kpfonts} :] police principale du document :
+\item[\package{kpfonts} :] main font of the document:
\begin{description}
- \item[options par défaut :] \docAuxKey{noDcommand} ;
+ \item[default options:] \docAuxKey{noDcommand};
\end{description}
-\item[\package{graphicx} :] inclusion d'images ;
-\item[\package{subcaption} :] sous-figures et sous-tableaux ;
-\item[\package{adjustbox} :] ajustement de la position de boîtes, par exemple
- d'images ;
-\item[\package{xspace} :] définition de commandes qui ne \enquote{mangent} pas
- l'espace qui suit ;
-\item[\package{array} :] extension (et corrections de bogues) des
- environnements de tableaux ;
-\item[\package{booktabs} :] tableaux d'allure professionnelle ;
-\item[\package{csquotes} :] citations d'extraits informelles et
- formelles\footnote{Avec citation des sources,
- cf. \vref{sec-guillemets-citations}.} :
+\item[\package{graphicx}:] image inclusion;
+\item[\package{subcaption}:] sub-figures and sub-arrays;
+\item[\package{adjustbox}:] adjusting box position, for example of images;
+\item[\package{xspace}:] defining commands that don't \enquote{eat}
+ the space that follows;
+\item[\package{array}:] extending (and bug-fixing) array environments;
+\item[\package{booktabs}:] professional-looking arrays;
+\item[\package{csquotes}:] informal and formal citations\footnote{With
+ citation of sources,
+ see \vref{sec-guillemets-citations}.}:
\begin{description}
- \item[option par défaut :] \docAuxKey{autostyle} ;
- \item[réglage par défaut :]
- \lstinline[alsolanguage={[csquotes]TeX},alsolanguage={[biblatex]TeX}]|\SetCiteCommand{\autocite}| ;
+ \item[default option:] \docAuxKey{autostyle};
+ \item[default setting:]
+ \lstinline[alsolanguage={[csquotes]TeX},alsolanguage={[biblatex]TeX}]×\SetCiteCommand{\autocite}×;
\end{description}
-\item[\package{biblatex} :] gestion puissante de la bibliographie ;
-\item[\package{datetime2} :] formats de dates et de (zones de) temps :
+\item[\package{biblatex}:] powerfull bibliography management;
+\item[\package{datetime2}:] date and time formats:
\begin{description}
- \item[option par défaut :] \docAuxKey{useregional} ;
+ \item[default option:] \docAuxKey{useregional};
\end{description}
-\item[\package{hyperref} :] support pour les liens
- hypertextes\footnote{Cf. \vref{sec-url}.} :
+\item[\package{hyperref} :] support for hyperlinks\footnote{See \vref{sec-url}.}:
\begin{description}
- \item[option par défaut :] \docAuxKey{hidelinks},
- \docAuxKey{pdfencoding}\lstinline[alsolanguage={[hyperref]TeX}]|=unicode|,
+ \item[default option:] \docAuxKey{hidelinks},
+ \docAuxKey{pdfencoding}\lstinline[alsolanguage={[hyperref]TeX}]×=unicode×,
\docAuxKey{final}, \docAuxKey{breaklinks},
- \docAuxKey{hypertexnames}|=false| ;
+ \docAuxKey{hypertexnames}×=false×;
\end{description}
-\item[\package{glossaries} :] création de glossaires et (listes d')acronymes :
+\item[\package{glossaries}:] creation of glossaries and (lists of) acronyms:
\begin{description}
- \item[option par défaut :] \docAuxKey{nowarn} ;
+ \item[default option:] \docAuxKey{nowarn};
\end{description}
-\item[\package{varioref} :] références de pages intelligentes.
-\item[\package{cleveref} :] références croisées
- intelligentes\footnote{Cf. \vref{sec-references-croisees}.} ;
+\item[\package{varioref}:] smart page references.
+\item[\package{cleveref}:] smart cross-referencing\footnote{See \vref{sec-references-croisees}.};
\begin{description}
- \item[option par défaut :] \docAuxKey{french}, \docAuxKey{ngerman},
+ \item[default option:] \docAuxKey{french}, \docAuxKey{ngerman},
\docAuxKey{dutch}, \docAuxKey{english}, \docAuxKey{noabbrev},
\docAuxKey{capitalize}.
\end{description}
\end{description}
-\subsection{Packages non chargés par la classe}\label{sec:packages-non-charges}
+\subsection{Packages not loaded by the class}\label{sec:packages-non-charges}
-La liste suivante, loin d'être exhaustive, répertorie des packages non chargés
-par la \nwejmauthorcl{} mais pouvant se révéler utiles aux auteurs. En outre,
-lorsqu'ils sont chargés manuellement par l'utilisateur, certains d'entre eux se
-voient fixés par la \nwejmauthorcl{} des options ou réglages dont les plus
-notables sont précisés.
+The following list, for from being exhaustive, lists packages not
+loaded by the \nwejmauthorcl{} but which may prove useful to
+authors. In addition, when manually loaded, some of them have options
+or settings set by the \nwejmauthorcl{}, the most notable of which are specified.
\begin{description}
-\item[\package{tikz-cd} :] création simple de diagrammes commutatifs de très
- haute qualité\footnote{Le \Package{xy}, souvent utilisé pour de tels
- diagrammes, est incomptible avec la présente classe :
- cf. \vref{sec-incompatibilites}.} ;
-\item[\package{pgfplots} :] création simple de graphiques (de dimensions~$2$
- ou~$3$) de très haute qualité pour représenter des fonctions ou des données
- expérimentales ;
-\item[\package{siunitx} :] gestion des nombres, angles et unités, et alignement
- vertical sur le séparateur décimal dans les tableaux :
+\item[\package{tikz-cd}:] easy creation of very high quality
+ commutative diagrams\footnote{The \Package{xy}, often used for such
+ diagrams, is incompatible with the present class:
+ See \vref{sec-incompatibilites}.};
+\item[\package{pgfplots}:] easy creation of very high quality ($2$D
+ or $3$D) figures to represent functions or experimental data;
+\item[\package{siunitx}:] management of numbers, angles and units, and vertical
+ alignment on the decimal separator in tables:
\begin{description}
- \item[option par défaut :]\
+ \item[default option:]\
\begin{itemize}
- \item \docAuxKey{detect-all} ;
- \item \docAuxKey{locale}|=|\docValue{FR} ou \docValue{UK} ou \docValue{DE}
- selon la langue de l'article ;
+ \item \docAuxKey{detect-all};
+ \item \docAuxKey{locale}×=×\docValue{FR} or \docValue{UK} or \docValue{DE}
+ depending on the article language;
\end{itemize}
\end{description}
-\item[\package{listings} :] insertion de listings informatiques ;
-\item[\package{todonotes} :] insertion de \enquote{TODO}\footnote{Rappels de
- points qu'il ne faut pas oublier d'ajouter, de compléter, de réviser, etc.}.
+\item[\package{listings}:] insertion of computer listings;
+\item[\package{todonotes}:] insertion of
+ \enquote{TODO}\footnote{Reminders of points to add, complete,
+ modify, etc.}.
\end{description}
-\section{Incompatibilités}
+\section{Incompatibilities}
\label{sec-incompatibilites}
-Pour des raison techniques, le \nwejm{} n'accepte pas de fichier source
-\file{.tex} chargeant le \Package{xy} et la classe \nwejmauthor{} émet une
-erreur si tel est le cas. L'utilisateur ayant à composer des diagrammes
-\enquote{de type matriciel}, notamment des diagrammes commutatifs, est invité
-à recourir au \Package{tikz-cd} à la fois moderne et convivial.
+For technical reasons, the \nwejm{} does not accept a \file{.tex}
+source file loading the \Package{xy} and the \nwejmauthor{} will
+issue an error in that case. The user who has to compose
+\enquote{matrix-like} diagrams, and especially commutative diagrams,
+should use the modern and user-friendly \Package{tikz-cd}.
-\section{Notations, syntaxe, terminologie et codes couleurs}\label{sec-synt-term-notat}
+\section{Notations, syntax, terminology and colour coding}\label{sec-synt-term-notat}
-Nous précisons ici les notations, syntaxe, terminologie et codes couleurs de
-la présente documentation.
+We specify here the notations, syntax, terminology and colour coding
+of this documentation.
-\subsection{Commandes, environnements, clés, valeurs}\label{sec-comm-envir-cles}
+\subsection{Commands, environments, keys, values}\label{sec-comm-envir-cles}
-Les commandes, environnements, clés et valeurs de clés sont systématiquement
-composés en fonte à chasse fixe. En outre, pour plus facilement les
-distinguer, ils figurent avec des couleurs propres :
+Commands, environments, keys and key values are systematically composed
+in monospaced font. In addition, to distinguish them easily, these are
+displayed with their own colours:
\begin{itemize}
-\item les commandes en bleu : \docAuxCommand*{commande} ;
-\item les environnements en \enquote{sarcelle} :
- \docAuxEnvironment*{environnement} ;
-\item les clés en pourpre : \docAuxKey*{clé} ;
-\item les valeurs des clés en violet : \docValue*{valeur}.
+\item blue commands: \docAuxCommand*{command};
+\item \enquote{teal} environments:
+ \docAuxEnvironment*{environment};
+\item purple keys: \docAuxKey*{key};
+\item violet keys values: \docValue*{value}.
\end{itemize}
-\subsection{Arguments génériques}
+\subsection{Generic arguments}
\label{sec-arguments-generiques}
-Pour expliquer le rôle d'une commande, il est parfois nécessaire d'indiquer
-à quoi celle-ci s'applique, autrement dit quel en est l'argument générique.
-Un tel argument est composé :
+To explain the role of a command, it is sometimes necessary to
+indicate what it applies to. In other words, what its generic argument
+is. Such an argument is composed:
\begin{itemize}
-\item en fonte à chasse fixe ;
-\item en italique ;
-\item entre chevrons simples ;
+\item in monospaced font;
+\item in italics;
+\item between single rafters;
\end{itemize}
-le tout en marron, ainsi : \meta{argument générique}.
+all in brown, thus: \meta{generic argument}.
-\subsection{Liens hypertextes}
+\subsection{Hyperlinks}
\label{sec-liens-hypertextes}
-Les liens hypertextes figurent en couleur, ainsi :
-\href{http://gte.univ-littoral.fr/members/dbitouze/pub/latex}{lien hypertexte}.
-La plupart des références aux commandes, environnements et clés définis dans la
-présente documentation, sont des liens hypertextes, surmontés du numéro de page
-où se trouve la cible correspondante (sauf si elle se situe sur la même page) :
+Hyperlinks are shown in colour, as follows:
+\href{http://gte.univ-littoral.fr/members/dbitouze/pub/latex}{hyperlink}. Most
+references to commands, environments and keys defined in this document
+are hyperlinks, topped by the page number where the corresponding
+target is located (unless it is on the same page):
\begin{itemize}
-\item \refCom{author} ;
+\item \refCom{author};
\item \refEnv{abstract}.
\end{itemize}
-\subsection{Éléments \enquote{obligatoires}}
+\subsection{\enquote{Mandatory} elements}
\label{sec-comm-oblig}
-L'icône \mandatory{}, figurant en regard de certains éléments (commandes ou
-environnements), indique que ceux-ci sont \enquote{obligatoires}.
+The \mandatory{} icon next to certain items (commands or
+environments) indicates that they are \enquote{mandatory}.
-\subsection{Codes sources}
+\subsection{Source codes}
\label{sec-codes-sources}
-Les exemples qui illustrent la présente documentation sont constitués de codes
-sources et, le cas échéant, des \enquote{copies d'écran} correspondantes.
+The examples in this documentation consist of source code and, where
+appropriate, the corresponding \endquote{screen shots}.
% Ceux-ci proviennent le plus souvent du spécimen de document composé avec la
% \yatcl, fourni avec l'ensemble de la classe
% (cf. \vref{sec-specimen-arborescence}).
-Ces codes sources figurent dans des cadres, pouvant comporter un titre, de
-couleur bleu :
+These source codes are shown in blue boxes, which may include a title:
\begin{itemize}
-\item non ombrés s'ils doivent être saisis dans le corps du document ;
+\item unshaded if they are to be entered in the body of the document;
\begin{bodycode}
-"\meta{code source}"
+"\meta{source code}"
\end{bodycode}
-\begin{bodycode}[title=\meta{titre}]
-"\meta{code source}"
+\begin{bodycode}[title=\meta{title}]
+"\meta{source code}"
\end{bodycode}
-\item ombrés s'ils doivent être saisis en préambule du fichier.
+\item shaded if they are to be entered in the preamble of the file.
\begin{preamblecode}
-"\meta{code source à insérer en préambule}"
+"\meta{source code to be inserted in preamble}"
\end{preamblecode}
-\begin{preamblecode}[title=\meta{titre}]
-"\meta{code source à insérer en préambule}"
+\begin{preamblecode}[title=\meta{title}]
+"\meta{source code to be inserted in preamble}"
\end{preamblecode}
\end{itemize}
-\subsection{Espaces dans les codes sources}
+\subsection{Spaces in source code}
\label{sec-espaces-dans-les}
-Pour éviter certaines confusions, les espaces dans les codes sources devant
-être saisis au clavier sont parfois matérialisés au moyen de la marque
-\lstinline[showspaces]+ +.
+To avoid confusion, spaces in source code that must be entered using
+the keyboard are sometimes realized with the \lstinline[showspaces]+ +. mark.
\subsection{Options}
\label{sec-options}
-La présente classe, ainsi que certaines de ses commandes et certains de ses
-environnements, peuvent être modulés au moyen d'options, ou listes d'options
-(séparées par des virgules). Ces options peuvent se présenter sous la forme
-\meta{clé}|=|\meta{valeur} et la \meta{valeur} passée à une \meta{clé} peut
-être :
+This class, and some of its commands and environments, can be adjusted
+with options, or lists of options (separated by commas). These options
+can be in the form \meta{key}×=×\meta{value} and the inputted
+\meta{value} can be:
%^^A \begin{description}
%^^A \item[ne prennent pas de valeur.] Une telle option, par exemple nommée
%^^A \refKey{option}, est alors documentée selon la syntaxe suivante:
@@ -2038,28 +2008,31 @@ environnements, peuvent être modulés au moyen d'options, ou listes d'options
%^^A \item[prennent des valeurs.] Une telle option se présente alors sous la forme
%^^A \meta{clé}"="\meta{valeur}. Les valeurs passées à une clé peuvent être :
\begin{description}
-\item[libre.] Si une telle \meta{clé} est (pour l'exemple) nommée
- \refKey{freekey}, elle est alors documentée selon la syntaxe suivante :
- \begin{docKey*}{freekey}{=\meta{valeur}}{\meta{valeurs par défaut et initiale}}
- \meta{Description de \refKey{freekey}}
+\item[free.] If such a \meta{key} is for instance named
+ \refKey{freekey}, then it is documented according to the following syntax:
+ \begin{docKey*}{freekey}{=\meta{value}}{\meta{default
+ and initial values}}
+ \meta{Description of \refKey{freekey}}
\end{docKey*}
-\item[imposée] (parmi une liste de valeurs possibles). Si une telle \meta{clé} est
- (pour l'exemple) nommée \refKey{choicekey} et de valeurs imposées
- \docValue*{valeur1}, \dots{}, \docValue*{valeurN}, elle est alors
- documentée selon la syntaxe suivante\footnote{Comme souvent en informatique,
- la barre verticale séparant les valeurs possibles signifie \enquote{ou}.} :
- \begin{docKey*}{choicekey}{=\docValue*{valeur1}\textbar...\textbar\docValue*{valeurN}}{\meta{valeurs par défaut et initiale}}
- \meta{Description de \refKey{choicekey} et de ses valeurs possibles}
+\item[imposed] (from a list of possible values). If such a \meta{key}
+ is for instance named \refKey{choicekey} and with imposed values
+ \docValue*{value1}, \dots{}, \docValue*{valueN}, then it is
+ documented according to the following syntax\footnote{As is often
+ the case in computing, the vertical bar to separate the possible
+ values means \enquote{or}.}:
+ \begin{docKey*}{choicekey}{=\docValue*{value1}\textbar...\textbar\docValue*{valueN}}{\meta{default
+ and initial values}}
+ \meta{Description of \refKey{choicekey} and its possible values}
\end{docKey*}
\end{description}
%^^A \end{description}
-Les \meta{valeurs par défaut et initiale} d'une clé sont souvent précisées
-(entre parenthèses en fin de ligne). Elles indiquent ce que la clé vaut :
+The \meta{default and initial values} of a key are often specified (in
+brackets at the end of a line). They indicate the value of the key:
\begin{description}
-\item[par défaut] c'est-à-dire lorsque la clé \emph{est} employée, mais
- \emph{seule} c'est-à-dire sans qu'une valeur explicite lui soit passée ;
-\item[initialement] c'est-à-dire lorsque la clé \emph{n'est pas} employée.
+\item[by default] i.e. when the key \emph{is} used \emph{alone}
+ i.e. without any explicit value imputed;
+\item[initially] i.e. when the key \emph{is not} used.
\end{description}
%
\printbibliography[category=documentation]
diff --git a/Master/texmf-dist/doc/latex/nwejm/examples/article-in-dutch.pdf b/Master/texmf-dist/doc/latex/nwejm/examples/article-in-dutch.pdf
index acc327a879d..cc2aa090f70 100644
--- a/Master/texmf-dist/doc/latex/nwejm/examples/article-in-dutch.pdf
+++ b/Master/texmf-dist/doc/latex/nwejm/examples/article-in-dutch.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/nwejm/examples/article-in-english.pdf b/Master/texmf-dist/doc/latex/nwejm/examples/article-in-english.pdf
index 69623995a4f..9d486cc5208 100644
--- a/Master/texmf-dist/doc/latex/nwejm/examples/article-in-english.pdf
+++ b/Master/texmf-dist/doc/latex/nwejm/examples/article-in-english.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/nwejm/examples/article-in-french.pdf b/Master/texmf-dist/doc/latex/nwejm/examples/article-in-french.pdf
index 4587a77baaa..83cbf7c07b3 100644
--- a/Master/texmf-dist/doc/latex/nwejm/examples/article-in-french.pdf
+++ b/Master/texmf-dist/doc/latex/nwejm/examples/article-in-french.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/nwejm/examples/article-in-german.pdf b/Master/texmf-dist/doc/latex/nwejm/examples/article-in-german.pdf
index ae50c9a199e..50ae92ace9d 100644
--- a/Master/texmf-dist/doc/latex/nwejm/examples/article-in-german.pdf
+++ b/Master/texmf-dist/doc/latex/nwejm/examples/article-in-german.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/nwejm/examples/issue.pdf b/Master/texmf-dist/doc/latex/nwejm/examples/issue.pdf
index 1552f7e5837..cfedc3e9401 100644
--- a/Master/texmf-dist/doc/latex/nwejm/examples/issue.pdf
+++ b/Master/texmf-dist/doc/latex/nwejm/examples/issue.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/nwejm/examples/latexmkrc b/Master/texmf-dist/doc/latex/nwejm/examples/latexmkrc
index ed23d5053f3..4a08af4ec93 100644
--- a/Master/texmf-dist/doc/latex/nwejm/examples/latexmkrc
+++ b/Master/texmf-dist/doc/latex/nwejm/examples/latexmkrc
@@ -1,4 +1,4 @@
-$pdf_mode = 4;
+$pdf_mode = 1;
$biber = 'biber -U %O %B';
$bibtex_use = 1;
diff --git a/Master/texmf-dist/doc/latex/nwejm/examples/sample.pdf b/Master/texmf-dist/doc/latex/nwejm/examples/sample.pdf
index 18b205074d0..89a779d168e 100644
--- a/Master/texmf-dist/doc/latex/nwejm/examples/sample.pdf
+++ b/Master/texmf-dist/doc/latex/nwejm/examples/sample.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/nwejm/examples/template.tex b/Master/texmf-dist/doc/latex/nwejm/examples/template.tex
index c2563d14e23..12446190a42 100644
--- a/Master/texmf-dist/doc/latex/nwejm/examples/template.tex
+++ b/Master/texmf-dist/doc/latex/nwejm/examples/template.tex
@@ -14,7 +14,7 @@
% - the `biblatex` package (already loaded by the class),
% - as a bibliographic engine, NOT the usual `bibtex`, BUT `biber`.
%
-% See the documentation (currently only in French) for more details.
+% See the documentation (in English and in French) for more details.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% The language of the article is by default English. Should it be French, German
diff --git a/Master/texmf-dist/doc/latex/nwejm/french/latexmkrc b/Master/texmf-dist/doc/latex/nwejm/french/latexmkrc
index ed23d5053f3..b90a4cd97aa 100644
--- a/Master/texmf-dist/doc/latex/nwejm/french/latexmkrc
+++ b/Master/texmf-dist/doc/latex/nwejm/french/latexmkrc
@@ -17,7 +17,7 @@ sub makeglossaries {
return $return;
}
-$makeindex = 'texindy -L english -C utf8';
+$makeindex = 'texindy -L french -C utf8';
push @generated_exts, 'acn', 'acr', 'alg', 'bbl', 'bcf', 'fls', 'gl*', 'ist',
'run.xml', 'sbl*', 'sl*', 'sym*', 'unq', 'mw' ;
diff --git a/Master/texmf-dist/doc/latex/nwejm/french/nwejm-fr.pdf b/Master/texmf-dist/doc/latex/nwejm/french/nwejm-fr.pdf
index c281c02bc05..2f80d2cac4d 100644
--- a/Master/texmf-dist/doc/latex/nwejm/french/nwejm-fr.pdf
+++ b/Master/texmf-dist/doc/latex/nwejm/french/nwejm-fr.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/nwejm/french/nwejm-fr.tex b/Master/texmf-dist/doc/latex/nwejm/french/nwejm-fr.tex
index 376a98cf2e5..6923a6d8cbe 100644
--- a/Master/texmf-dist/doc/latex/nwejm/french/nwejm-fr.tex
+++ b/Master/texmf-dist/doc/latex/nwejm/french/nwejm-fr.tex
@@ -9,8 +9,8 @@
%
\documentclass[french,nolocaltoc]{nwejmart}
%
-\DTMsavedate{release-date}{2022-02-21}
-\newcommand{\releaseversion}{1.0.4}
+\DTMsavedate{release-date}{2022-09-21}
+\newcommand{\releaseversion}{1.0.5}
%
\usepackage[nwejm]{denisbdoc}
\usepackage{tabulary}
@@ -20,6 +20,23 @@
\patchcmd{\@mn@margintest}{\@tempswafalse}{\@tempswatrue}{}{}
\patchcmd{\@mn@margintest}{\@tempswafalse}{\@tempswatrue}{}{}
\reversemarginpar
+
+\lst@InputCatcodes
+\def\lst@DefEC{%
+ \lst@CCECUse \lst@ProcessLetter
+ ^^80^^81^^82^^83^^84^^85^^86^^87^^88^^89^^8a^^8b^^8c^^8d^^8e^^8f%
+ ^^90^^91^^92^^93^^94^^95^^96^^97^^98^^99^^9a^^9b^^9c^^9d^^9e^^9f%
+ ^^a0^^a1^^a2^^a3^^a4^^a5^^a6^^a7^^a8^^a9^^aa^^ab^^ac^^ad^^ae^^af%
+ ^^b0^^b1^^b2^^b3^^b4^^b5^^b6^^b7^^b8^^b9^^ba^^bb^^bc^^bd^^be^^bf%
+ ^^c0^^c1^^c2^^c3^^c4^^c5^^c6^^c7^^c8^^c9^^ca^^cb^^cc^^cd^^ce^^cf%
+ ^^d0^^d1^^d2^^d3^^d4^^d5^^d6^^d7^^d8^^d9^^da^^db^^dc^^dd^^de^^df%
+ ^^e0^^e1^^e2^^e3^^e4^^e5^^e6^^e7^^e8^^e9^^ea^^eb^^ec^^ed^^ee^^ef%
+ ^^f0^^f1^^f2^^f3^^f4^^f5^^f6^^f7^^f8^^f9^^fa^^fb^^fc^^fd^^fe^^ff%
+ ^^^^20ac^^^^0153^^^^0152% nouveau pour xetex
+ ^^^^27e8% Left-Pointing Angle Bracket
+ ^^^^27e9% Right-Pointing Angle Bracket
+ ^^00}
+\lst@RestoreCatcodes
\makeatother
%
\indexsetup{level=\section*,toclevel=section,noclearpage}
@@ -472,8 +489,8 @@ Le titre proprement dit de l'article, regroupant tous les éléments saisis à l
\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
- d'un projet borélien de grande envergure (1921-1939)}
+\subtitle[Étendue et limites d'un projet borélien]{Étendue et
+ limites d'un projet borélien de grande envergure (1921-1939)}
%
\author[
affiliation={Laboratoire \textsc{sphere}, Université Paris Diderot}
@@ -1847,7 +1864,7 @@ attaché au fichier \file{PDF} de la présente documentation\footnote{Pour
listing only,
listing file=../examples/\attachfilename,
title={\attachfiletextlink\ \attachfile{../examples/\attachfilename}},%
- listing options={alsolanguage={[biblatex]TeX},deletekeywords={[2]title,author,keywords},deletekeywords={[5]keywords}}
+ listing options={alsolanguage={[biblatex]TeX},deletekeywords={[2]title,author,keywords},deletekeywords={[5]keywords},extendedchars=true}
}
\section{Packages chargés (ou pas) par la
diff --git a/Master/texmf-dist/source/latex/nwejm/nwejm-examples-template.dtx b/Master/texmf-dist/source/latex/nwejm/nwejm-examples-template.dtx
index 923c68b15d5..46ec0c89f1d 100644
--- a/Master/texmf-dist/source/latex/nwejm/nwejm-examples-template.dtx
+++ b/Master/texmf-dist/source/latex/nwejm/nwejm-examples-template.dtx
@@ -761,7 +761,7 @@ Cf. \vref{thm-bolzano-weierstrass} \& \vref{rmk-euler} \&
% - the `biblatex` package (already loaded by the class),
% - as a bibliographic engine, NOT the usual `bibtex`, BUT `biber`.
%
-% See the documentation (currently only in French) for more details.
+% See the documentation (in English and in French) for more details.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% The language of the article is by default English. Should it be French, German
@@ -868,5 +868,7 @@ Cf. \vref{thm-bolzano-weierstrass} \& \vref{rmk-euler} \&
% \endinput
% Local Variables:
% mode: doctex
+% ispell-local-dictionary: "english"
+% TeX-command-default: "TeX"
% TeX-master: "nwejm"
% End:
diff --git a/Master/texmf-dist/source/latex/nwejm/nwejm.dtx b/Master/texmf-dist/source/latex/nwejm/nwejm.dtx
index f81c1448790..73840d7333d 100644
--- a/Master/texmf-dist/source/latex/nwejm/nwejm.dtx
+++ b/Master/texmf-dist/source/latex/nwejm/nwejm.dtx
@@ -27,7 +27,7 @@
% This field contains the version of the package.
% The value is optional.
% The value is restricted to 32 characters.
-\version{1.0.4 2022-02-21}
+\version{1.0.5 2022-09-21}
% -------------------------------------------------------------------------
% This field contains the name of the author(s).
% The value is optional.
@@ -128,6 +128,7 @@ Mathematics”](http://math.univ-lille1.fr/~nwejm/):
% The value is optional.
% The value is restricted to 2048 characters.
\begin{note}
+This update consists only in a logo file renamed as requested by Karl Berry.
\end{note}
% -------------------------------------------------------------------------
% This field contains the archive file.
@@ -143,6 +144,17 @@ Mathematics”](http://math.univ-lille1.fr/~nwejm/):
% \end{macrocode}
# [Unreleased]
+# [1.0.5] - 2022-09-21
+
+## Fixed
+(First) Page numbers could be not the same in whole issue and in standalone articles.
+
+## Added
+English translation of the documentation.
+
+## Changed
+ `\fixpagenumber` restricted to preamble (`nwejm` class only, not used by the authors).
+
# [1.0.4] - 2022-02-21
## Changed
@@ -156,8 +168,8 @@ Logo file renamed for consistency.
## Fixed
- Authors in headers appeared one page too early.
-- `\begin{alignat}{X}...` displayed "X".
-- Boring warning "unable to apply patch 'eqnum'".
+- `\begin{alignat}{X}...` displayed “X”.
+- Boring warning “unable to apply patch 'eqnum'”.
- Conflicts between `tikzcd` and (Dutch) `babel`.
# [1.0.2] - 2021-10-12
@@ -186,11 +198,11 @@ Logo file renamed for consistency.
# [0.98f] - 2019-03-18
## Added
-- Built-in "conditions" enumeration.
+- Built-in “conditions” enumeration.
- New public command for easily create new enumerations.
## Changed
-- "Such that" symbol in sets definitions now is `\vert` instead of `\slash`.
+- “Such that” symbol in sets definitions now is `\vert` instead of `\slash`.
- `authoryear` bib and cite style changed for `authoryear-comp`.
- Hyperfootnotes now true.
- Documentation improved.
@@ -206,7 +218,7 @@ Logo file renamed for consistency.
## Changed
- Track changes in `expl3`.
- Support for `biblatex` 3.8 changes.
-- "Cont. next page" notifications for `align` and `multline` across page breaks.
+- “Cont. next page” notifications for `align` and `multline` across page breaks.
- *Breaking change* `flalign(*)` and `alignat(*)` now are aliases of `align(*)`
(needed for the previous feature).
- *Breaking change* Package `autonum` not loaded anymore: `equation`, `align`,
@@ -228,7 +240,7 @@ Logo file renamed for consistency.
- Adjustments because of deprecated functions removed from `expl3`.
## Fixed
-- Fix "n.d." appeared in case `.bib` files use `year` field instead of `date`
+- Fix “n.d.” appeared in case `.bib` files use `year` field instead of `date`
field.
- Other minor bug fix.
@@ -270,17 +282,17 @@ Logo file renamed for consistency.
% \end{macrocode}
%
%<*readme>
-nwejm - Support for the journal "North-Western European Journal of Mathematics"
+nwejm - Support for the journal “North-Western European Journal of Mathematics”
===============================================================================
About
-------
This bundle includes LaTeX classes and `biblatex` styles files dedicated to the
-new journal "North-Western European Journal of Mathematics".
+new journal “North-Western European Journal of Mathematics”.
Release
-------
-2022-02-21 v1.0.4
+2022-09-21 v1.0.5
Development
-----------
@@ -311,7 +323,7 @@ https://github.com/dbitouze/nwejm.
\input l3docstrip.tex
\Msg{********************************************************}
\Msg{* Installation}
-\Msg{* Class: nwejm 2022-02-21 v1.0.4}
+\Msg{* Class: nwejm 2022-09-21 v1.0.5}
\Msg{* for the journal}
\Msg{* "North-Western European Journal of Mathematics" (DB)}
\Msg{********************************************************}
@@ -595,8 +607,8 @@ Running "make install" installs the files in the local TeX tree.
\ProvidesExplClass
%<class> {nwejm}
%<class-article> {nwejmart}
- {2022-02-21}
- {1.0.4}
+ {2022-09-21}
+ {1.0.5}
{
Class for the journal "North-Western European Journal of Mathematics".
}
@@ -663,6 +675,14 @@ Running "make install" installs the files in the local TeX tree.
size~parameter~specified~ (`#1')~is~ not~ allowed:~ only~ `0',~`1'~(or~
`\string\big'),~`2'~(or~ `\string\Big'),~`3'~(or~ `\string\big'g)~and~`4'~(or~
`\string\Bigg')~ are ~ allowed. ~ It~ will~ be~ ignored.}%
+%<class-article> \msg_new:nnn{nwejmart}{Something~wrong~with~page~numbers}{The~ first~ page~
+%<class-article> number~ of~ the~ current~ article~ (`\c_sys_jobname_str.tex')~ is~ supposed~
+%<class-article> to~ be~ extracted~ from~ the~ file~ `\c_@@_main_file_name_tl.aux`~ but~ the~
+%<class-article> latter~ doesn't~ contain~ any~ relevant~ information~ for~ this~ purpose.~
+%<class-article> Double~ check~ the~ `\c_@@_main_file_name_tl.tex'~ file~ actually~ contains~
+%<class-article> `\string\inputarticle\string{\c_sys_jobname_str\string}'~ and~ the~ resulting~
+%<class-article> `\c_@@_main_file_name_tl.pdf'~ actually~ contains~ the~ content~ of~ the~
+%<class-article> current~ article.}%
% \end{macrocode}
%
% \begin{macrocode}
@@ -3150,20 +3170,41 @@ Running "make install" installs the files in the local TeX tree.
%<class>}
% \end{macrocode}
%
+% If the auxiliairy ×issue.aux× file:
+% \begin{itemize}
+% \item does exist, the first page number of the article gets extracted from here,
+% at least if the relevant information (×\getpagerefnumber{@@-\currfilebase})
+% is avaialable (otherwise, an error message is emitted since, it is the
+% manifestation of a problem that would lead to an extra page numbered 0),
+% \item doesn't exist, the first page number is by default 1, but may be fixed
+% thanks to the macro ×\fixpagenumber× (which has no effect in the case
+% ×issue.aux× file does exist).
+% \end{itemize}
+%
% \begin{macrocode}
%<class-article>
-%<class-article>\file_if_exist:nT { \c_@@_main_file_name_tl.aux }
-%<class-article>{\externaldocument[@@-]{\c_@@_main_file_name_tl}
-%<class-article> \AddToHook{begindocument/end}{\setcounter{page}{\number\numexpr\getpagerefnumber{@@-\currfilebase}}}
-%<class-article>}
+%<class-article>\file_if_exist:nTF { \c_@@_main_file_name_tl.aux }
+%<class-article>{
+%<class-article> \externaldocument[@@-]{\c_@@_main_file_name_tl}
+%<class-article> \cs_generate_variant:Nn \int_set:Nn { Nx }
+%<class-article> \int_set:Nx \l_tmpa_int {\number\numexpr\getpagerefnumber{@@-\currfilebase}}
+%<class-article> \int_compare:nNnTF {\l_tmpa_int} > {0}
+%<class-article> {
+%<class-article> \AddToHook{begindocument/end}{\setcounter{page}{\l_tmpa_int}}
+%<class-article> }{
+%<class-article> \msg_error:nn{nwejmart}{Something~wrong~with~page~numbers}
+%<class-article> }
+%<class-article> \NewDocumentCommand \fixpagenumber { m } { }
+%<class-article>}{
% \end{macrocode}
%
% In case one wants to manually control the page numbers, the following macro
% ×\fixpagenumber{...}× has to be used instead of ×\setcounter{page}{...}×.
% \begin{macrocode}
\NewDocumentCommand \fixpagenumber { m } {
-%<class-article>\setcounter{page}{#1}
+%<class-article> \setcounter{page}{#1}
}
+%<class-article>}
% \end{macrocode}
%
% \section{User level commands}
@@ -3649,7 +3690,6 @@ Running "make install" installs the files in the local TeX tree.
% French ones in the issue. The following fixes this trouble.
% \begin{macrocode}
\FrenchFootnotes
- \g__nwejm_french_crefname_tl
\renewcommand*{\glossaryname}{Glossaire}%
\renewcommand*{\acronymname}{Acronymes}%
\renewcommand*{\entryname}{Terme}%
@@ -3950,7 +3990,6 @@ Running "make install" installs the files in the local TeX tree.
\tl_new:N \g_@@_article_bib_key_tl%
\tl_new:N \l_@@_people_first_last_names_tl
\tl_new:N \g_@@_authors_first_last_names_tl%
-\tl_new:N \g__@@_citeauthor_no_giveninits%
\tl_new:N \g_@@_citeauthor_tl%
\int_new:N \g_@@_author_s_number_current_article_int%
%
diff --git a/Master/texmf-dist/tex/latex/nwejm/nwejm.cls b/Master/texmf-dist/tex/latex/nwejm/nwejm.cls
index a543b122869..97913ffce73 100644
--- a/Master/texmf-dist/tex/latex/nwejm/nwejm.cls
+++ b/Master/texmf-dist/tex/latex/nwejm/nwejm.cls
@@ -18,8 +18,8 @@
\NeedsTeXFormat{LaTeX2e}[1999/12/01]
\ProvidesExplClass
{nwejm}
- {2022-02-21}
- {1.0.4}
+ {2022-09-21}
+ {1.0.5}
{
Class for the journal "North-Western European Journal of Mathematics".
}
@@ -1618,7 +1618,6 @@
\selectlanguage{french}
% \shorthandoff{"}%
\FrenchFootnotes
- \g__nwejm_french_crefname_tl
\renewcommand*{\glossaryname}{Glossaire}%
\renewcommand*{\acronymname}{Acronymes}%
\renewcommand*{\entryname}{Terme}%
@@ -1789,7 +1788,6 @@
\tl_new:N \g__nwejm_article_bib_key_tl%
\tl_new:N \l__nwejm_people_first_last_names_tl
\tl_new:N \g__nwejm_authors_first_last_names_tl%
-\tl_new:N \g__nwejm_citeauthor_no_giveninits%
\tl_new:N \g__nwejm_citeauthor_tl%
\int_new:N \g__nwejm_author_s_number_current_article_int%
\cs_new_protected:Nn \__nwejm_citeauthor_no_giveninits:n {%
diff --git a/Master/texmf-dist/tex/latex/nwejm/nwejmart.cls b/Master/texmf-dist/tex/latex/nwejm/nwejmart.cls
index 818db540ba0..9247a377e1c 100644
--- a/Master/texmf-dist/tex/latex/nwejm/nwejmart.cls
+++ b/Master/texmf-dist/tex/latex/nwejm/nwejmart.cls
@@ -18,8 +18,8 @@
\NeedsTeXFormat{LaTeX2e}[1999/12/01]
\ProvidesExplClass
{nwejmart}
- {2022-02-21}
- {1.0.4}
+ {2022-09-21}
+ {1.0.5}
{
Class for the journal "North-Western European Journal of Mathematics".
}
@@ -75,6 +75,14 @@
size~parameter~specified~ (`#1')~is~ not~ allowed:~ only~ `0',~`1'~(or~
`\string\big'),~`2'~(or~ `\string\Big'),~`3'~(or~ `\string\big'g)~and~`4'~(or~
`\string\Bigg')~ are ~ allowed. ~ It~ will~ be~ ignored.}%
+ \msg_new:nnn{nwejmart}{Something~wrong~with~page~numbers}{The~ first~ page~
+ number~ of~ the~ current~ article~ (`\c_sys_jobname_str.tex')~ is~ supposed~
+ to~ be~ extracted~ from~ the~ file~ `\c__nwejm_main_file_name_tl.aux`~ but~ the~
+ latter~ doesn't~ contain~ any~ relevant~ information~ for~ this~ purpose.~
+ Double~ check~ the~ `\c__nwejm_main_file_name_tl.tex'~ file~ actually~ contains~
+ `\string\inputarticle\string{\c_sys_jobname_str\string}'~ and~ the~ resulting~
+ `\c__nwejm_main_file_name_tl.pdf'~ actually~ contains~ the~ content~ of~ the~
+ current~ article.}%
\bool_new:N \g__nwejm_language_specified_bool
\cs_new_protected:Nn \__nwejm_language:n
{
@@ -623,12 +631,22 @@
%%<class-article> \hypersetup{pdfmsc=\g_@@_msc_tl}
}
-\file_if_exist:nT { \c__nwejm_main_file_name_tl.aux }
-{\externaldocument[__nwejm-]{\c__nwejm_main_file_name_tl}
- \AddToHook{begindocument/end}{\setcounter{page}{\number\numexpr\getpagerefnumber{__nwejm-\currfilebase}}}
-}
+\file_if_exist:nTF { \c__nwejm_main_file_name_tl.aux }
+{
+ \externaldocument[__nwejm-]{\c__nwejm_main_file_name_tl}
+ \cs_generate_variant:Nn \int_set:Nn { Nx }
+ \int_set:Nx \l_tmpa_int {\number\numexpr\getpagerefnumber{__nwejm-\currfilebase}}
+ \int_compare:nNnTF {\l_tmpa_int} > {0}
+ {
+ \AddToHook{begindocument/end}{\setcounter{page}{\l_tmpa_int}}
+ }{
+ \msg_error:nn{nwejmart}{Something~wrong~with~page~numbers}
+ }
+ \NewDocumentCommand \fixpagenumber { m } { }
+}{
\NewDocumentCommand \fixpagenumber { m } {
-\setcounter{page}{#1}
+ \setcounter{page}{#1}
+}
}
\vref@addto\extrasfrench{%
\def\reftextfaceafter {page~\reftextvario{ci-contre}{suivante}}%
@@ -864,7 +882,6 @@
\tl_new:N \g__nwejm_article_bib_key_tl%
\tl_new:N \l__nwejm_people_first_last_names_tl
\tl_new:N \g__nwejm_authors_first_last_names_tl%
-\tl_new:N \g__nwejm_citeauthor_no_giveninits%
\tl_new:N \g__nwejm_citeauthor_tl%
\int_new:N \g__nwejm_author_s_number_current_article_int%
\cs_new_protected:Nn \__nwejm_citeauthor_no_giveninits:n {%