From c3002414cc6356ddb2289303378b8c2dd448908a Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 2 Jan 2017 23:42:50 +0000 Subject: gzt (2jan17) git-svn-id: svn://tug.org/texlive/trunk@42832 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/gzt/README-en.md | 5 - Master/texmf-dist/doc/latex/gzt/denis.png | Bin 88304 -> 0 bytes .../doc/latex/gzt/english/README-TRANSLATION.md | 4 + .../texmf-dist/doc/latex/gzt/fixed-footnotes.tex | 14 - Master/texmf-dist/doc/latex/gzt/french/denis.png | Bin 0 -> 88304 bytes Master/texmf-dist/doc/latex/gzt/french/gzt-fr.bib | 35 + Master/texmf-dist/doc/latex/gzt/french/gzt-fr.pdf | Bin 0 -> 526409 bytes Master/texmf-dist/doc/latex/gzt/french/gzt-fr.tex | 110 ++ Master/texmf-dist/doc/latex/gzt/french/latexmkrc | 23 + .../latex/gzt/french/sections/fixed-footnotes.tex | 14 + .../doc/latex/gzt/french/sections/gztarticle.tex | 1490 ++++++++++++++++++++ .../doc/latex/gzt/french/sections/notations.tex | 138 ++ .../latex/gzt/french/sections/packages-charges.tex | 38 + .../doc/latex/gzt/french/sections/todo.tex | 15 + Master/texmf-dist/doc/latex/gzt/gzt-fr.bib | 35 - Master/texmf-dist/doc/latex/gzt/gzt-fr.pdf | Bin 521293 -> 0 bytes Master/texmf-dist/doc/latex/gzt/gzt-fr.tex | 110 -- Master/texmf-dist/doc/latex/gzt/gzt-logo.tex | 89 -- Master/texmf-dist/doc/latex/gzt/gztarticle.tex | 1404 ------------------ Master/texmf-dist/doc/latex/gzt/latexmkrc | 23 - Master/texmf-dist/doc/latex/gzt/latexmkrc.tex | 23 - Master/texmf-dist/doc/latex/gzt/notations.tex | 138 -- .../texmf-dist/doc/latex/gzt/packages-charges.tex | 38 - Master/texmf-dist/doc/latex/gzt/todo.tex | 15 - 24 files changed, 1867 insertions(+), 1894 deletions(-) delete mode 100644 Master/texmf-dist/doc/latex/gzt/README-en.md delete mode 100644 Master/texmf-dist/doc/latex/gzt/denis.png create mode 100644 Master/texmf-dist/doc/latex/gzt/english/README-TRANSLATION.md delete mode 100644 Master/texmf-dist/doc/latex/gzt/fixed-footnotes.tex create mode 100644 Master/texmf-dist/doc/latex/gzt/french/denis.png create mode 100644 Master/texmf-dist/doc/latex/gzt/french/gzt-fr.bib create mode 100644 Master/texmf-dist/doc/latex/gzt/french/gzt-fr.pdf create mode 100644 Master/texmf-dist/doc/latex/gzt/french/gzt-fr.tex create mode 100644 Master/texmf-dist/doc/latex/gzt/french/latexmkrc create mode 100644 Master/texmf-dist/doc/latex/gzt/french/sections/fixed-footnotes.tex create mode 100644 Master/texmf-dist/doc/latex/gzt/french/sections/gztarticle.tex create mode 100644 Master/texmf-dist/doc/latex/gzt/french/sections/notations.tex create mode 100644 Master/texmf-dist/doc/latex/gzt/french/sections/packages-charges.tex create mode 100644 Master/texmf-dist/doc/latex/gzt/french/sections/todo.tex delete mode 100644 Master/texmf-dist/doc/latex/gzt/gzt-fr.bib delete mode 100644 Master/texmf-dist/doc/latex/gzt/gzt-fr.pdf delete mode 100644 Master/texmf-dist/doc/latex/gzt/gzt-fr.tex delete mode 100644 Master/texmf-dist/doc/latex/gzt/gzt-logo.tex delete mode 100644 Master/texmf-dist/doc/latex/gzt/gztarticle.tex delete mode 100644 Master/texmf-dist/doc/latex/gzt/latexmkrc delete mode 100644 Master/texmf-dist/doc/latex/gzt/latexmkrc.tex delete mode 100644 Master/texmf-dist/doc/latex/gzt/notations.tex delete mode 100644 Master/texmf-dist/doc/latex/gzt/packages-charges.tex delete mode 100644 Master/texmf-dist/doc/latex/gzt/todo.tex (limited to 'Master/texmf-dist/doc/latex') diff --git a/Master/texmf-dist/doc/latex/gzt/README-en.md b/Master/texmf-dist/doc/latex/gzt/README-en.md deleted file mode 100644 index 07d496fd45a..00000000000 --- a/Master/texmf-dist/doc/latex/gzt/README-en.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/gzt/denis.png b/Master/texmf-dist/doc/latex/gzt/denis.png deleted file mode 100644 index 545b4a409e7..00000000000 Binary files a/Master/texmf-dist/doc/latex/gzt/denis.png and /dev/null differ diff --git a/Master/texmf-dist/doc/latex/gzt/english/README-TRANSLATION.md b/Master/texmf-dist/doc/latex/gzt/english/README-TRANSLATION.md new file mode 100644 index 00000000000..79ecfaab480 --- /dev/null +++ b/Master/texmf-dist/doc/latex/gzt/english/README-TRANSLATION.md @@ -0,0 +1,4 @@ +# Contributions welcome! + +Currently, the `gzt` 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/gzt/fixed-footnotes.tex b/Master/texmf-dist/doc/latex/gzt/fixed-footnotes.tex deleted file mode 100644 index 87986360db6..00000000000 --- a/Master/texmf-dist/doc/latex/gzt/fixed-footnotes.tex +++ /dev/null @@ -1,14 +0,0 @@ -\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.} - -%%% Local Variables: -%%% mode: latex -%%% eval: (latex-mode) -%%% ispell-local-dictionary: "fr_FR" -%%% TeX-master: "../gzt-fr.tex" -%%% End: diff --git a/Master/texmf-dist/doc/latex/gzt/french/denis.png b/Master/texmf-dist/doc/latex/gzt/french/denis.png new file mode 100644 index 00000000000..545b4a409e7 Binary files /dev/null and b/Master/texmf-dist/doc/latex/gzt/french/denis.png differ diff --git a/Master/texmf-dist/doc/latex/gzt/french/gzt-fr.bib b/Master/texmf-dist/doc/latex/gzt/french/gzt-fr.bib new file mode 100644 index 00000000000..9742b37d109 --- /dev/null +++ b/Master/texmf-dist/doc/latex/gzt/french/gzt-fr.bib @@ -0,0 +1,35 @@ +% This file was created with JabRef 2.10. +% Encoding: UTF8 + + +@Online{Bitouze, + Title = {Conférence \LaTeX{} \no6}, + Author = {Bitouzé, Denis}, + Date = {2016-06-08}, + Url = {http://gte.univ-littoral.fr/members/dbitouze/pub/latex/diapositives-cours-d/conference-n-6/downloadFile/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 = {2016-05-23}, + Url = {http://gte.univ-littoral.fr/members/dbitouze/pub/latex/diapositives-cours-d/conference-n-7/downloadFile/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} +} diff --git a/Master/texmf-dist/doc/latex/gzt/french/gzt-fr.pdf b/Master/texmf-dist/doc/latex/gzt/french/gzt-fr.pdf new file mode 100644 index 00000000000..3bb1ffbf844 Binary files /dev/null and b/Master/texmf-dist/doc/latex/gzt/french/gzt-fr.pdf differ diff --git a/Master/texmf-dist/doc/latex/gzt/french/gzt-fr.tex b/Master/texmf-dist/doc/latex/gzt/french/gzt-fr.tex new file mode 100644 index 00000000000..6265e250bef --- /dev/null +++ b/Master/texmf-dist/doc/latex/gzt/french/gzt-fr.tex @@ -0,0 +1,110 @@ +\documentclass{gztarticle} +\usepackage{denisbdoc} +\usepackage[firstpage]{draftwatermark} +% +\indexsetup{level=\section*,toclevel=section,noclearpage,firstpagestyle=__gzt_mainmatter_ps} +\makeindex[columns=3] +\tcbset{index format=off} +% +\etocsettocstyle{\section*{\contentsname}}{}% +\etocsetstyle {section} +{} +{\leavevmode\leftskip 0cm\relax} +{\bfseries\normalsize\makebox[.6cm][l]{\etocnumber}% + \etocname\nobreak\hfill\nobreak% + \makebox[.5cm][r]{% + \etocpage% + }% + \par% +} +{\medskip} +\etocsetstyle {subsection} +{} +{\leavevmode\leftskip .6cm\relax } +{\mdseries\normalsize\makebox[1cm][l]{\etocnumber}% + \etocname\nobreak\leaders\etoctoclineleaders\hfill\nobreak + \makebox[.5cm][r]{% + \etocpage% + }% + \par% +} +{} +% +\ExplSyntaxOn +\renewpagestyle{__gzt_mainmatter_ps}[]{% + \widenhead{\c_zero_dim}{\c_zero_dim} + \sethead% + [ + \tikz[remember~picture,overlay] {\g__gzt_mainmatter_evenpage_headrule_tl} + ]% + [% + \adjustbox{raise={\c__gzt_header_yshift_dim}{\height}}{% + \large\bfseries\scshape\color{__gzt_rubric_head_text_color}\g__gzt_short_title_tl% + }% + ]% + []% + {}% + {% + \adjustbox{raise={\c__gzt_header_yshift_dim}{\height}}{% + \bfseries\color{__gzt_rubric_head_text_color}\sectiontitle% + } + }% + { + \tikz[remember~picture,overlay] {\g__gzt_mainmatter_oddpage_headrule_tl} + }% + \setfoot% + [\c__gzt_footer_size_font_tl\thepage]% + [% + \uppercase{\c__gzt_footer_string_tl} + ]% + []% + {}% + {% + \uppercase{\c__gzt_footer_string_tl}% + }% + {\c__gzt_footer_size_font_tl\thepage}% +} +\ExplSyntaxOff +% +\lstMakeShortInline[style=dbtex]| +% +\SetWatermarkColor{gray!10}% +\SetWatermarkFontSize{30mm}% +\SetWatermarkText{\MakeUppercase{travail en cours}}% +% +\addbibresource{gzt-fr.bib} +% +\begin{document} +\title[short=Documentation de la classe de la \emph{Gazette} destinée aux +auteurs]{Documentation de la classe \LaTeX{} de la \gzt*{} destinée aux + auteurs} +\subtitle[short=Version 0.96 (01/01/2017)]{\bigskip\Large Version 0.96 en date du 1\ier{} janvier 2017} +% +\author[% +affiliation={% + Université du Littoral Côte d'Opale, Laboratoire de mathématiques pures et + appliquées% +},% +photo=denis,% +email=denis.bitouze@lmpa.univ-littoral.fr,% +webpage=http://gte.univ-littoral.fr/members/dbitouze/pub/latex/,% +]{Bitouzé, Denis} +% +\maketitle* +% +\localtableofcontents +% +\input{sections/fixed-footnotes} +\input{sections/gztarticle} +\input{sections/packages-charges} +\input{sections/notations} +% +\printindex +% +\printbibliography +\end{document} + +%%% Local Variables: +%%% mode: latex +%%% TeX-master: t +%%% End: diff --git a/Master/texmf-dist/doc/latex/gzt/french/latexmkrc b/Master/texmf-dist/doc/latex/gzt/french/latexmkrc new file mode 100644 index 00000000000..400046cd557 --- /dev/null +++ b/Master/texmf-dist/doc/latex/gzt/french/latexmkrc @@ -0,0 +1,23 @@ +$pdf_mode = 1; + +$bibtex_use = 1; +$bibtex = 'biber %O %B'; + +add_cus_dep('glo', 'gls', 0, 'makeglossaries'); +add_cus_dep('acn', 'acr', 0, 'makeglossaries'); +add_cus_dep('slo', 'sls', 0, 'makeglossaries'); +sub makeglossaries{ + system( "makeglossaries \"$_[0]\"" ); +} + +add_cus_dep('idx', 'ind', 0, 'texindy'); +sub texindy{ + system("texindy -L french \"$_[0].idx\""); +} + +push @generated_exts, 'acn', 'acr', 'alg', 'bcf', 'fls', 'gl*', 'sbl*', 'sl*', 'sym*' ; + +$clean_ext .= 'synctex.gz* run.xml tex.bak ind idx out bbl bcf fdb_latexmk run + tdo listing *~ lo* unq mw tcbtemp ins drv atfi db* ain' ; + +$quote_filenames = 0; diff --git a/Master/texmf-dist/doc/latex/gzt/french/sections/fixed-footnotes.tex b/Master/texmf-dist/doc/latex/gzt/french/sections/fixed-footnotes.tex new file mode 100644 index 00000000000..87986360db6 --- /dev/null +++ b/Master/texmf-dist/doc/latex/gzt/french/sections/fixed-footnotes.tex @@ -0,0 +1,14 @@ +\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.} + +%%% Local Variables: +%%% mode: latex +%%% eval: (latex-mode) +%%% ispell-local-dictionary: "fr_FR" +%%% TeX-master: "../gzt-fr.tex" +%%% End: diff --git a/Master/texmf-dist/doc/latex/gzt/french/sections/gztarticle.tex b/Master/texmf-dist/doc/latex/gzt/french/sections/gztarticle.tex new file mode 100644 index 00000000000..2dca05746fd --- /dev/null +++ b/Master/texmf-dist/doc/latex/gzt/french/sections/gztarticle.tex @@ -0,0 +1,1490 @@ +\section{Introduction} +\label{sec-introduction} + +\begin{dbremark}{Documentation : travail en cours}{} + La présente documentation est un travail en cours. Nous remercions d'avance + les lecteurs qui ont des remarques à formuler ou qui trouveront des erreurs de + nous les signaler à l'adresse courriel figurant en fin de document. +\end{dbremark} + +La \smf fournit la classe \LaTeX{} \gztauthor{} destinée aux auteurs souhaitant +publier un article dans la +\href{http://smf4.emath.fr/Publications/Gazette/}{\gzt*{}}. Cette classe a pour +but : +\begin{enumerate} +\item de reproduire fidèlement la maquette de la \gzt{}, permettant ainsi aux + auteurs de pouvoir travailler la mise en page de leur document dans des + conditions (quasi-)réelles ; +\item de fournir un certain nombre d'outils (commandes et environnements) + destinés à faciliter la composition de documents, notamment ceux contenant des + formules de mathématiques. +\end{enumerate} + +\section{Avertissements préliminaires} +\label{sec-avert-prel} + +\begin{dbwarning}{Codage d'entrée \protect\lstinline+UTF-8+ obligatoire}{} + La \gztauthorcl{} de la \gzt{} repose de façon cruciale sur un codage + d'entrée en |UTF-8| : + \begin{itemize} + \item elle charge le \Package{inputenc}\footnote{% + Il convient donc de \emph{ne pas} charger ce package : on se reportera + à la \vref{sec-canevas-de-fichier} pour un canevas de fichier source + destiné à la \gzt{} et notamment pour un préambule typique.% + % + } 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. + \end{itemize} +\end{dbwarning} + +\begin{dbwarning}{Format et compilation \hologo{pdfLaTeX}}{} + La composition des numéros de la \gzt*{} met en œuvre : + \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 \hologo{pdfLaTeX}. En particulier, le compilateur + \hologo{LaTeX} n'étant pas utilisé : + \begin{enumerate} + \item les formats d'images acceptés sont \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.}. Le \Format{eps}, quoique indirectement + supporté, est déconseillé ; + \item le code \program{PostScript}, notamment via \program{PSTricks}, n'est + pas directement pris en charge. Bien qu'il soit accepté, il est à éviter + dans la mesure du possible. + \end{enumerate} + \end{itemize} +\end{dbwarning} + +\begin{dbremark}{Composition par défaut en bi-colonne}{} + Sauf cas particuliers, tous les articles de la \gzt{} sont composés en mode + bi-colonne. +\end{dbremark} + +\section{Article standard} +\label{sec-article-standard} + +Nous commençons par décrire les éléments caractéristiques d'un article standard. + +\subsection{Préparation du \enquote{titre} de l'article} +\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. + +\subsubsection{Titre, sous-titre} +\label{sec-titre} + +\begin{docCommand}[doc description=\mandatory]{title}{\oarg{option}\marg{titre}} + Cette commande définit le \meta{titre} de l'article. Celui-ci apparaît alors + en début d'article et aussi comme métadonnée \enquote{Titre} du fichier + \textsc{pdf} correspondant. +\end{docCommand} + +\begin{docCommand}{subtitle}{\oarg{option}\marg{sous-titre}} + Cette commande définit l'éventuel \meta{sous-titre} de l'article. Celui-ci + est automatiquement ajouté au titre. +\end{docCommand} + +Les commandes \refCom{title} et \refCom{subtitle} admettent un argument +optionnel permettant de spécifier un (sous-)titre court au moyen de la clé +\refKey{short}. + +\begin{docKey}{short}{=\meta{(sous-)titre court}}{pas de valeur par défaut, + initialement vide} + Cette clé définit un (sous-)titre \enquote{court} de l'article qui figure + alors à la place du (sous-)titre \enquote{normal} dans le sommaire et en titre + courant\footnote{En entête.}. +\end{docKey} + +\begin{bodycode} +\title[short=Les travaux de Martin \surname{Hairer}]{Martin \surname{Hairer}, + l'équation de KPZ et les structures de régularité} +\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}. +\end{dbremark} + +\subsubsection{Auteur(s)} +\label{sec-auteurs} + +Un auteur d'article est spécifié au moyen de la commande \refCom{author} +suivante. En cas d'auteurs multiples, il suffit de recourir à plusieurs +occurrences de cette commande. + +\begin{docCommand}{author}{\oarg{options}\brackets{\meta{Nom}, \meta{Prénom}}} + Cette commande, facultative, définit un auteur d'article. +\end{docCommand} +% +\begin{dbwarning}{Format des prénom et nom de l'auteur}{} + On veillera à ce que : + \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}) : + % +\begin{bodycode}[listing options={showspaces}] +"\meta{Nom}", "\meta{Prénom}" +\end{bodycode} + % + \item les éventuels accents 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) car il sera automatiquement + composé en petites capitales. + \end{enumerate} +\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{enumerate} + \item de recourir à la commande habituelle \refCom{maketitle} ; + \item de procéder à une suite de compilations\suitecompilations{} : + \begin{enumerate} + \item \hologo{pdfLaTeX} ; + \item \hologo{biber} ; + \item \hologo{pdfLaTeX}. + \end{enumerate} + \end{enumerate} +\end{dbwarning} + +\subsubsection{Auteur(s) : détails} +\label{sec-auteurs-details} + +La commande \refCom{author} admet un argument optionnel permettant, pour chaque +auteur, de spécifier un certain nombre de détails complémentaires : son affiliation, sa +photo, son email, sa page Web, sa biographie express au moyen des clés +respectives % (à séparer par des virgules) +\refKey{affiliation}, \refKey{photo}, \refKey{email}, \refKey{webpage} et +\refKey{minibio} : +\begin{bodycode} +\author[% + affiliation="\marg{affiliation(s)}",% + photo="\meta{photo}",% + email="\meta{email}",% + webpage="\meta{page Web}",% + minibio="\marg{biographie express}"% +]{"\meta{Nom}", "\meta{Prénom}"} +\end{bodycode} + +\begin{docKey}{affiliation}{={\marg{affiliation(s)}}}{pas de valeur par défaut, + initialement vide} + Cette clé permet de spécifier une ou plusieurs affiliations. En cas + d'affiliations multiples, celles-ci peuvent être séparées par la commande + \docAuxCommand*{newline}. +\end{docKey} + +\begin{docKey}{photo}{={\meta{photo}}}{pas de valeur par défaut, + initialement vide} + Cette clé permet de spécifier la photographie de l'auteur au moyen d'un + fichier image\footnote{Si ce fichier ne figure pas dans le dossier courant, il + faut faire figurer le chemin (relatif) y menant.}. +\end{docKey} + +\begin{docKey}{email}{={\meta{email}}}{pas de valeur par défaut, + initialement vide} + Cette clé permet de spécifier l'adresse courriel de l'auteur. +\end{docKey} + +\begin{docKey}{webpage}{={\meta{page Web}}}{pas de valeur par défaut, + initialement vide} + Cette clé permet de spécifier la page Web de l'auteur. +\end{docKey} + +\begin{docKey}{minibio}{={\marg{biographie express}}}{pas de valeur par défaut, + initialement vide} + Cette clé permet de spécifier la biographie express de l'auteur. +\end{docKey} + +\begin{dbwarning}{Paires d'accolades + % des clés \refKey{affiliation} et \refKey{minibio} + (relativement) obligatoires}{} + Au cas (probable) où les valeurs \meta{affiliation(s)} et \meta{biographie + express} des clés \refKey{affiliation} et \refKey{minibio} contiennent des + virgules, les paires d'accolades les entourant sont obligatoires. +\end{dbwarning} + +\begin{dbwarning}{Courriels et pages Web à saisir tels quels}{} + Les valeurs \meta{email} et \meta{webpage} des clés \refKey{email} et + \refKey{webpage} doivent être saisies telles quelles, sans recours aucun aux + commandes \refCom{url}, \docAuxCommand{href} ou assimilées des packages + \package{url} ou \package{hyperref}. +\end{dbwarning} + +\begin{dbremark}{Affichage des détails complémentaires sur les auteurs}{} + Pour que les détails complémentaires précédents soient affichés, il est + nécessaire de recourir aux commandes \refCom{printauthorsdetails} ou + \refCom{printbibliography}, destinées à être utilisées en fin d'article. + + Ces commandes affichent également d'éventuels remerciements à spécifier au + moyen de la commande \refCom{acknowledgements} suivante. +\end{dbremark} + +\begin{docCommand}{acknowledgements}{\marg{remerciements}} + Cette commande, facultative, permet de spécifier des \meta{remerciements} pour + un article. +\begin{bodycode} +\acknowledgements{% + L'auteur remercie Frédéric Patras, pour les nombreuses discussions qu'il + a eues avec lui sur le sujet. Il remercie également le relecteur anonyme, + qui a lu le texte avec un très grand soin, et dont les commentaires et + suggestions ont été très utiles.% +} +\end{bodycode} +\end{docCommand} + +\subsubsection{Résumé} +\label{sec-resume} + +\begin{docEnvironment}[doclang/environment content=résumé]{abstract}{} + Cet environnement, facultatif, est destiné à recevoir le \meta{résumé} de + l'article. +\end{docEnvironment} + +\subsection{Production du titre de l'article} +\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}. + +\begin{docCommand}[doc description=\mandatory]{maketitle}{} + Cette commande \emph{produit} l'affichage du \enquote{titre} de l'article, + c'est-à-dire : + \begin{itemize} + \item son titre et son éventuel sous-titre (commandes \refCom{title} et + \refCom{subtitle}) ; + \item son ou ses éventuels auteurs, sous la forme de leurs noms et + prénoms\footnote{Les prénoms sont alors abrégés au moyen de leurs + initiales.} (commande(s) \refCom{author}) ; + \item son éventuel résumé (environnement \refEnv{abstract}). + \end{itemize} +\end{docCommand} + +L'exemple suivant\footnote{Les commandes \refCom{surname} et \refCom{enquote} + qui y figurent sont documentées plus loin.} illustre la plupart des commandes +et options vues jusqu'ici. + +\begin{bodycode} +\title[short=Les travaux de Manjul \surname{Bhargava}]{Manjul \surname{Bhargava}, + anneaux de petit rang et courbes elliptiques} +% +\author[% + affiliation={% + Univ. Bordeaux, IMB, UMR 5251, F-33400 Talence, France\newline% + CNRS, IMB, UMR 5251, F-33400 Talence, France\newline% + INRIA, F-33400 Talence, France% + },% + photo=Belabas,% + email=Karim.Belabas@math.u-bordeaux.fr,% + minibio={% + Karim Belabas est professeur à l'université de Bordeaux. Ses centres + d'intérêts sont la théorie des nombres sous toutes ses formes et le calcul + formel. Il développe le système libre PARI/GP.% + }% +]{Belabas, Karim} +% +\author[% + affiliation={% + Laboratoire de Mathématiques de Besançon, Facultés des sciences et techniques, + CNRS, UMR 6623, 16 route de Gray, 25030 Besançon, France% + },% + photo=Delaunay,% + email=Christophe.Delaunay@univ-fcomte.fr,% + minibio={% + Christophe Delaunay est professeur à l'université de Franche-Comté et membre + du laboratoire de mathématiques de Besançon. Il est spécialiste de théorie des + nombres.% + }% +]{Delaunay, Christophe} +% +\begin{abstract} + Manjul Bhargava a reçu la médaille Fields au congrès international de Séoul + \enquote{pour avoir développé de nouvelles méthodes en géométrie des nombres, + qu'il a appliquées au comptage des anneaux de petit rang et pour borner le + rang moyen de courbes elliptiques}. Cet article est un survol d'une partie + de ses travaux. +\end{abstract} +% +\maketitle +\end{bodycode} + +\subsection{Affichage des détails complémentaires sur les auteurs} + +\begin{docCommand}{printauthorsdetails}{} + Cette commande, facultative, \emph{produit} l'affichage : + \begin{itemize} + \item des détails complémentaires sur les auteurs (options + \refKey{affiliation}, \refKey{photo}, \refKey{email}, \refKey{webpage} et + \refKey{minibio}) ; + \item des éventuels remerciements (commande \refCom{acknowledgements}) ; + \end{itemize} + tels que définis à la \vref{sec-auteurs-details}. +\end{docCommand} + +\begin{dbwarning}{Commande \protect\docAuxCommand*{printauthorsdetails} inutile + en cas de bibliographie}{} + En cas de bibliographie (cf. commande \refCom{printbibliography}), l'usage de + la commande \refCom{printauthorsdetails} est inutile car l'affichage des + détails complémentaires sur les auteurs est alors automatique. +\end{dbwarning} + +\section{Article sans auteur mais avec signature \enquote{académique}} +\label{sec-article-sans-auteur} + +Les articles standard précédents sont écrits par une ou plusieurs personnes +physiques clairement identifiées en tant qu'auteurs. + +D'autres types d'articles n'ont pas véritablement d'auteurs mais sont plutôt +\enquote{signés} par, par exemple, un comité. Pour ce type d'article, on ne +recourra pas à la commande \refCom{author}, mais plutôt à la commande +\refCom{academicsignature} suivante. + +\begin{docCommand}{academicsignature}{\marg{signature}} + Cette commande permet de spécifier une \meta{signature} académique. +\begin{bodycode} +\academicsignature{% + Au nom du comité éditorial, Serge Nicaise (éditeur en chef) et Nicolas + Wicker (directeur technique).% +} +\end{bodycode} +\end{docCommand} + +\begin{dbwarning}{Commande \protect\docAuxCommand*{academicsignature} à effet \enquote{immédiat}}{} + La commande \refCom{author} \enquote{prépare} un auteur qui n'est affiché que + là où est employée la commande \refCom{maketitle}. Au contraire, la commande + \refCom{academicsignature} affiche \enquote{immédiatement} la \meta{signature} + passée en argument. +\end{dbwarning} + +\section{Articles de type \enquote{entretien}} +\label{sec-entretiens} + +Les entretiens sont caractérisés par l'alternance de questions et de +réponses. Les questions, qui doivent être composées de façon spécifique, sont +à passer en argument de la commande \refCom{question} suivante. + +\begin{docCommand}{question}{\marg{question}} + Cette commande permet de spécifier une \meta{question}. +\end{docCommand} + +\begin{dbremark}{Composition des réponses aux questions}{} + Les réponses aux questions ne nécessitant pas de mise en page particulière, + elles seront insérées telles quelles. +\end{dbremark} + +\begin{bodycode} +\question{Ton sujet principal est celui des systèmes dynamiques, mais quels + sont les autres thèmes qui t'intéressent ?} + +L'étude des systèmes dynamiques est un sujet qui peut être abordé de façon les +plus diverses. Certains les considèrent d'un point de vue combinatoire, +d'autres sont plus axés sur les probabilités ou encore sur l'analyse. [...] +Mais si mes capacités d'analystes n'avaient pu se réaliser dans les systèmes +dynamiques j'aurais fait autre chose. + +\question{Parmi ses lauréats de cette édition, on compte deux dynamiciens : + Maryam Mirzakhani et toi. Quelles sont les différences entre vos + approches ?} + +Ces travaux sont principalement concentrés sur un objet lié aux échanges +d'intervalles : le flot de Teichmüller. [...] +\end{bodycode} + +\begin{dbwarning}{Insertion manuelle d'espacements inutile}{} + On évitera de modifier l'agencement des questions et réponses en insérant + manuellement des espacements horizontaux ou verticaux + (\docAuxCommand*{hspace}, \docAuxCommand*{hskip}, \docAuxCommand*{vspace}, + \docAuxCommand*{vskip}, etc.). +\end{dbwarning} + +Les entretiens sont des articles en général sans auteur mais les personnes ayant +recueilli les propos peuvent être signalées dans le résumé (cf. environnement +\refEnv{abstract}), par exemple ainsi : + +\begin{bodycode} +\title{Entretien avec Artur \surname{Avila}} +\begin{abstract} + Propos recueillis à Séoul, pendant l'ICM, par Boris Adamczewski et Gaël Octavia. +\end{abstract} +\maketitle +\end{bodycode} + +\section{Outils communs à tous types d'articles, fournis par \texorpdfstring{\gztauthor}{la classe}} +\label{sec-outils-communs-tous} + +Cette section donne une liste exhaustive des outils (commandes et +environnements) fournis par la \gztauthorcl. + +\subsection{Images, tableaux et cadres} +\label{sec-images-tableaux} + +La \gztauthorcl{} fournit des environnements : +\begin{itemize} +\item spécifiques aux images et tableaux, respectivement : + \begin{itemize} + \item \refEnv{gztfigure} et \refEnv{gztfigure*} ; + \item \refEnv{gzttable} et \refEnv{gzttable*} ; + \end{itemize} +\item plus neutres permettant de placer du contenu dans des cadres : + \refEnv{gztframe} et \refEnv{gztframe*}. +\end{itemize} + +% Les images et tableaux destinés à illustrer ou à synthétiser un article doivent +% être insérés dans les environnements : +% \begin{itemize} +% \item \refEnv{gztfigure}, \refEnv{gztfigure*} ; +% \item \refEnv{gzttable}, \refEnv{gzttable*} ; +% \end{itemize} +% analogues, décrits dans cette section. +% +% La \gztauthorcl{} fournit en outre les environnements plus neutres +% \refEnv{gztframe} et \refEnv{gztframe*} qui permettent de placer du contenu dans +% des cadres. + +Tous ces environnements acceptent des options décrites \vref{sec-options-gzt}. + +\subsubsection{Images} +\label{sec-images} + +Une image est incluse au moyen : +\begin{itemize} +\item soit de la commande standard \docAuxCommand{includegraphics}\footnote{Il + est possible de passer à cette commande toutes ses options définies par le + \Package{graphicx}.} ; +\item soit de code \LaTeX{} de création de dessins\footnote{Cf. par exemple les + packages \package{TikZ} et dérivés.} ; +\end{itemize} +à insérer dans l'un des deux environnements \refEnv{gztfigure} et +\refEnv{gztfigure*} suivants. + +\begin{docEnvironment}[doclang/environment content=image]{gztfigure}{\oarg{option(s)}} + Cet environnement insère l'image : + \begin{itemize} + \item \emph{à l'emplacement où il est utilisé} ; + \item dans un cadre de largeur la ligne courante, donc notamment de la largeur + de la ligne d'une colonne en mode bi-colonne. + \end{itemize} +\end{docEnvironment} + +\begin{docEnvironment}[doclang/environment content=image]{gztfigure*}{\oarg{option(s)}} + Cet environnement insère l'image : + \begin{itemize} + \item en haut de la page où il a été employé, donc probablement \emph{pas} + à l'emplacement où il est utilisé (il s'agit d'une figure + \enquote{flottante}) ; + \item dans un cadre de largeur celle de l'empagement, donc à cheval sur les + deux colonnes en mode bi-colonne. + \end{itemize} +\end{docEnvironment} + +\subsubsection{Tableaux} +\label{sec-tableaux} + +Un tableau est créé au moyen de l'environnement standard +\docAuxEnvironment{tabular}\footnote{Il est recommandé de faire usage du + \Package*{booktabs} pour produire des tableaux plus lisibles.} mais celui-ci +doit être employé dans l'un des deux environnements \refEnv{gzttable} et +\refEnv{gzttable*} suivants. + +\begin{docEnvironment}[doclang/environment content=tableau créé avec \docAuxEnvironment{tabular}]{gzttable}{\oarg{option(s)}} + Cet environnement insère le tableau : + \begin{itemize} + \item \emph{à l'emplacement où il est utilisé} ; + \item dans un cadre de largeur la ligne courante, donc notamment de la largeur + de la ligne d'une colonne en mode bi-colonne. + \end{itemize} +\end{docEnvironment} + +\begin{docEnvironment}[doclang/environment content=tableau créé avec \docAuxEnvironment{tabular}]{gzttable*}{\oarg{option(s)}} + Cet environnement insère le tableau : + \begin{itemize} + \item en haut de la page où il a été employé, donc probablement \emph{pas} + à l'emplacement où il est utilisé (il s'agit d'un tableau + \enquote{flottant}) ; + \item dans un cadre de largeur celle de l'empagement, donc à cheval sur les + deux colonnes en mode bi-colonne. + \end{itemize} +\end{docEnvironment} + +\subsubsection{Cadres} +\label{sec-cadres} + +Le contenu +% \footnote{Notamment des images et, le cas échéant, des tableaux.} +devant être encadré mais sans être estampillé \enquote{Figure} ou +\enquote{Tableau} le sera au moyen de l'un des deux environnements +\refEnv{gztframe} et \refEnv{gztframe*} suivants. + +\begin{docEnvironment}[doclang/environment content=contenu à encadrer]{gztframe}{\oarg{option(s)}} + Cet environnement insère le \meta{contenu à encadrer} : + \begin{itemize} + \item \emph{à l'emplacement où il est utilisé} ; + \item dans un cadre + \begin{itemize} + \item de largeur la ligne courante, donc notamment de la largeur de la ligne + d'une colonne en mode bi-colonne ; + \item pourvu d'une zone de titre seulement si un titre est spécifié au moyen de + la clé \refKey{title}. + \end{itemize} + \end{itemize} +\end{docEnvironment} + +\begin{docEnvironment}[doclang/environment content=contenu à encadrer]{gztframe*}{\oarg{option(s)}} + Cet environnement insère le \meta{contenu à encadrer} : + \begin{itemize} + \item en haut de la page où il a été employé, donc probablement \emph{pas} + à l'emplacement où il est utilisé (il s'agit d'un cadre + \enquote{flottant}) ; + \item dans un cadre : + \begin{itemize} + \item de largeur celle de l'empagement, donc à cheval sur les deux colonnes + en mode bi-colonne ; + \item pourvu d'une zone de titre seulement si un titre est spécifié au moyen de + la clé \refKey{title}. + \end{itemize} + \end{itemize} +\end{docEnvironment} + +\subsubsection{Options} +\label{sec-options-gzt} + +Les environnements +\begin{itemize} +\item \refEnv{gztfigure} et \refEnv{gztfigure*} ; +\item \refEnv{gzttable} et \refEnv{gzttable*} ; +\end{itemize} +admettent en argument optionnel : +\begin{itemize} +\item la plupart des (très nombreuses) options de l'environnement + \docAuxEnvironment{tcolorbox} du \Package*{tcolorbox}. On retiendra notamment + les options suivantes : +\begin{docKey}{title}{=\meta{titre}}{pas de valeur par défaut, + initialement vide} + Cette clé permet de spécifier l'éventuel \meta{titre} (ou légende). +\end{docKey} +\begin{docKey}{label}{=\meta{label}}{pas de valeur par défaut, initialement + vide} + Cette clé permet de spécifier l'éventuel \meta{label} de l'image ou du + tableau\footnote{Option sans objet pour les environnements + \protect\refEnv{gztframe} et \protect\refEnv{gztframe*}.} de sorte à y faire + référence, notamment au moyen de la commande \refCom{vref}. +\end{docKey} +\item la clé \refKey{copyright} suivante : + \begin{docKey}{copyright}{=\meta{titulaire}}{pas de valeur par défaut, + initialement vide} + Cette clé permet de spécifier un éventuel \meta{titulaire} de + \emph{copyright}. +\end{docKey} +\end{itemize} + +Les exemples suivants illustrent les environnements et options qui viennent +d'être vus. +\begin{bodycode}[listing options={deletekeywords={[1]{exemple,title,label}},morekeywords={[2]{title,label}}}] +L'exemple avec $a=-1$ et $b=0$ donne la courbe de la \vref{elliptique}. +% +\begin{gztfigure}[title=Courbe elliptique correspondant à l'équation + $y^2=x^3-x$,label=elliptique] + \includegraphics[width=\linewidth]{courbe-elliptique} +\end{gztfigure} +\end{bodycode} + +\begin{bodycode}[listing options={morekeywords={[2]title,label},deletekeywords={[3]section}}] +En analysant les chiffres des \vref{recru-mc-25,recru-mc-26} correspondant au +recrutement des maîtres de conférences, on voit que la proportion des femmes +recrutées est [...] +% +\begin{gzttable*}[label=recru-mc-25,title=Recrutement des maîtres de + conférences section 25] + \begin{tabular}{|l|cccccc|} + \hline + & 2008 & 2009 & 2010 & 2011 & 2012 & 2013 \\ \hline + [...] + \end{tabular} +\end{gzttable*} +% +\begin{gzttable*}[label=recru-mc-26,title=Recrutement des maîtres de + conférences section 26] + \begin{tabular}{|l|cccccc|} + \hline + & 2008 & 2009 & 2010 & 2011 & 2012 & 2013 \\ \hline + [...] + \end{tabular} +\end{gzttable*} +\end{bodycode} + +\begin{dbremark}{Zone de titre des figures, tableaux et cadres employés sans + option \refKey{title}}{} + Si l'option \refKey{title} n'est pas employée, la zone de titre : + \begin{itemize} + \item contient néanmoins le titre récurrent \enquote{Figure} ou + \enquote{Tableau} avec les environnements respectivement : + \begin{itemize} + \item \refEnv{gztfigure} et \refEnv{gztfigure*} ; + \item \refEnv{gzttable} et \refEnv{gzttable*} ; + \end{itemize} + \item est absente avec les environments \refEnv{gztframe} et \refEnv{gztframe*} + \end{itemize} +\end{dbremark} + +\subsection{Bibliographie} +\label{sec-bibliographie} + +Pour composer les bibliographies, la \gzt{} recourt aux outils modernes que sont +le \Package*{biblatex} et le moteur \hologo{biber}. Leur usage est détaillé dans +\autocite{Bitouze} et peut être brièvement résumé comme suit. +\begin{enumerate} +\item Construire, dans un \meta{fichier bibliographique}\footnote{De tels + fichiers sont d'extension \file{.bib}.}, une base bibliographique. + + Nous conseillons pour ce faire de recourir à un logiciel dédié, par exemple + \href{http://jabref.sourceforge.net/}{\program{JabRef}} + à configurer\footnote{La version décrite ici est la 3.2.} en se rendant + dans le menu : + \begin{itemize} + \item \enquote{\menuentry{File}} et en sélectionnant \enquote{\menuentry{BibLaTeX mode}} ; + \item \enquote{\menuentry{Options>Preferences}} puis dans l'onglet \enquote{\menuentry{General}}, + en choisissant \enquote{\menuentry{UTF8}} dans la liste déroulante \enquote{\menuentry{Default + encoding}}\footnote{On pourra en profiter pour changer la langue de + l'interface dans la liste déroulante \enquote{\menuentry{Language}}.}. + \end{itemize} + + On n'oubliera pas de donner à chaque entrée bibliographique une \meta{clé} + permettant de l'identifier de façon unique dans la base + bibliographique\footnote{Sous \program{JabRef}, on pourra se faire aider pour + cela par l'icône en forme de \enquote{baguette magique}.}. +\item Dans le fichier source \file{.tex} : + \begin{enumerate} + \item \emph{En préambule}, utiliser la commande \docAuxCommand{addbibresource} + pour indiquer le \meta{fichier bibliographique} à considérer : +\begin{preamblecode}[listing options={moretexcs={addbibresource}}] +\addbibresource{"\meta{fichier bibliographique}".bib} +\end{preamblecode} + \item Dans le corps du document, utiliser la commande + \docAuxCommand{autocite}\footnote{De préférence à la commande + \docAuxCommand{cite}.} du \Package*{biblatex} pour citer les références + bibliographiques (pourvue d'une \meta{clé}) : +\begin{bodycode}[listing options={moretexcs={autocite}}] +\autocite{"\meta{clé}"} +\end{bodycode} + \item À la fin du document, faire figurer la liste des références + bibliographiques au moyen de la commande \refCom{printbibliography} + suivante. + \end{enumerate} +\item Procéder à une suite de compilations \hologo{pdfLaTeX}, \hologo{biber} et + \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}. + Cette commande est fournie sous deux formes, non étoilée et étoilée : + \begin{description} + \item[sous sa forme non étoilée :] elle affiche, en sus des références bibliographiques, + les \hyperref[sec-auteurs-details]{détails complémentaires sur les auteurs} + (s'ils ont été renseignés) ; + \item[sous sa forme étoilée :] elle n'affiche que les références bibliographiques. + \end{description} +\end{docCommand} + +\subsection{Commandes diverses} +\label{sec-commandes-diverses} + +La \gztauthorcl{} fournit des commandes généralistes ou propres aux +mathématiques destinées à faciliter la saisie d'un article à paraître dans la +\gzt{}. + +\subsubsection{Commandes généralistes} +\label{sec-comm-gener} + +\begin{docCommand}{smf}{} + Cette commande produit l'acronyme \textsc{smf} de la Société Mathématique de + France. +\end{docCommand} + +\begin{docCommand}{gzt}{} + Cette commande : + \begin{description} + \item[sous sa forme non étoilée :] produit l'abréviation \enquote{\gzt}. + \item[sous sa forme étoilée :] produit la forme complète \enquote{\gzt*}. + \end{description} +\end{docCommand} + +\begin{docCommand}{cad}{} + Cette commande : + \begin{description} + \item[sous sa forme non étoilée :] produit l'abréviation \enquote{c.-à-d.}. + \item[sous sa forme étoilée :] produit la forme complète + \enquote{c'est-à-dire}. + \end{description} +\end{docCommand} + +\begin{docCommand}{Cad}{} + Cette commande : + \begin{description} + \item[sous sa forme non étoilée :] produit l'abréviation \enquote{C.-à-d.}. + \item[sous sa forme étoilée :] produit la forme complète + \enquote{C'est-à-dire}. + \end{description} +\end{docCommand} + +\begin{docCommand}{surname}{\marg{nom de famille}} + Cette commande compose le \meta{nom de famille} en petites capitales. + \begin{dbwarning}{Petites capitales : à employer avec parcimonie}{} + \begin{itemize} + \item De manière générale, quand elles sont appliquées aux noms de + personnes, les petites capitales doivent ne s'appliquer qu'au nom de + famille, et notamment \emph{pas} aux prénoms. + \item Pour un article de la \gzt{}, on évitera d'appliquer systématiquement + les petites capitales (et donc la commande \refCom{surname}) à tous les + noms de famille : on les réservera aux noms d'auteurs, notamment à ceux + spécialement mis à l'honneur, par exemple s'ils figurent dans le titre + d'un article. + \end{itemize} + \end{dbwarning} +\end{docCommand} + +\begin{docCommand}{century}{\marg{numéro}} + Cette commande affiche le \meta{numéro}\footnote{Ce numéro doit être un nombre + entier relatif non nul.} ordinal d'un siècle en chiffre romain composé en + petites capitales, suivi du suffixe constitué, selon que la langue en cours + est le français ou l'anglais : + \begin{itemize} + \item du mot \enquote{siècle} puis, si \meta{numéro} $<0$, de l'expression + \enquote{avant J.-C.}\footnote{Sauf si le caractère qui suit est un point, + auquel cas l'expression est \enquote{avant J.-C}.} ; + \item du mot \enquote{century} puis, si \meta{numéro} $<0$, de l'expression + \enquote{BC}. + \end{itemize} + Ainsi : +\begin{bodycode}[listing and text] +Au \century{8}, [...]. Auparavant, au \century{1}, [...]. Il en fût de même au +\century{-3} et au \century{-2}. +\end{bodycode} + Cette commande dispose également d'une version étoilée ne faisant figurer + le suffixe que si \meta{numéro} $<0$, à utiliser par exemple dans un cas tel + que le suivant : +\begin{bodycode}[listing and text] +Toute la poésie du \century*{19} mérite d'être lue. +\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{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. + \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. +\end{bodycode} + et : +\begin{bodycode}[listing and text] +On soupçonne que non \aside*{par exemple on s'attend à ce que $1/\pi$ ne +soit pas une période}. +\end{bodycode} +\end{docCommand} + +% ^^A smf,cad,Cad,gzt,century,aside + +\subsubsection{Commandes propres aux mathématiques} +\label{sec-comm-propr-aux} + +La \gztauthorcl{} : +\begin{itemize} +\item charge les 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*{mathrsfs} qui fournit de jolies lettres calligraphiques (via + la commande \docAuxCommand{mathscr}) ; + \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. +\end{itemize} + +\paragraph{Ensembles courants} + +\begin{docCommand}{N}{} + Cette commande affiche l'ensemble des nombres entiers positifs : + \enquote{$\mathbb{N}$}. +\end{docCommand} + +\begin{docCommand}{Z}{} + Cette commande affiche l'ensemble des nombres entiers relatifs : + \enquote{$\mathbb{Z}$}. +\end{docCommand} + +\begin{docCommand}{D}{} + Cette commande affiche l'ensemble des nombres décimaux : + \enquote{$\mathbb{D}$}. +\end{docCommand} + +\begin{docCommand}{Q}{} + Cette commande affiche l'ensemble des nombres rationnels : + \enquote{$\mathbb{Q}$}. +\end{docCommand} + +\begin{docCommand}{R}{} + Cette commande affiche l'ensemble des nombres réels : \enquote{$\mathbb{R}$}. +\end{docCommand} + +\begin{docCommand}{C}{} + Cette commande affiche l'ensemble des nombres complexes : + \enquote{$\mathbb{C}$}. +\end{docCommand} + +\begin{docCommand}{K}{} + Cette commande peut être utilisée pour dénoter un corps quelconque. Elle + affiche \enquote{$\mathbb{K}$}. +\end{docCommand} + +\paragraph{Fonctions trigonométriques circulaires et hyperboliques, directes et + réciproques} + +\begin{docCommand}{cotan}{} + Cette commande affiche la cotangente : \enquote{$\cotan$}. +\end{docCommand} + +\begin{docCommand}{arccos}{} + Cette commande affiche (la détermination principale de) l'arc cosinus : + \enquote{$\arccos$} ou + \enquote{\selectlanguage{english}$\arccos$\selectlanguage{french}} selon que + la langue en cours est le français ou l'anglais. +\end{docCommand} + +\begin{docCommand}{arcsin}{} + Cette commande affiche (la détermination principale de) l'arc sinus : + \enquote{$\arcsin$} ou + \enquote{\selectlanguage{english}$\arcsin$\selectlanguage{french}} selon que + la langue en cours est le français ou l'anglais. +\end{docCommand} + +\begin{docCommand}{arctan}{} + Cette commande affiche (la détermination principale de) l'arc tangente : + \enquote{$\arctan$} ou + \enquote{\selectlanguage{english}$\arctan$\selectlanguage{french}} selon que + la langue en cours est le français ou l'anglais. +\end{docCommand} + +\begin{docCommand}{ch}{} + Cette commande affiche le cosinus hyperbolique : \enquote{$\ch$}. +\end{docCommand} + +\begin{docCommand}{sh}{} + Cette commande affiche le sinus hyperbolique : \enquote{$\sh$}. +\end{docCommand} + +\begin{docCommand}{tanh}{} + Cette commande affiche la tangente hyperbolique : \enquote{$\tanh$} ou + \enquote{\selectlanguage{english}$\tanh$\selectlanguage{french}} selon que la + langue en cours est le français ou l'anglais. + \begin{dbremark}{Pas de commande \protect\lstinline+\\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. + \end{dbremark} +\end{docCommand} + +\paragraph{Fonctions diverses} + +\begin{docCommand}{log}{} + Cette commande : + \begin{description} + \item[sous sa forme non étoilée :] produit \enquote{$\log$}. + \item[sous sa forme étoilée :] produit \enquote{$\log*$}. + \end{description} +\end{docCommand} + +\begin{docCommand}{lg}{} + Cette commande : + \begin{description} + \item[sous sa forme non étoilée :] produit \enquote{$\lg$}. + \item[sous sa forme étoilée :] produit \enquote{$\lg*$}. + \end{description} +\end{docCommand} + +\paragraph{Théorèmes et objets analogues} + +Pour faciliter la composition des théorèmes et objets analogues, la +\gztauthorcl{} fournit des environnements prêts à l'emploi et permet d'en créer +de nouveaux si besoin est (cf. commande \refCom{newtheorem}). + +Le \vref{env-theorems} liste les théorèmes et objets analogues disponibles +% +avec : +\begin{description} +\item[en colonne~1] le nom de l'environnement \LaTeX{} correspondant, et son + éventuel alias (utilisables indifféremment) ; +\item[en colonne~2] les titres récurrents correspondants selon que la langue en + cours est le français ou l'anglais. +\end{description} + +\begin{gzttable}[label=env-theorems,title=Environnements de type \enquote{théorème} fournis] + \begin{tabular}{llll} + \multicolumn{2}{c}{Environnement} & \multicolumn{2}{c}{Titre} \\ + Nom & Alias & En français & En anglais \\\toprule + |theoreme| & |theorem| & Théorème & Theorem \\\midrule + |corollaire| & |corollary| & Corollaire & Corollary \\\midrule + \multicolumn{2}{c}{\lstinline+conjecture+} & \multicolumn{2}{c}{Conjecture} \\\midrule + \multicolumn{2}{c}{\lstinline+proposition+} & \multicolumn{2}{c}{Proposition} \\\midrule + |lemme| & |lemma| & Lemme & Lemma \\\midrule + |axiome| & |axiom| & Axiome & Axiom \\\midrule\midrule + \multicolumn{2}{c}{\lstinline+definition+} & Définition & Definition \\\midrule + |remarque| & |remark| & Remarque & Remark \\\midrule + |exemple| & |example| & Exemple & Example \\\midrule + \multicolumn{2}{c}{\lstinline+notation+} & \multicolumn{2}{c}{Notation} \\\midrule + |preuve| & |proof| & Preuve & Proof \\\bottomrule + \end{tabular} +\end{gzttable} + +\begin{dbremark}{\enquote{Théorèmes} non numérotés : versions étoilées des + environnements}{} + Tous les environnements \LaTeX{} du \vref{env-theorems} admettent une version + étoilée produisant des occurrences \emph{non} numérotées du \enquote{théorème} + correspondant. +\end{dbremark} + +Ces environnements s'emploient de façon classique, c'est-à-dire comme tout +environnement \LaTeX{}. Ils disposent cependant d'un argument optionnel +permettant de préciser le \enquote{théorème}, par exemple en spécifiant son +auteur. + +\begin{bodycode}[listing and text] +\begin{theorem} + Tout espace métrisable séquentiellement compact est 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\Z$ +\end{definition} +\begin{remark*} + \[ + 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. +\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 \gztauthorcl{} fournit effectivement trois styles de +\enquote{théorèmes}, \docValue{theorem}, \docValue{definition} et +\docValue{proof}, dont les caractéristiques sont indiquées au +\vref{env-theorems-styles}. + +\begin{gzttable}[label=env-theorems-styles,title=Styles de \enquote{théorèmes} fournis] +\begin{tabular}{lp{3cm}p{3cm}p{5.5cm}} +Style & Titre récurrent & Contenu & Théorèmes concernés \\\toprule +\docValue{theorem} & gras & italique + & théorèmes, corollaires, conjectures, propositions, lemmes, axiomes \\\midrule +\docValue{definition} & gras & romain & définitions, remarques, exemples, notations \\\midrule +\docValue{proof} & italique, non gras, non numéroté & romain, terminé par un carré blanc & preuves \\\bottomrule +\end{tabular} +\end{gzttable} + +% \begin{description} +% \item[\docValue{theorem} :]\ +% \begin{enumerate} +% \item le titre récurrent (et l'éventuelle précision) est en gras ; +% \item le contenu est en italique. +% \end{enumerate} +% Ce style est appliqué aux environnements \enquote{de type théorème}, \cad*{} +% les théorèmes, corollaires, conjectures, propositions, lemmes et axiomes. +% \item[\docValue{definition} :]\ +% \begin{enumerate} +% \item le titre récurrent (et l'éventuelle précision) est en gras ; +% \item le contenu \emph{n'est pas} en italique. +% \end{enumerate} +% Ce style est appliqué aux environnements \enquote{de type définition}, \cad*{} +% les définitions, remarques, exemples et notations. +% \item[\docValue{proof} :]\ +% \begin{enumerate} +% \item le titre récurrent (et l'éventuelle précision) \emph{n'est pas} en gras, +% est en italique et n'est \emph{jamais} numéroté ; +% \item le contenu \emph{n'est pas} en italique et se termine par un carré noir +% en fin de ligne. +% \end{enumerate} +% Ce style est appliqué aux environnements \enquote{de type preuve}, +% \cad*{}... les preuves. +% \end{description} + +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. + +\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{itemize} + \item le titre récurrent est \meta{Nom}\footnote{\Cad*{}, quelle que soit la + langue en cours, le \meta{nom} de l'environnement \LaTeX{} dont l'initiale + est en majuscule.} ; + \item le style est \docValue{theorem}. + \end{itemize} + Cette commande crée également l'environnement \meta{nom}* produisant des + occurrences \emph{non} numérotées de ce \enquote{théorème}. + + Si les valeurs par défaut du titre récurrent (\meta{Nom}) ou du style + (\docValue{theorem}) ne conviennent pas, il suffit spécifier celles souhaitées + en \meta{option(s)} au moyen des clés \refKey{frenchtitle}, + \refKey{englishtitle} et \refKey{style} suivantes. + \begin{docKey}{frenchtitle}{={\meta{titre récurrent en français}}}{pas de + valeur par défaut, initialement vide} + Cette clé permet de spécifier un \meta{titre récurrent en français} + différent de \meta{Nom}. + \end{docKey} + \begin{docKey}{englishtitle}{={\meta{titre récurrent en anglais}}}{pas de + valeur par défaut, initialement vide} + Cette clé permet de spécifier un \meta{titre récurrent en anglais} différent + de \meta{Nom}. + \end{docKey} + \begin{docKey}{style}{=\docValue{theorem}\textbar\docValue{definition}\textbar\docValue{proof}}{pas + de valeur par défaut, initialement \docValue{theorem}} + Cette clé permet de spécifier le style du \enquote{théorème} à créer, au + moyen des valeurs \docValue{theorem}, \docValue{definition} et + \docValue{proof}. + \end{docKey} + +\newtheorem{article} +\newtheorem[frenchtitle=Fait,style=definition]{fact} +\begin{preamblecode}[listing options={deletekeywords={[1]{definition}},morekeywords={[3]{definition}}}] +\newtheorem{article} +\newtheorem[frenchtitle=Fait,style=definition]{fact} +\end{preamblecode} +\begin{bodycode}[listing and text] +\begin{article}[dit premier] +Les hommes naissent et demeurent libres et égaux en droits\ldots{} +\end{article} +\begin{fact*} +Tout ce qui est rare est cher. +\end{fact*} +\begin{fact} +Un cheval bon marché est rare. +\end{fact} +\end{bodycode} +\end{docCommand} + +\subsubsection{Code informatique} +\label{sec-commande-pour-code} + +La \gztauthorcl{} fournit des outils permettant de faire aisément figurer du +code informatique, notamment du code \LaTeX{} : +\begin{itemize} +\item l'environnement \refEnv{gztcode} pour des listings ; +\item la commande \refCom{gztverb} pour de courts extraits, notamment amenés + à figurer dans des phrases. +\end{itemize} + +\begin{docEnvironment}[doclang/environment content=listing]{gztcode}{\oarg{option(s)}} + Cet environnement permet de faire figurer un listing de code informatique dans + une boîte colorée. +\begin{bodycode}[listing and text] +Nous préconisons l'environnement \verb|align*| : +\begin{gztcode} +\begin{align*} + a & = a\\ + b & = b +\end{align*} +\end{gztcode} +\end{bodycode} +\end{docEnvironment} + +L'environnement \refEnv{gztcode} admet en argument optionnel la plupart des +(très nombreuses) options de l'environnement \docAuxEnvironment{tcblisting} du +\Package*{tcolorbox}. On retiendra notamment les options suivantes. + +\begin{docKey}{title}{=\meta{titre}}{pas de valeur par défaut, + initialement vide} + Cette clé permet de donner un \meta{titre} au listing. +\begin{bodycode}[listing and text,listing options={morekeywords={[2]title}}] +Nous préconisons l'environnement \verb|align*| : +\begin{gztcode}[title=Alignement d'équations] +\begin{align*} + a & = a\\ + b & = b +\end{align*} +\end{gztcode} +\end{bodycode} +\end{docKey} + +\begin{docKey}{listing and text}{}{} + Cette clé permet de, dans la boîte colorée, faire figurer en partie : + \begin{itemize} + \item haute, le listing ; + \item basse, son résultat compilé par \LaTeX{}. + \end{itemize} + % ^^A + \begin{dbwarning}{Option \protect\refKey*{listing and text} : seulement pour + du code \LaTeX{}}{} + L'option \refKey{listing and text} n'a de sens que pour un listing de code + \LaTeX{}. + \end{dbwarning} +\begin{tcboutputlisting} +\begin{gztcode}[listing and text] +L'environnement \verb|eqnarray| est obsolète et nous préconisons plutôt +\verb|align| : + +\begin{minipage}[t]{0.4\linewidth} + Avec l'environnement \verb|eqnarray*| : + \begin{eqnarray*} + a & = & a\\ + b & = & b + \end{eqnarray*} +\end{minipage} +\hspace{1cm} +\begin{minipage}[t]{0.4\linewidth} + Avec l'environnement \verb|align*| : + \begin{align*} + a & = a\\ + b & = b + \end{align*} +\end{minipage} +\end{gztcode} +\end{tcboutputlisting} +L'exemple suivant illustre l'usage de cette option\conseilslatex{}. Le +code : +\tcbinputlisting{codes,listing only,listing options={deletekeywords={listing}}} +donne : +\input{\jobname.listing} +\end{docKey} + +L'environnement \refEnv{gztcode} permet d'afficher du code informatique +arbitraire. Mais, dans les listings précédents, on constate que certaines +commandes \LaTeX{} sont mises en évidence, en l'occurrence en gras. Ceci +provient du fait que l'environnement \refEnv{gztcode} est configuré pour, par +défaut, colorer syntaxiquement le code \LaTeX{}. Mais d'autres langages sont +pris en charge. + +\begin{dbremark}{Environnement \protect\refEnv*{gztcode} : pas seulement pour le + code \LaTeX{}}{} + L'environnement \refEnv{gztcode} permet de colorer syntaxiquement le code + informatique de tout langage connu du \Package*{listings}. Pour ce faire, il + suffit de le spécifier (selon la syntaxe de ce package) en argument de + l'option \refKey{listing options} suivante. +\end{dbremark} + +\begin{docKey}{listing options}{}{} + Cette clé de l'environnement \refEnv{gztcode} permet de passer au listing + toute option connue du \Package*{listings}, notamment le langage sous-jacent + au moyen de l'option \docAuxKey{language}. +\lstset{escapechar={},escapeinside={}} +\begin{bodycode}[listing and text] +\lstdefinestyle{mon-style}{% + language=Python,% + basicstyle=\ttfamily,% + keywordstyle=\color{magenta},% + commentstyle=\color{gray}\itshape,% + stringstyle=\color{cyan}% +} +% +\begin{gztcode}[listing options={style=mon-style}] +"""Calcul de la factorielle""" # En python +def factorielle(x): + if x < 2: + return 1 + else: + return x * factorielle(x-1) +\end{gztcode} +\end{bodycode} +\lstset{escapechar="} +\end{docKey} + +\begin{docCommand}{gztverb}{\marg{code}} + Cette commande permet d'afficher \emph{verbatim}\footnote{\Cad*{} tel quel, + sans être interprété par \LaTeX{}.} un (court) extrait de \meta{code} passé en + argument. + + L'exemple suivant illustre l'usage de cette commande\conseilslatex. +\begin{bodycode}[listing and text,colback=white,listing options={deletekeywords={listing},deletekeywords={[3]style}}] +Dans le cas de \LaTeX, les commandes de style de caractères \gztverb{\bf}, +\gztverb{\it}, \gztverb{\sf}, \gztverb{\tt}, \gztverb{\sc}, \gztverb{\sl}, +\gztverb{\rm} sont désormais à proscrire. Elles doivent être remplacées par +les commutateurs, respectivement \gztverb{\bfseries}, \gztverb{\itshape}, +\gztverb{\sffamily}, \gztverb{\ttfamily}, \gztverb{\scshape}, +\gztverb{\slshape}, \gztverb{\rmfamily}. +\end{bodycode} +\end{docCommand} + +\section{Autres outils communs à tous types d'articles} +\label{sec-outils-communs-tous-1} + +Cette section donne une liste d'outils (commandes et environnements) fournis par +des packages automatiquement chargés par la \gztauthorcl\footnote{La + \vref{sec-packages-charges-par} liste ceux dont les fonctionnalités peuvent + être utiles aux auteurs.}. + +\begin{dbwarning}{Liste des fonctionnalités des packages tiers non exhaustive}{} + Cette liste est \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. + \end{itemize} +\end{dbwarning} + +\subsection{Guillemets, 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. + +\begin{docCommand}{enquote}{\marg{texte}} + Cette commande compose le \meta{texte} entre guillemets, automatiquement + adaptés : + \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. + \end{itemize} +\begin{bodycode}[listing and text] +Il lui répondit: \enquote{Courteline disait: \enquote{Passer pour un idiot aux + yeux d'un imbécile est une volupté de fin gourmet.}} +\end{bodycode} +\end{docCommand} + +\begin{docCommand}{textelp}{\marg{texte}} + Cette commande est à employer pour signifier une omission, avec éventuel ajout + de \meta{texte}. + + Cf. \vref{sec-epigraphes} pour un exemple d'utilisation de cette commande. +\end{docCommand} + +(\textsc{À suivre...}) + +\subsection{Adresses Web (\enquote{\textsc{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{\textsc{url}}), +même si elles comportent des caractères spéciaux de \TeX{} (|#|, |_|, |~|, +\lstinline[commentstyle={}]+%+, |&|, etc.). + +\begin{docCommand}{url}{\marg{adresse Web}} + Cette commande affiche l'\meta{adresse Web} saisie \emph{telle + quelle}\footnote{Notamment sans faire précéder les éventuels caractères + spéciaux qu'elle contient de la commande d'échappement + \protect\lstinline+\\+.} et fait d'elle un lien hypertexte. +\begin{bodycode}[listing and text,listing options={deletekeywords={[2]{url}},deletekeywords={[1]{math}}}] +Pour plus d'information, nous renvoyons à notre site Web +\url{http://math.univ-lille1.fr/~nwejm/}. +\end{bodycode} +\begin{bodycode}[listing and text,listing options={deletekeywords={[2]{url}},deletekeywords={[1]{exemple}}}] +Par exemple, \url{www.cnrs.fr/insmi/IMG/pdf/Parite_ReunionDU290312.pdf}. +\end{bodycode} +\end{docCommand} + +\subsection{Graphiques de très haute qualité} +\label{sec-graphiques-de-tres} + +Le \Package*{pgfplots} permet de créer aisément des graphiques (de dimensions +$2$ ou $3$) de très haute qualité, que ce soit pour représenter des fonctions ou +des jeux de données. + +(\textsc{À suivre...}) + +\subsection{Références croisées} +\label{sec-references-croisees} + +Le \Package*{cleveref}, utilisé conjointement avec le \Package*{varioref}, rend la +commande \refCom{vref} de ce dernier très puissante. + +\begin{docCommand}{vref}{\marg{label}} + Cette commande affiche le numéro de la référence labellisée par \meta{label} + et : + \begin{itemize} + \item affiche (ou pas selon le contexte) la page où se situe cette + référence\footnote{Fonctionnalité fournie par le \Package{varioref}.} ; + \item détecte automatiquement la nature de la référence (section, tableau, + figure, équation, théorème, etc.) et fait précéder le numéro de celle-ci du + mot clé correspondant\footnote{Fonctionnalité fournie par le + \Package{cleveref}.} ; + \item fait de la référence un lien hypertexte\footnote{Fonctionnalité fournie + par le \Package{hyperref}.}. + \end{itemize} +\begin{bodycode}[listing and text,listing options={deletekeywords={[2]url,[1]math}}] +[...] on se reportera à la \vref{sec-canevas-de-fichier} pour un canevas de +fichier source [...] +\end{bodycode} +\end{docCommand} + +\subsection{Épigraphes} +\label{sec-epigraphes} + +Le \Package*{epigraph} permet de composer des épigraphes au moyen de la commande +\refCom{epigraph}. + +\begin{docCommand}{epigraph}{\marg{épigraphe}{\marg{source}}} + Cette commande\footnote{Légèrement redéfinie par la \gztauthorcl.} compose un + \meta{épigraphe} et sa \meta{source} (qui peut éventuellement être vide). +\end{docCommand} + +\begin{bodycode}[listing and text] +\epigraph{% + Parce qu'un secret, ce n'est pas quelque chose qui ne se raconte pas. \textelp{}% +}{% + César\\M. \textsc{Pagnol}, \emph{César}. Livre de Poche~161, p.~115% +} +\end{bodycode} + +\begin{dbremark}{Source de l'épigraphe en entrée bibliographique}{} + La source de l'épigraphe pourra faire l'objet d'une entrée bibliographique en + vue d'être citée en 2\ieme{} argument de \refCom{epigraph} au moyen de la + commande \lstinline[moretexcs={fullcite}]+\fullcite+ du \Package*{biblatex} + (cf. \vref{sec-bibliographie}).% + \footnote{% + \lstset{deletekeywords={options},deletekeywords={[2]skipbib},morekeywords={[2]{options}},morekeywords={[3]skipbib}}% + Dans le fichier \hologo{BibTeX}, on ajoutera à cette entrée la ligne + % + \protect\lstinline+options = \{skipbib\}+ + % + pour éviter que cette source figure dans la liste des + références bibliographiques.% + } +\end{dbremark} + +% Dans le source \hologo{BibTeX} de l'exemple suivant, on notera la ligne +% \lstinline|options = {skipbib}| permettant d'éviter que la source de l'épigraphe +% ne figure dans la liste des références bibliographiques. +% \begin{preamblecode}[title=Source \hologo{BibTeX}] +% @book{pagnol, +% title = {César}, +% author = {Pagnol, Marcel}, +% number = {161}, +% pages = {115}, +% series = {Livre de poche}, +% options = {skipbib} +% } +% \end{preamblecode} +% \begin{bodycode}[listing and text,listing options={deletekeywords={options,[2]number}}] +% \epigraph{Je ne peux pas vous le dire à tous à la fois, et si vite que ça. Parce +% qu'un secret, ce n'est pas quelque chose qui ne se raconte pas. Mais c'est une +% chose qu'on se raconte à voix basse, et séparément.}{César\\\fullcite{pagnol}} +% \end{bodycode} + + +\subsection{Listes en ligne} +\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 +\enquote{à puces}, \enquote{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}, \cad*{} 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 de la \gzt{} car cela pourrait + contrevenir à la marche typographique qu'elle a adoptée.}. + +\begin{docEnvironment}[doclang/environment content=liste]{itemize*}{} + Cet environnement compose une liste \enquote{à puces} en ligne. +\end{docEnvironment} + +\begin{docEnvironment}[doclang/environment content=liste]{enumerate*}{} + Cet environnement compose une liste \enquote{numérotée} en ligne. +\end{docEnvironment} + +\begin{docEnvironment}[doclang/environment content=liste]{description*}{} + Cet environnement compose une liste \enquote{de description} en ligne. +\end{docEnvironment} + +\begin{bodycode}[listing and text,listing options={deletekeywords={[1]math,[2]url}}] +\begin{enumerate} +\item Les données que j'ai rassemblées [...] +\item Les données que j'ai recueillies sont + \begin{enumerate*} + \item disponibles publiquement sur internet : [...] ; + \item accessibles par Wikipédia, [...] ; + \item pour 60 des conférenciers [...]. + \end{enumerate*} +\end{enumerate} +\end{bodycode} + +\section{Canevas de fichier source typique} +\label{sec-canevas-de-fichier} + +\newcommand{\attachfilename}{mon-article.tex}% +\newcommand{\attachfiletextlink}{Canevas de fichier source typique}% +\tcbset{listing file=\attachfilename}% +\begin{tcboutputlisting} +\documentclass{gztarticle} +% +% Indiquer le (chemin vers le) fichier .bib utilisé. +\addbibresource{.bib} +% +\begin{document} +\title{} +% \subtitle[short=]{} +% +\author[% + affiliation={% + },% + photo=,% + email=,% + webpage=,% + minibio={% + }% +]{} +% +% \acknowledgements{% +% } +% +% \begin{abstract} +% \end{abstract} +% +\maketitle +% +% Ici vient le contenu de l'article. + +% +\printbibliography % ou \printauthorsdetails +\end{document} +\end{tcboutputlisting} +% +Pour le lecteur souhaitant écrire un article pour la \gzt*{}, un modèle typique +d'article standard\footnote{Où les commandes et environnement moins fréquents + ont été mis en commentaire.} est : +\begin{itemize} +\item reproduit ci-dessous ; +\item attaché à la version \format{pdf} du présent document et atteignable par + simple clic sur l'icône ci-dessous. +\end{itemize} +% +\tcbinputlisting{% + codes, + listing only,% + listing options={moretexcs={addbibresource}},% + title={\attachfiletextlink\ \attachfile{\attachfilename}}% +} + +%%% Local Variables: +%%% mode: latex +%%% eval: (latex-mode) +%%% ispell-local-dictionary: "fr_FR" +%%% TeX-master: "../gzt-fr.tex" +%%% End: diff --git a/Master/texmf-dist/doc/latex/gzt/french/sections/notations.tex b/Master/texmf-dist/doc/latex/gzt/french/sections/notations.tex new file mode 100644 index 00000000000..666d6059a9e --- /dev/null +++ b/Master/texmf-dist/doc/latex/gzt/french/sections/notations.tex @@ -0,0 +1,138 @@ +\etocsettocdepth.toc{section}% +% +\section{Notations, syntaxe, terminologie et codes couleurs}\label{sec-synt-term-notat} + +Ce chapitre précise les notations, syntaxe, terminologie et codes couleurs de +la présente documentation. + + +\subsection{Commandes, environnements, clés, valeurs}\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 : +\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}. +\end{itemize} + +\subsection{Arguments génériques} +\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é : +\begin{itemize} +\item en fonte à chasse fixe ; +\item en italique ; +\item entre chevrons simples ; +\end{itemize} +le tout en marron, ainsi : \meta{argument générique}. + +\subsection{Liens hypertextes} +\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) : +\begin{itemize} +\item \refCom{author} ; +\item \refEnv{abstract}. +\end{itemize} + + +\subsection{Éléments \enquote{obligatoires}} +\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}. + +\subsection{Codes sources} +\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. +% 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 de couleur bleu : +\begin{itemize} +\item non ombrés s'ils doivent être saisis dans le corps du document ; +\item ombrés s'ils doivent être saisis en préambule du fichier (maître). +\end{itemize} +Ces cadres pourront en outre comporter d'éventuels titres : +\begin{multicols}{2} +\begin{bodycode} +"\meta{code source}" +\end{bodycode} +\begin{bodycode}[title=\meta{titre}] +"\meta{code source}" +\end{bodycode} +\begin{preamblecode} +"\meta{code source à insérer en préambule}" +\end{preamblecode} +\begin{preamblecode}[title=\meta{titre}] +"\meta{code source à insérer en préambule}" +\end{preamblecode} +\end{multicols} + +\subsection{Espaces dans les codes sources} +\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]+ +. + +\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 se présentent sous la forme +\meta{clé}|=|\meta{valeur} et la \meta{valeur} passée à une \meta{clé} peut +être : +%^^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: +%^^A \begin{docKey*}{option}{}{\meta{valeurs par défaut et initiale}} +%^^A \meta{Description de \refKey{option}} +%^^A \end{docKey*} +%^^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}} + \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}, \docValue*{valeur2}, ..., \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\docValue*{valeur2}\textbar...\textbar\docValue*{valeurN}}{\meta{valeurs par défaut et initiale}} + \meta{Description de \refKey{choicekey} et de ses valeurs possibles} + \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 : +\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. +\end{description} + +%%% Local Variables: +%%% mode: latex +%%% eval: (latex-mode) +%%% ispell-local-dictionary: "fr_FR" +%%% TeX-master: "../gzt-fr.tex" +%%% End: diff --git a/Master/texmf-dist/doc/latex/gzt/french/sections/packages-charges.tex b/Master/texmf-dist/doc/latex/gzt/french/sections/packages-charges.tex new file mode 100644 index 00000000000..d51dbb840b3 --- /dev/null +++ b/Master/texmf-dist/doc/latex/gzt/french/sections/packages-charges.tex @@ -0,0 +1,38 @@ +\section{Packages chargés par la classe}\label{sec-packages-charges-par} + +On a vu que, pour plusieurs de ses fonctionnalités, la \gztauthorcl{} s'appuie +sur des packages qu'elle charge automatiquement. Ceux dont les fonctionnalités +peuvent être utiles aux auteurs sont répertoriés dans la liste suivante qui +indique leur fonction et le cas échéant : +\begin{itemize} +\item la ou les options avec lesquelles ils sont chargés ; +\item les options de la \gztauthorcl{} ou leurs commandes propres permettant de les + personnaliser. +\end{itemize} +En sus des outils propres à la \gztauthorcl, tous ceux fournis par ces +différents packages sont donc à disposition des auteurs de la \gzt{}. + +\begin{description} +\item[\package{xcolor} :] couleurs ; + \begin{description} + \item[option par défaut :] \docAuxKey{table} et \docAuxKey{cmyk} ; + \end{description} +\item[\package{kpfonts} :] police principale du document ; + \begin{description} + \item[option par défaut :] \docAuxKey{sfmath}, \docAuxKey{easyscsl}, + \docAuxKey{noDcommand} ; + \end{description} +\item[\package*{graphicx} :] inclusion d'images ; +\item[\package*{csquotes} :] citations formelles et informelles ; + \begin{description} + \item[option par défaut :] \docAuxKey{autostyle} ; + \end{description} +\item[...] (à suivre). +\end{description} + +%%% Local Variables: +%%% mode: latex +%%% eval: (latex-mode) +%%% ispell-local-dictionary: "fr_FR" +%%% TeX-master: "../gzt-fr.tex" +%%% End: diff --git a/Master/texmf-dist/doc/latex/gzt/french/sections/todo.tex b/Master/texmf-dist/doc/latex/gzt/french/sections/todo.tex new file mode 100644 index 00000000000..0a266c3d2ba --- /dev/null +++ b/Master/texmf-dist/doc/latex/gzt/french/sections/todo.tex @@ -0,0 +1,15 @@ +\chapter{To do} +\label{cha:do} + +% \begin{enumerate} +% \item Revoir les pointillés de la 2\ieme{} de couverture avec le \Pkg{TikZ} (au +% moyen de quelque chose comme : +% \verb|\tikz \draw[dotted] (0pt,0pt) -- (50pt,0pt);|). +% \end{enumerate} + +%%% Local Variables: +%%% mode: latex +%%% eval: (latex-mode) +%%% ispell-local-dictionary: "fr_FR" +%%% TeX-master: "../gzt-fr.tex" +%%% End: diff --git a/Master/texmf-dist/doc/latex/gzt/gzt-fr.bib b/Master/texmf-dist/doc/latex/gzt/gzt-fr.bib deleted file mode 100644 index 9742b37d109..00000000000 --- a/Master/texmf-dist/doc/latex/gzt/gzt-fr.bib +++ /dev/null @@ -1,35 +0,0 @@ -% This file was created with JabRef 2.10. -% Encoding: UTF8 - - -@Online{Bitouze, - Title = {Conférence \LaTeX{} \no6}, - Author = {Bitouzé, Denis}, - Date = {2016-06-08}, - Url = {http://gte.univ-littoral.fr/members/dbitouze/pub/latex/diapositives-cours-d/conference-n-6/downloadFile/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 = {2016-05-23}, - Url = {http://gte.univ-littoral.fr/members/dbitouze/pub/latex/diapositives-cours-d/conference-n-7/downloadFile/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} -} diff --git a/Master/texmf-dist/doc/latex/gzt/gzt-fr.pdf b/Master/texmf-dist/doc/latex/gzt/gzt-fr.pdf deleted file mode 100644 index 00a29135b3b..00000000000 Binary files a/Master/texmf-dist/doc/latex/gzt/gzt-fr.pdf and /dev/null differ diff --git a/Master/texmf-dist/doc/latex/gzt/gzt-fr.tex b/Master/texmf-dist/doc/latex/gzt/gzt-fr.tex deleted file mode 100644 index 5c4d23d1680..00000000000 --- a/Master/texmf-dist/doc/latex/gzt/gzt-fr.tex +++ /dev/null @@ -1,110 +0,0 @@ -\documentclass{gztarticle} -\usepackage{denisbdoc} -\usepackage[firstpage]{draftwatermark} -% -\indexsetup{level=\section*,toclevel=section,noclearpage,firstpagestyle=__gzt_mainmatter_ps} -\makeindex[columns=3] -\tcbset{index format=off} -% -\etocsettocstyle{\section*{\contentsname}}{}% -\etocsetstyle {section} -{} -{\leavevmode\leftskip 0cm\relax} -{\bfseries\normalsize\makebox[.6cm][l]{\etocnumber}% - \etocname\nobreak\hfill\nobreak% - \makebox[.5cm][r]{% - \etocpage% - }% - \par% -} -{\medskip} -\etocsetstyle {subsection} -{} -{\leavevmode\leftskip .6cm\relax } -{\mdseries\normalsize\makebox[1cm][l]{\etocnumber}% - \etocname\nobreak\leaders\etoctoclineleaders\hfill\nobreak - \makebox[.5cm][r]{% - \etocpage% - }% - \par% -} -{} -% -\ExplSyntaxOn -\renewpagestyle{__gzt_mainmatter_ps}[]{% - \widenhead{\c_zero_dim}{\c_zero_dim} - \sethead% - [ - \tikz[remember~picture,overlay] {\g__gzt_mainmatter_evenpage_headrule_tl} - ]% - [% - \adjustbox{raise={\c__gzt_header_yshift_dim}{\height}}{% - \large\bfseries\scshape\color{__gzt_rubric_head_text_color}\g__gzt_short_title_tl% - }% - ]% - []% - {}% - {% - \adjustbox{raise={\c__gzt_header_yshift_dim}{\height}}{% - \bfseries\color{__gzt_rubric_head_text_color}\sectiontitle% - } - }% - { - \tikz[remember~picture,overlay] {\g__gzt_mainmatter_oddpage_headrule_tl} - }% - \setfoot% - [\c__gzt_footer_size_font_tl\thepage]% - [% - \uppercase{\c__gzt_footer_string_tl} - ]% - []% - {}% - {% - \uppercase{\c__gzt_footer_string_tl}% - }% - {\c__gzt_footer_size_font_tl\thepage}% -} -\ExplSyntaxOff -% -\lstMakeShortInline[style=dbtex]| -% -\SetWatermarkColor{gray!10}% -\SetWatermarkFontSize{30mm}% -\SetWatermarkText{\MakeUppercase{travail en cours}}% -% -\addbibresource{gzt-fr.bib} -% -\begin{document} -\title[short=Documentation de la classe de la \emph{Gazette} destinée aux -auteurs]{Documentation de la classe \LaTeX{} de la \gzt*{} destinée aux - auteurs} -\subtitle[short=Version 0.95b (24 octobre 2016)]{\bigskip\Large Version 0.95b en date du 24 octobre 2016} -% -\author[% -affiliation={% - Université du Littoral Côte d'Opale, Laboratoire de mathématiques pures et - appliquées% -},% -photo=denis,% -email=denis.bitouze@lmpa.univ-littoral.fr,% -webpage=http://gte.univ-littoral.fr/members/dbitouze/pub/latex/,% -]{Bitouzé, Denis} -% -\maketitle* -% -\localtableofcontents -% -\input{sections/fixed-footnotes} -\input{sections/gztarticle} -\input{sections/packages-charges} -\input{sections/notations} -% -\printindex -% -\printbibliography -\end{document} - -%%% Local Variables: -%%% mode: latex -%%% TeX-master: t -%%% End: diff --git a/Master/texmf-dist/doc/latex/gzt/gzt-logo.tex b/Master/texmf-dist/doc/latex/gzt/gzt-logo.tex deleted file mode 100644 index 8092bc8015a..00000000000 --- a/Master/texmf-dist/doc/latex/gzt/gzt-logo.tex +++ /dev/null @@ -1,89 +0,0 @@ -\documentclass{standalone} -\usepackage{fontspec} -\usepackage[export]{adjustbox} -\usepackage[cmyk]{xcolor} -\usepackage{xparse} -\setmainfont{HelveticaNeueLTStd-ThEx} -\newfontfamily\des{HelveticaNeueLTStd-Th} -\newfontfamily\mathematiciens{HelveticaNeueLTStd-Lt} -\ExplSyntaxOn -\tl_new:N \l__gzt_frontmatter_head_text_tl -\tl_set:Nn \l__gzt_frontmatter_head_text_tl {% - \adjustbox{stack=r} - {% - \addfontfeature{LetterSpace=10} - \textcolor{__gzt_generic_light_color}{% - \fontsize{21}{0}\selectfont% - la\hspace{5mm}% - \fontsize{45}{0}\selectfont% - Gazette% - }% - \\[1.7mm]% - \fontsize{15}{0}\selectfont% - \textcolor{__gzt_generic_light_color}{% - \des% - \addfontfeature{LetterSpace=6}% - des% - }% - \hspace{2.5mm}% - \textcolor{__gzt_generic_dark_color}{% - \mathematiciens% - \addfontfeature{LetterSpace=6}% - Math\'ematiciens% - }% - }% -} -\NewDocumentCommand \frontmatterheadtext {} { - \l__gzt_frontmatter_head_text_tl -} -\definecolorset{cmyk}{__gzt_}{_color}{ - generic_dark,1,.60,.10,0; % kind of blue (!) - light_generic_dark,1,.35,0,0 % kind of blue (!), light -} -\colorlet{__gzt_generic_light_color}{black!50} -\colorlet{__gzt_dark_generic_light_color}{black!60} -\colorlet{__gzt_description_label_light_color}{__gzt_dark_generic_light_color} -\colorlet{__gzt_minitoc_color}{__gzt_generic_light_color} -\colorlet{__gzt_cover_itemize_label_color}{__gzt_light_generic_dark_color} -\colorlet{__gzt_default_text_color}{black} -\colorlet{__gzt_head_text_color}{black!65} -\colorlet{__gzt_rubric_head_text_color}{__gzt_head_text_color} -\colorlet{__gzt_bibliography_minibios_acknowledgments_bg_color}{black!10} -\colorlet{__gzt_headrule_color}{__gzt_generic_light_color!65} -\colorlet{__gzt_circlerule_color}{__gzt_generic_dark_color!65} -\colorlet{__gzt_frontmatter_text_color}{black!75} -\colorlet{__gzt_people_color}{__gzt_generic_dark_color} -\colorlet{__gzt_arrayrule_color}{__gzt_generic_dark_color} -\colorlet{__gzt_acknowledgements_color}{__gzt_generic_dark_color} -\colorlet{__gzt_question_color}{__gzt_generic_dark_color} -\colorlet{__gzt_boxed_issue_number_bg_color}{__gzt_generic_dark_color} -\colorlet{__gzt_rule_in_toc_color}{__gzt_generic_dark_color} -\colorlet{__gzt_rubric_in_toc_color}{__gzt_generic_dark_color} -\colorlet{__gzt_article_in_toc_color}{__gzt_frontmatter_text_color} -\colorlet{__gzt_rubric_title_color}{__gzt_generic_light_color} -\colorlet{__gzt_article_title_color}{__gzt_generic_dark_color} -\colorlet{__gzt_section_color}{__gzt_generic_dark_color} -\colorlet{__gzt_subsection_color}{__gzt_generic_dark_color!90} -\colorlet{__gzt_subsubsection_color}{__gzt_generic_dark_color!80} -\colorlet{__gzt_rubric_abstract_color}{__gzt_generic_dark_color} -\colorlet{__gzt_article_abstract_color}{__gzt_generic_light_color} -\colorlet{__gzt_dotfill_color}{__gzt_generic_dark_color} -\colorlet{__gzt_about_frontcover_title_color}{__gzt_generic_dark_color} -\colorlet{__gzt_reflected_text_color}{__gzt_generic_dark_color} -\colorlet{__gzt_inside_frontcover_frame_bg_color}{__gzt_generic_dark_color!8} -\colorlet{__gzt_inside_frontcover_frame_title_color}{__gzt_generic_dark_color} -\colorlet{__gzt_footer_bg_color}{black!10} -\colorlet{__gzt_float_title_color}{__gzt_generic_dark_color} -\colorlet{__gzt_float_title_bg_color}{__gzt_generic_dark_color!10} -\colorlet{__gzt_float_frame_color}{__gzt_generic_dark_color!20} -\colorlet{__gzt_chapter_color}{__gzt_generic_dark_color} -\colorlet{__gzt_smf_number_color}{__gzt_generic_dark_color} -\colorlet{__gzt_date_color}{__gzt_generic_light_color} -\colorlet{__gzt_table_head_color}{__gzt_generic_dark_color!25} -\colorlet{__gzt_book_review_frame_bg_color}{__gzt_generic_dark_color!8} -\colorlet{__gzt_book_advertisement_bg_color}{white} -\colorlet{__gzt_book_advertisement_frame_color}{__gzt_generic_dark_color} -\ExplSyntaxOff -\begin{document} -\frontmatterheadtext -\end{document} diff --git a/Master/texmf-dist/doc/latex/gzt/gztarticle.tex b/Master/texmf-dist/doc/latex/gzt/gztarticle.tex deleted file mode 100644 index 532c2de4750..00000000000 --- a/Master/texmf-dist/doc/latex/gzt/gztarticle.tex +++ /dev/null @@ -1,1404 +0,0 @@ -\section{Introduction} -\label{sec-introduction} - -\begin{dbremark}{Documentation : travail en cours}{} - La présente documentation est un travail en cours. Nous remercions d'avance - les lecteurs qui ont des remarques à formuler ou qui trouveront des erreurs de - nous les signaler à l'adresse courriel figurant en fin de document. -\end{dbremark} - -La \smf fournit la classe \LaTeX{} \gztauthor{} destinée aux auteurs souhaitant -publier un article dans la -\href{http://smf4.emath.fr/Publications/Gazette/}{\gzt*{}}. Cette classe a pour -but : -\begin{enumerate} -\item de reproduire fidèlement la maquette de la \gzt{}, permettant ainsi aux - auteurs de pouvoir travailler la mise en page de leur document dans des - conditions (quasi-)réelles ; -\item de fournir un certain nombre d'outils (commandes et environnements) - destinés à faciliter la composition de documents, notamment ceux contenant des - formules de mathématiques. -\end{enumerate} - -\section{Avertissements préliminaires} -\label{sec-avert-prel} - -\begin{dbwarning}{Codage d'entrée \protect\lstinline+UTF-8+ obligatoire}{} - La \gztauthorcl{} de la \gzt{} repose de façon cruciale sur un codage - d'entrée en |UTF-8| : - \begin{itemize} - \item elle charge le \Package{inputenc}\footnote{% - Il convient donc de \emph{ne pas} charger ce package : on se reportera - à la \vref{sec-canevas-de-fichier} pour un canevas de fichier source - destiné à la \gzt{} et notamment pour un préambule typique.% - % - } 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. - \end{itemize} -\end{dbwarning} - -\begin{dbwarning}{Format et compilation \hologo{pdfLaTeX}}{} - La composition des numéros de la \gzt*{} met en œuvre : - \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 \hologo{pdfLaTeX}. En particulier, le compilateur - \hologo{LaTeX} n'étant pas utilisé : - \begin{enumerate} - \item les formats d'images acceptés sont \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.}. Le \Format{eps}, quoique indirectement - supporté, est déconseillé ; - \item le code \program{PostScript}, notamment via \program{PSTricks}, n'est - pas directement pris en charge. Bien qu'il soit accepté, il est à éviter - dans la mesure du possible. - \end{enumerate} - \end{itemize} -\end{dbwarning} - -\begin{dbremark}{Composition par défaut en bi-colonne}{} - Sauf cas particuliers, tous les articles de la \gzt{} sont composés en mode - bi-colonne. -\end{dbremark} - -\section{Article standard} -\label{sec-article-standard} - -Nous commençons par décrire les éléments caractéristiques d'un article standard. - -\subsection{Préparation du \enquote{titre} de l'article} -\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. - -\subsubsection{Titre, sous-titre} -\label{sec-titre} - -\begin{docCommand}[doc description=\mandatory]{title}{\oarg{option}\marg{titre}} - Cette commande définit le \meta{titre} de l'article. Celui-ci apparaît alors - en début d'article et aussi comme métadonnée \enquote{Titre} du fichier - \textsc{pdf} correspondant. -\end{docCommand} - -\begin{docCommand}{subtitle}{\oarg{option}\marg{sous-titre}} - Cette commande définit l'éventuel \meta{sous-titre} de l'article. Celui-ci - est automatiquement ajouté au titre. -\end{docCommand} - -Les commandes \refCom{title} et \refCom{subtitle} admettent un argument -optionnel permettant de spécifier un (sous-)titre court au moyen de la clé -\refKey{short}. - -\begin{docKey}{short}{=\meta{(sous-)titre court}}{pas de valeur par défaut, - initialement vide} - Cette clé définit un (sous-)titre \enquote{court} de l'article qui figure - alors à la place du (sous-)titre \enquote{normal} dans le sommaire et en titre - courant\footnote{En entête.}. -\end{docKey} - -\begin{bodycode} -\title[short=Les travaux de Martin \surname{Hairer}]{Martin \surname{Hairer}, - l'équation de KPZ et les structures de régularité} -\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}. -\end{dbremark} - -\subsubsection{Auteur(s)} -\label{sec-auteurs} - -Un auteur d'article est spécifié au moyen de la commande \refCom{author} -suivante. En cas d'auteurs multiples, il suffit de recourir à plusieurs -occurrences de cette commande. - -\begin{docCommand}{author}{\oarg{options}\brackets{\meta{Nom}, \meta{Prénom}}} - Cette commande, facultative, définit un auteur d'article. -\end{docCommand} -% -\begin{dbwarning}{Format des prénom et nom de l'auteur}{} - On veillera à ce que : - \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}) : - % -\begin{bodycode}[listing options={showspaces}] -"\meta{Nom}", "\meta{Prénom}" -\end{bodycode} - % - \item les éventuels accents 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) car il sera automatiquement - composé en petites capitales. - \end{enumerate} -\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{enumerate} - \item de recourir à la commande habituelle \refCom{maketitle} ; - \item de procéder à une suite de compilations\suitecompilations{} : - \begin{enumerate} - \item \hologo{pdfLaTeX} ; - \item \hologo{biber} ; - \item \hologo{pdfLaTeX}. - \end{enumerate} - \end{enumerate} -\end{dbwarning} - -\subsubsection{Auteur(s) : détails} -\label{sec-auteurs-details} - -La commande \refCom{author} admet un argument optionnel permettant, pour chaque -auteur, de spécifier un certain nombre de détails complémentaires : son affiliation, sa -photo, son email, sa page Web, sa biographie express au moyen des clés -respectives % (à séparer par des virgules) -\refKey{affiliation}, \refKey{photo}, \refKey{email}, \refKey{webpage} et -\refKey{minibio} : -\begin{bodycode} -\author[% - affiliation="\marg{affiliation(s)}",% - photo="\meta{photo}",% - email="\meta{email}",% - webpage="\meta{page Web}",% - minibio="\marg{biographie express}"% -]{"\meta{Nom}", "\meta{Prénom}"} -\end{bodycode} - -\begin{docKey}{affiliation}{={\marg{affiliation(s)}}}{pas de valeur par défaut, - initialement vide} - Cette clé permet de spécifier une ou plusieurs affiliations. En cas - d'affiliations multiples, celles-ci peuvent être séparées par la commande - \docAuxCommand*{newline}. -\end{docKey} - -\begin{docKey}{photo}{={\meta{photo}}}{pas de valeur par défaut, - initialement vide} - Cette clé permet de spécifier la photographie de l'auteur au moyen d'un - fichier image\footnote{Si ce fichier ne figure pas dans le dossier courant, il - faut faire figurer le chemin (relatif) y menant.}. -\end{docKey} - -\begin{docKey}{email}{={\meta{email}}}{pas de valeur par défaut, - initialement vide} - Cette clé permet de spécifier l'adresse courriel de l'auteur. -\end{docKey} - -\begin{docKey}{webpage}{={\meta{page Web}}}{pas de valeur par défaut, - initialement vide} - Cette clé permet de spécifier la page Web de l'auteur. -\end{docKey} - -\begin{docKey}{minibio}{={\marg{biographie express}}}{pas de valeur par défaut, - initialement vide} - Cette clé permet de spécifier la biographie express de l'auteur. -\end{docKey} - -\begin{dbwarning}{Paires d'accolades - % des clés \refKey{affiliation} et \refKey{minibio} - (relativement) obligatoires}{} - Au cas (probable) où les valeurs \meta{affiliation(s)} et \meta{biographie - express} des clés \refKey{affiliation} et \refKey{minibio} contiennent des - virgules, les paires d'accolades les entourant sont obligatoires. -\end{dbwarning} - -\begin{dbwarning}{Courriels et pages Web à saisir tels quels}{} - Les valeurs \meta{email} et \meta{webpage} des clés \refKey{email} et - \refKey{webpage} doivent être saisies telles quelles, sans recours aucun aux - commandes \refCom{url}, \docAuxCommand{href} ou assimilées des packages - \package{url} ou \package{hyperref}. -\end{dbwarning} - -\begin{dbremark}{Affichage des détails complémentaires sur les auteurs}{} - Pour que les détails complémentaires précédents soient affichés, il est - nécessaire de recourir aux commandes \refCom{printauthorsdetails} ou - \refCom{printbibliography}, destinées à être utilisées en fin d'article. - - Ces commandes affichent également d'éventuels remerciements à spécifier au - moyen de la commande \refCom{acknowledgements} suivante. -\end{dbremark} - -\begin{docCommand}{acknowledgements}{\marg{remerciements}} - Cette commande, facultative, permet de spécifier des \meta{remerciements} pour - un article. -\begin{bodycode} -\acknowledgements{% - L'auteur remercie Frédéric Patras, pour les nombreuses discussions qu'il - a eues avec lui sur le sujet. Il remercie également le relecteur anonyme, - qui a lu le texte avec un très grand soin, et dont les commentaires et - suggestions ont été très utiles.% -} -\end{bodycode} -\end{docCommand} - -\subsubsection{Résumé} -\label{sec-resume} - -\begin{docEnvironment}[doclang/environment content=résumé]{abstract}{} - Cet environnement, facultatif, est destiné à recevoir le \meta{résumé} de - l'article. -\end{docEnvironment} - -\subsection{Production du titre de l'article} -\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}. - -\begin{docCommand}[doc description=\mandatory]{maketitle}{} - Cette commande \emph{produit} l'affichage du \enquote{titre} de l'article, - c'est-à-dire : - \begin{itemize} - \item son titre et son éventuel sous-titre (commandes \refCom{title} et - \refCom{subtitle}) ; - \item son ou ses éventuels auteurs, sous la forme de leurs noms et - prénoms\footnote{Les prénoms sont alors abrégés au moyen de leurs - initiales.} (commande(s) \refCom{author}) ; - \item son éventuel résumé (environnement \refEnv{abstract}). - \end{itemize} -\end{docCommand} - -L'exemple suivant\footnote{Les commandes \refCom{surname} et \refCom{enquote} - qui y figurent sont documentées plus loin.} illustre la plupart des commandes -et options vues jusqu'ici. - -\begin{bodycode} -\title[short=Les travaux de Manjul \surname{Bhargava}]{Manjul \surname{Bhargava}, - anneaux de petit rang et courbes elliptiques} -% -\author[% - affiliation={% - Univ. Bordeaux, IMB, UMR 5251, F-33400 Talence, France\newline% - CNRS, IMB, UMR 5251, F-33400 Talence, France\newline% - INRIA, F-33400 Talence, France% - },% - photo=Belabas,% - email=Karim.Belabas@math.u-bordeaux.fr,% - minibio={% - Karim Belabas est professeur à l'université de Bordeaux. Ses centres - d'intérêts sont la théorie des nombres sous toutes ses formes et le calcul - formel. Il développe le système libre PARI/GP.% - }% -]{Belabas, Karim} -% -\author[% - affiliation={% - Laboratoire de Mathématiques de Besançon, Facultés des sciences et techniques, - CNRS, UMR 6623, 16 route de Gray, 25030 Besançon, France% - },% - photo=Delaunay,% - email=Christophe.Delaunay@univ-fcomte.fr,% - minibio={% - Christophe Delaunay est professeur à l'université de Franche-Comté et membre - du laboratoire de mathématiques de Besançon. Il est spécialiste de théorie des - nombres.% - }% -]{Delaunay, Christophe} -% -\begin{abstract} - Manjul Bhargava a reçu la médaille Fields au congrès international de Séoul - \enquote{pour avoir développé de nouvelles méthodes en géométrie des nombres, - qu'il a appliquées au comptage des anneaux de petit rang et pour borner le - rang moyen de courbes elliptiques}. Cet article est un survol d'une partie - de ses travaux. -\end{abstract} -% -\maketitle -\end{bodycode} - -\subsection{Affichage des détails complémentaires sur les auteurs} - -\begin{docCommand}{printauthorsdetails}{} - Cette commande, facultative, \emph{produit} l'affichage : - \begin{itemize} - \item des détails complémentaires sur les auteurs (options - \refKey{affiliation}, \refKey{photo}, \refKey{email}, \refKey{webpage} et - \refKey{minibio}) ; - \item des éventuels remerciements (commande \refCom{acknowledgements}) ; - \end{itemize} - tels que définis à la \vref{sec-auteurs-details}. -\end{docCommand} - -\begin{dbwarning}{Commande \protect\docAuxCommand*{printauthorsdetails} inutile - en cas de bibliographie}{} - En cas de bibliographie (cf. commande \refCom{printbibliography}), l'usage de - la commande \refCom{printauthorsdetails} est inutile car l'affichage des - détails complémentaires sur les auteurs est alors automatique. -\end{dbwarning} - -\section{Article sans auteur mais avec signature \enquote{académique}} -\label{sec-article-sans-auteur} - -Les articles standard précédents sont écrits par une ou plusieurs personnes -physiques clairement identifiées en tant qu'auteurs. - -D'autres types d'articles n'ont pas véritablement d'auteurs mais sont plutôt -\enquote{signés} par, par exemple, un comité. Pour ce type d'article, on ne -recourra pas à la commande \refCom{author}, mais plutôt à la commande -\refCom{academicsignature} suivante. - -\begin{docCommand}{academicsignature}{\marg{signature}} - Cette commande permet de spécifier une \meta{signature} académique. -\begin{bodycode} -\academicsignature{% - Au nom du comité éditorial, Serge Nicaise (éditeur en chef) et Nicolas - Wicker (directeur technique).% -} -\end{bodycode} -\end{docCommand} - -\begin{dbwarning}{Commande \protect\docAuxCommand*{academicsignature} à effet \enquote{immédiat}}{} - La commande \refCom{author} \enquote{prépare} un auteur qui n'est affiché que - là où est employée la commande \refCom{maketitle}. Au contraire, la commande - \refCom{academicsignature} affiche \enquote{immédiatement} la \meta{signature} - passée en argument. -\end{dbwarning} - -\section{Articles de type \enquote{entretien}} -\label{sec-entretiens} - -Les entretiens sont caractérisés par l'alternance de questions et de -réponses. Les questions, qui doivent être composées de façon spécifique, sont -à passer en argument de la commande \refCom{question} suivante. - -\begin{docCommand}{question}{\marg{question}} - Cette commande permet de spécifier une \meta{question}. -\end{docCommand} - -\begin{dbremark}{Composition des réponses aux questions}{} - Les réponses aux questions ne nécessitant pas de mise en page particulière, - elles seront insérées telles quelles. -\end{dbremark} - -\begin{bodycode} -\question{Ton sujet principal est celui des systèmes dynamiques, mais quels - sont les autres thèmes qui t'intéressent ?} - -L'étude des systèmes dynamiques est un sujet qui peut être abordé de façon les -plus diverses. Certains les considèrent d'un point de vue combinatoire, -d'autres sont plus axés sur les probabilités ou encore sur l'analyse. [...] -Mais si mes capacités d'analystes n'avaient pu se réaliser dans les systèmes -dynamiques j'aurais fait autre chose. - -\question{Parmi ses lauréats de cette édition, on compte deux dynamiciens : - Maryam Mirzakhani et toi. Quelles sont les différences entre vos - approches ?} - -Ces travaux sont principalement concentrés sur un objet lié aux échanges -d'intervalles : le flot de Teichmüller. [...] -\end{bodycode} - -\begin{dbwarning}{Insertion manuelle d'espacements inutile}{} - On évitera de modifier l'agencement des questions et réponses en insérant - manuellement des espacements horizontaux ou verticaux - (\docAuxCommand*{hspace}, \docAuxCommand*{hskip}, \docAuxCommand*{vspace}, - \docAuxCommand*{vskip}, etc.). -\end{dbwarning} - -Les entretiens sont des articles en général sans auteur mais les personnes ayant -recueilli les propos peuvent être signalées dans le résumé (cf. environnement -\refEnv{abstract}), par exemple ainsi : - -\begin{bodycode} -\title{Entretien avec Artur \surname{Avila}} -\begin{abstract} - Propos recueillis à Séoul, pendant l'ICM, par Boris Adamczewski et Gaël Octavia. -\end{abstract} -\maketitle -\end{bodycode} - -\section{Outils communs à tous types d'articles, fournis par \texorpdfstring{\gztauthor}{la classe}} -\label{sec-outils-communs-tous} - -Cette section donne une liste exhaustive des outils (commandes et -environnements) fournis par la \gztauthorcl. - -\subsection{Images et tableaux} -\label{sec-images-tableaux} - -Les images et tableaux destinés à illustrer le corps d'un article doivent être -insérés dans les environnements \refEnv{gztfigure}, \refEnv{gztfigure*}, -\refEnv{gzttable} et \refEnv{gzttable*}, analogues, décrits dans cette section. - -\subsubsection{Images} -\label{sec-images} - -Une image est incluse au moyen de la commande standard -\docAuxCommand{includegraphics}\footnote{Il est possible de passer à cette - commande toutes ses options définies par le \Package{graphicx}.} mais celle-ci -doit être employée dans l'un des deux environnements \refEnv{gztfigure} et -\refEnv{gztfigure*} suivants. - -\begin{docEnvironment}[doclang/environment content=image incluse avec \docAuxCommand{includegraphics}]{gztfigure}{\oarg{option(s)}} - Cet environnement insère l'image : - \begin{itemize} - \item \emph{à l'emplacement où il est utilisé} ; - \item dans un cadre de largeur la ligne courante, donc notamment de la largeur - de la ligne d'une colonne en mode bi-colonne. - \end{itemize} -\end{docEnvironment} - -\begin{docEnvironment}[doclang/environment content=image incluse avec \docAuxCommand{includegraphics}]{gztfigure*}{\oarg{option(s)}} - Cet environnement insère l'image : - \begin{itemize} - \item en haut de la page où il a été employé, donc probablement \emph{pas} - à l'emplacement où il est utilisé (il s'agit d'une figure - \enquote{flottante}) ; - \item dans un cadre de largeur celle de l'empagement, donc à cheval sur les - deux colonnes en mode bi-colonne. - \end{itemize} -\end{docEnvironment} - -\subsubsection{Tableaux} -\label{sec-tableaux} - -Un tableau est créé au moyen de l'environnement standard -\docAuxEnvironment{tabular}\footnote{Il est recommandé de faire usage du - \Package*{booktabs} pour produire des tableaux plus lisibles.} mais celui-ci -doit être employé dans l'un des deux environnements \refEnv{gzttable} et -\refEnv{gzttable*} suivants. - -\begin{docEnvironment}[doclang/environment content=tableau créé avec \docAuxEnvironment{tabular}]{gzttable}{\oarg{option(s)}} - Cet environnement insère le tableau : - \begin{itemize} - \item \emph{à l'emplacement où il est utilisé} ; - \item dans un cadre de largeur la ligne courante, donc notamment de la largeur - de la ligne d'une colonne en mode bi-colonne. - \end{itemize} -\end{docEnvironment} - -\begin{docEnvironment}[doclang/environment content=tableau créé avec \docAuxEnvironment{tabular}]{gzttable*}{\oarg{option(s)}} - Cet environnement insère le tableau : - \begin{itemize} - \item en haut de la page où il a été employé, donc probablement \emph{pas} - à l'emplacement où il est utilisé (il s'agit d'un tableau - \enquote{flottant}) ; - \item dans un cadre de largeur celle de l'empagement, donc à cheval sur les - deux colonnes en mode bi-colonne. - \end{itemize} -\end{docEnvironment} - -\subsubsection{Options} -\label{sec-options-gzt} - -Les environnements \refEnv{gztfigure}, \refEnv{gztfigure*}, \refEnv{gzttable} et -\refEnv{gzttable*} admettent en argument optionnel : -\begin{itemize} -\item la plupart des (très nombreuses) options de l'environnement - \docAuxEnvironment{tcolorbox} du \Package*{tcolorbox}. On retiendra notamment - les options suivantes : -\begin{docKey}{title}{=\meta{titre}}{pas de valeur par défaut, - initialement vide} - Cette clé permet de spécifier l'éventuel \meta{titre} (ou légende). -\end{docKey} -\begin{docKey}{label}{=\meta{label}}{pas de valeur par défaut, initialement - vide} - Cette clé permet de spécifier l'éventuel \meta{label} de l'image, de sorte - à y faire référence, notamment au moyen de la commande \refCom{vref}. -\end{docKey} -\item la clé \refKey{copyright} suivante :\begin{docKey}{copyright}{=\meta{titulaire}}{pas de valeur par défaut, initialement - vide} - Cette clé permet de spécifier un éventuel \meta{titulaire} de - \emph{copyright}. -\end{docKey} -\end{itemize} - -Les exemples suivants illustrent les environnements et options qui viennent -d'être vus. -\begin{bodycode}[listing options={deletekeywords={[1]{exemple,title,label}},morekeywords={[2]{title,label}}}] -L'exemple avec $a=-1$ et $b=0$ donne la courbe de la \vref{elliptique}. -% -\begin{gztfigure}[title=Courbe elliptique correspondant à l'équation - $y^2=x^3-x$,label=elliptique] - \includegraphics[width=\linewidth]{courbe-elliptique} -\end{gztfigure} -\end{bodycode} - -\begin{bodycode}[listing options={morekeywords={[2]title,label},deletekeywords={[3]section}}] -En analysant les chiffres des \vref{recru-mc-25,recru-mc-26} correspondant au -recrutement des maîtres de conférences, on voit que la proportion des femmes -recrutées est [...] -% -\begin{gzttable*}[label=recru-mc-25,title=Recrutement des maîtres de - conférences section 25] - \begin{tabular}{|l|cccccc|} - \hline - & 2008 & 2009 & 2010 & 2011 & 2012 & 2013 \\ \hline - [...] - \end{tabular} -\end{gzttable*} -% -\begin{gzttable*}[label=recru-mc-26,title=Recrutement des maîtres de - conférences section 26] - \begin{tabular}{|l|cccccc|} - \hline - & 2008 & 2009 & 2010 & 2011 & 2012 & 2013 \\ \hline - [...] - \end{tabular} -\end{gzttable*} -\end{bodycode} - -\subsection{Bibliographie} -\label{sec-bibliographie} - -Pour composer les bibliographies, la \gzt{} recourt aux outils modernes que sont -le \Package*{biblatex} et le moteur \hologo{biber}. Leur usage est détaillé dans -\autocite{Bitouze} et peut être brièvement résumé comme suit. -\begin{enumerate} -\item Construire, dans un \meta{fichier bibliographique}\footnote{De tels - fichiers sont d'extension \file{.bib}.}, une base bibliographique. - - Nous conseillons pour ce faire de recourir à un logiciel dédié, par exemple - \href{http://jabref.sourceforge.net/}{\program{JabRef}} - à configurer\footnote{La version décrite ici est la 3.2.} en se rendant - dans le menu : - \begin{itemize} - \item \enquote{\menuentry{File}} et en sélectionnant \enquote{\menuentry{BibLaTeX mode}} ; - \item \enquote{\menuentry{Options>Preferences}} puis dans l'onglet \enquote{\menuentry{General}}, - en choisissant \enquote{\menuentry{UTF8}} dans la liste déroulante \enquote{\menuentry{Default - encoding}}\footnote{On pourra en profiter pour changer la langue de - l'interface dans la liste déroulante \enquote{\menuentry{Language}}.}. - \end{itemize} - - On n'oubliera pas de donner à chaque entrée bibliographique une \meta{clé} - permettant de l'identifier de façon unique dans la base - bibliographique\footnote{Sous \program{JabRef}, on pourra se faire aider pour - cela par l'icône en forme de \enquote{baguette magique}.}. -\item Dans le fichier source \file{.tex} : - \begin{enumerate} - \item \emph{En préambule}, utiliser la commande \docAuxCommand{addbibresource} - pour indiquer le \meta{fichier bibliographique} à considérer : -\begin{preamblecode}[listing options={moretexcs={addbibresource}}] -\addbibresource{"\meta{fichier bibliographique}".bib} -\end{preamblecode} - \item Dans le corps du document, utiliser la commande - \docAuxCommand{autocite}\footnote{De préférence à la commande - \docAuxCommand{cite}.} du \Package*{biblatex} pour citer les références - bibliographiques (pourvue d'une \meta{clé}) : -\begin{bodycode}[listing options={moretexcs={autocite}}] -\autocite{"\meta{clé}"} -\end{bodycode} - \item À la fin du document, faire figurer la liste des références - bibliographiques au moyen de la commande \refCom{printbibliography} - suivante. - \end{enumerate} -\item Procéder à une suite de compilations \hologo{pdfLaTeX}, \hologo{biber} et - \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}. - Cette commande est fournie sous deux formes, non étoilée et étoilée : - \begin{description} - \item[sous sa forme non étoilée :] elle affiche, en sus des références bibliographiques, - les \hyperref[sec-auteurs-details]{détails complémentaires sur les auteurs} - (s'ils ont été renseignés) ; - \item[sous sa forme étoilée :] elle n'affiche que les références bibliographiques. - \end{description} -\end{docCommand} - -\subsection{Commandes diverses} -\label{sec-commandes-diverses} - -La \gztauthorcl{} fournit des commandes généralistes ou propres aux -mathématiques destinées à faciliter la saisie d'un article à paraître dans la -\gzt{}. - -\subsubsection{Commandes généralistes} -\label{sec-comm-gener} - -\begin{docCommand}{smf}{} - Cette commande produit l'acronyme \textsc{smf} de la Société Mathématique de - France. -\end{docCommand} - -\begin{docCommand}{gzt}{} - Cette commande : - \begin{description} - \item[sous sa forme non étoilée :] produit l'abréviation \enquote{\gzt}. - \item[sous sa forme étoilée :] produit la forme complète \enquote{\gzt*}. - \end{description} -\end{docCommand} - -\begin{docCommand}{cad}{} - Cette commande : - \begin{description} - \item[sous sa forme non étoilée :] produit l'abréviation \enquote{c.-à-d.}. - \item[sous sa forme étoilée :] produit la forme complète - \enquote{c'est-à-dire}. - \end{description} -\end{docCommand} - -\begin{docCommand}{Cad}{} - Cette commande : - \begin{description} - \item[sous sa forme non étoilée :] produit l'abréviation \enquote{C.-à-d.}. - \item[sous sa forme étoilée :] produit la forme complète - \enquote{C'est-à-dire}. - \end{description} -\end{docCommand} - -\begin{docCommand}{surname}{\marg{nom de famille}} - Cette commande compose le \meta{nom de famille} en petites capitales. - \begin{dbwarning}{Petites capitales : à employer avec parcimonie}{} - \begin{itemize} - \item De manière générale, quand elles sont appliquées aux noms de - personnes, les petites capitales doivent ne s'appliquer qu'au nom de - famille, et notamment \emph{pas} aux prénoms. - \item Pour un article de la \gzt{}, on évitera d'appliquer systématiquement - les petites capitales (et donc la commande \refCom{surname}) à tous les - noms de famille : on les réservera aux noms d'auteurs, notamment à ceux - spécialement mis à l'honneur, par exemple s'ils figurent dans le titre - d'un article. - \end{itemize} - \end{dbwarning} -\end{docCommand} - -\begin{docCommand}{century}{\marg{numéro}} - Cette commande affiche le \meta{numéro}\footnote{Ce numéro doit être un nombre - entier relatif non nul.} ordinal d'un siècle en chiffre romain composé en - petites capitales, suivi du suffixe constitué, selon que la langue en cours - est le français ou l'anglais : - \begin{itemize} - \item du mot \enquote{siècle} puis, si \meta{numéro} $<0$, de l'expression - \enquote{avant J.-C.}\footnote{Sauf si le caractère qui suit est un point, - auquel cas l'expression est \enquote{avant J.-C}.} ; - \item du mot \enquote{century} puis, si \meta{numéro} $<0$, de l'expression - \enquote{BC}. - \end{itemize} - Ainsi : -\begin{bodycode}[listing and text] -Au \century{8}, [...]. Auparavant, au \century{1}, [...]. Il en fût de même au -\century{-3} et au \century{-2}. -\end{bodycode} - Cette commande dispose également d'une version étoilée ne faisant figurer - le suffixe que si \meta{numéro} $<0$, à utiliser par exemple dans un cas tel - que le suivant : -\begin{bodycode}[listing and text] -Toute la poésie du \century*{19} mérite d'être lue. -\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{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. - \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. -\end{bodycode} - et : -\begin{bodycode}[listing and text] -On soupçonne que non \aside*{par exemple on s'attend à ce que $1/\pi$ ne -soit pas une période}. -\end{bodycode} -\end{docCommand} - -% ^^A smf,cad,Cad,gzt,century,aside - -\subsubsection{Commandes propres aux mathématiques} -\label{sec-comm-propr-aux} - -La \gztauthorcl{} : -\begin{itemize} -\item charge les 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*{mathrsfs} qui fournit de jolies lettres calligraphiques (via - la commande \docAuxCommand{mathscr}) ; - \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. -\end{itemize} - -\paragraph{Ensembles courants} - -\begin{docCommand}{N}{} - Cette commande affiche l'ensemble des nombres entiers positifs : - \enquote{$\mathbb{N}$}. -\end{docCommand} - -\begin{docCommand}{Z}{} - Cette commande affiche l'ensemble des nombres entiers relatifs : - \enquote{$\mathbb{Z}$}. -\end{docCommand} - -\begin{docCommand}{D}{} - Cette commande affiche l'ensemble des nombres décimaux : - \enquote{$\mathbb{D}$}. -\end{docCommand} - -\begin{docCommand}{Q}{} - Cette commande affiche l'ensemble des nombres rationnels : - \enquote{$\mathbb{Q}$}. -\end{docCommand} - -\begin{docCommand}{R}{} - Cette commande affiche l'ensemble des nombres réels : \enquote{$\mathbb{R}$}. -\end{docCommand} - -\begin{docCommand}{C}{} - Cette commande affiche l'ensemble des nombres complexes : - \enquote{$\mathbb{C}$}. -\end{docCommand} - -\begin{docCommand}{K}{} - Cette commande peut être utilisée pour dénoter un corps quelconque. Elle - affiche \enquote{$\mathbb{K}$}. -\end{docCommand} - -\paragraph{Fonctions trigonométriques circulaires et hyperboliques, directes et - réciproques} - -\begin{docCommand}{cotan}{} - Cette commande affiche la cotangente : \enquote{$\cotan$}. -\end{docCommand} - -\begin{docCommand}{arccos}{} - Cette commande affiche (la détermination principale de) l'arc cosinus : - \enquote{$\arccos$} ou - \enquote{\selectlanguage{english}$\arccos$\selectlanguage{french}} selon que - la langue en cours est le français ou l'anglais. -\end{docCommand} - -\begin{docCommand}{arcsin}{} - Cette commande affiche (la détermination principale de) l'arc sinus : - \enquote{$\arcsin$} ou - \enquote{\selectlanguage{english}$\arcsin$\selectlanguage{french}} selon que - la langue en cours est le français ou l'anglais. -\end{docCommand} - -\begin{docCommand}{arctan}{} - Cette commande affiche (la détermination principale de) l'arc tangente : - \enquote{$\arctan$} ou - \enquote{\selectlanguage{english}$\arctan$\selectlanguage{french}} selon que - la langue en cours est le français ou l'anglais. -\end{docCommand} - -\begin{docCommand}{ch}{} - Cette commande affiche le cosinus hyperbolique : \enquote{$\ch$}. -\end{docCommand} - -\begin{docCommand}{sh}{} - Cette commande affiche le sinus hyperbolique : \enquote{$\sh$}. -\end{docCommand} - -\begin{docCommand}{tanh}{} - Cette commande affiche la tangente hyperbolique : \enquote{$\tanh$} ou - \enquote{\selectlanguage{english}$\tanh$\selectlanguage{french}} selon que la - langue en cours est le français ou l'anglais. - \begin{dbremark}{Pas de commande \protect\lstinline+\\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. - \end{dbremark} -\end{docCommand} - -\paragraph{Fonctions diverses} - -\begin{docCommand}{log}{} - Cette commande : - \begin{description} - \item[sous sa forme non étoilée :] produit \enquote{$\log$}. - \item[sous sa forme étoilée :] produit \enquote{$\log*$}. - \end{description} -\end{docCommand} - -\begin{docCommand}{lg}{} - Cette commande : - \begin{description} - \item[sous sa forme non étoilée :] produit \enquote{$\lg$}. - \item[sous sa forme étoilée :] produit \enquote{$\lg*$}. - \end{description} -\end{docCommand} - -\paragraph{Théorèmes et objets analogues} - -Pour faciliter la composition des théorèmes et objets analogues, la -\gztauthorcl{} fournit des environnements prêts à l'emploi et permet d'en créer -de nouveaux si besoin est (cf. commande \refCom{newtheorem}). - -Le \vref{env-theorems} liste les théorèmes et objets analogues disponibles -% -avec : -\begin{description} -\item[en colonne~1] le nom de l'environnement \LaTeX{} correspondant, et son - éventuel alias (utilisables indifféremment) ; -\item[en colonne~2] les titres récurrents correspondants selon que la langue en - cours est le français ou l'anglais. -\end{description} - -\begin{gzttable}[label=env-theorems,title=Environnements de type \enquote{théorème} fournis] - \begin{tabular}{llll} - \multicolumn{2}{c}{Environnement} & \multicolumn{2}{c}{Titre} \\ - Nom & Alias & En français & En anglais \\\toprule - |theoreme| & |theorem| & Théorème & Theorem \\\midrule - |corollaire| & |corollary| & Corollaire & Corollary \\\midrule - \multicolumn{2}{c}{\lstinline+conjecture+} & \multicolumn{2}{c}{Conjecture} \\\midrule - \multicolumn{2}{c}{\lstinline+proposition+} & \multicolumn{2}{c}{Proposition} \\\midrule - |lemme| & |lemma| & Lemme & Lemma \\\midrule - |axiome| & |axiom| & Axiome & Axiom \\\midrule\midrule - \multicolumn{2}{c}{\lstinline+definition+} & Définition & Definition \\\midrule - |remarque| & |remark| & Remarque & Remark \\\midrule - |exemple| & |example| & Exemple & Example \\\midrule - \multicolumn{2}{c}{\lstinline+notation+} & \multicolumn{2}{c}{Notation} \\\midrule - |preuve| & |proof| & Preuve & Proof \\\bottomrule - \end{tabular} -\end{gzttable} - -\begin{dbremark}{\enquote{Théorèmes} non numérotés : versions étoilées des - environnements}{} - Tous les environnements \LaTeX{} du \vref{env-theorems} admettent une version - étoilée produisant des occurrences \emph{non} numérotées du \enquote{théorème} - correspondant. -\end{dbremark} - -Ces environnements s'emploient de façon classique, c'est-à-dire comme tout -environnement \LaTeX{}. Ils disposent cependant d'un argument optionnel -permettant de préciser le \enquote{théorème}, par exemple en spécifiant son -auteur. - -\begin{bodycode}[listing and text] -\begin{theorem} - Tout espace métrisable séquentiellement compact est 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\Z$ -\end{definition} -\begin{remark*} - \[ - 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. -\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 \gztauthorcl{} fournit effectivement trois styles de -\enquote{théorèmes}, \docValue{theorem}, \docValue{definition} et -\docValue{proof}, dont les caractéristiques sont indiquées au -\vref{env-theorems-styles}. - -\begin{gzttable}[label=env-theorems-styles,title=Styles de \enquote{théorèmes} fournis] -\begin{tabular}{lp{3cm}p{3cm}p{5.5cm}} -Style & Titre récurrent & Contenu & Théorèmes concernés \\\toprule -\docValue{theorem} & gras & italique - & théorèmes, corollaires, conjectures, propositions, lemmes, axiomes \\\midrule -\docValue{definition} & gras & romain & définitions, remarques, exemples, notations \\\midrule -\docValue{proof} & italique, non gras, non numéroté & romain, terminé par un carré blanc & preuves \\\bottomrule -\end{tabular} -\end{gzttable} - -% \begin{description} -% \item[\docValue{theorem} :]\ -% \begin{enumerate} -% \item le titre récurrent (et l'éventuelle précision) est en gras ; -% \item le contenu est en italique. -% \end{enumerate} -% Ce style est appliqué aux environnements \enquote{de type théorème}, \cad*{} -% les théorèmes, corollaires, conjectures, propositions, lemmes et axiomes. -% \item[\docValue{definition} :]\ -% \begin{enumerate} -% \item le titre récurrent (et l'éventuelle précision) est en gras ; -% \item le contenu \emph{n'est pas} en italique. -% \end{enumerate} -% Ce style est appliqué aux environnements \enquote{de type définition}, \cad*{} -% les définitions, remarques, exemples et notations. -% \item[\docValue{proof} :]\ -% \begin{enumerate} -% \item le titre récurrent (et l'éventuelle précision) \emph{n'est pas} en gras, -% est en italique et n'est \emph{jamais} numéroté ; -% \item le contenu \emph{n'est pas} en italique et se termine par un carré noir -% en fin de ligne. -% \end{enumerate} -% Ce style est appliqué aux environnements \enquote{de type preuve}, -% \cad*{}... les preuves. -% \end{description} - -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. - -\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{itemize} - \item le titre récurrent est \meta{Nom}\footnote{\Cad*{}, quelle que soit la - langue en cours, le \meta{nom} de l'environnement \LaTeX{} dont l'initiale - est en majuscule.} ; - \item le style est \docValue{theorem}. - \end{itemize} - Cette commande crée également l'environnement \meta{nom}* produisant des - occurrences \emph{non} numérotées de ce \enquote{théorème}. - - Si les valeurs par défaut du titre récurrent (\meta{Nom}) ou du style - (\docValue{theorem}) ne conviennent pas, il suffit spécifier celles souhaitées - en \meta{option(s)} au moyen des clés \refKey{frenchtitle}, - \refKey{englishtitle} et \refKey{style} suivantes. - \begin{docKey}{frenchtitle}{={\meta{titre récurrent en français}}}{pas de - valeur par défaut, initialement vide} - Cette clé permet de spécifier un \meta{titre récurrent en français} - différent de \meta{Nom}. - \end{docKey} - \begin{docKey}{englishtitle}{={\meta{titre récurrent en anglais}}}{pas de - valeur par défaut, initialement vide} - Cette clé permet de spécifier un \meta{titre récurrent en anglais} différent - de \meta{Nom}. - \end{docKey} - \begin{docKey}{style}{=\docValue{theorem}\textbar\docValue{definition}\textbar\docValue{proof}}{pas - de valeur par défaut, initialement \docValue{theorem}} - Cette clé permet de spécifier le style du \enquote{théorème} à créer, au - moyen des valeurs \docValue{theorem}, \docValue{definition} et - \docValue{proof}. - \end{docKey} - -\newtheorem{article} -\newtheorem[frenchtitle=Fait,style=definition]{fact} -\begin{preamblecode}[listing options={deletekeywords={[1]{definition}},morekeywords={[3]{definition}}}] -\newtheorem{article} -\newtheorem[frenchtitle=Fait,style=definition]{fact} -\end{preamblecode} -\begin{bodycode}[listing and text] -\begin{article}[dit premier] -Les hommes naissent et demeurent libres et égaux en droits\ldots{} -\end{article} -\begin{fact*} -Tout ce qui est rare est cher. -\end{fact*} -\begin{fact} -Un cheval bon marché est rare. -\end{fact} -\end{bodycode} -\end{docCommand} - -\subsubsection{Code informatique} -\label{sec-commande-pour-code} - -La \gztauthorcl{} fournit des outils permettant de faire aisément figurer du -code informatique, notamment du code \LaTeX{} : -\begin{itemize} -\item l'environnement \refEnv{gztcode} pour des listings ; -\item la commande \refCom{gztverb} pour de courts extraits, notamment amenés - à figurer dans des phrases. -\end{itemize} - -\begin{docEnvironment}[doclang/environment content=listing]{gztcode}{\oarg{option(s)}} - Cet environnement permet de faire figurer un listing de code informatique dans - une boîte colorée. -\begin{bodycode}[listing and text] -Nous préconisons l'environnement \verb|align*| : -\begin{gztcode} -\begin{align*} - a & = a\\ - b & = b -\end{align*} -\end{gztcode} -\end{bodycode} -\end{docEnvironment} - -L'environnement \refEnv{gztcode} admet en argument optionnel la plupart des -(très nombreuses) options de l'environnement \docAuxEnvironment{tcblisting} du -\Package*{tcolorbox}. On retiendra notamment les options suivantes. - -\begin{docKey}{title}{=\meta{titre}}{pas de valeur par défaut, - initialement vide} - Cette clé permet de donner un \meta{titre} au listing. -\begin{bodycode}[listing and text,listing options={morekeywords={[2]title}}] -Nous préconisons l'environnement \verb|align*| : -\begin{gztcode}[title=Alignement d'équations] -\begin{align*} - a & = a\\ - b & = b -\end{align*} -\end{gztcode} -\end{bodycode} -\end{docKey} - -\begin{docKey}{listing and text}{}{} - Cette clé permet de, dans la boîte colorée, faire figurer en partie : - \begin{itemize} - \item haute, le listing ; - \item basse, son résultat compilé par \LaTeX{}. - \end{itemize} - % ^^A - \begin{dbwarning}{Option \protect\refKey*{listing and text} : seulement pour - du code \LaTeX{}}{} - L'option \refKey{listing and text} n'a de sens que pour un listing de code - \LaTeX{}. - \end{dbwarning} -\begin{tcboutputlisting} -\begin{gztcode}[listing and text] -L'environnement \verb|eqnarray| est obsolète et nous préconisons plutôt -\verb|align| : - -\begin{minipage}[t]{0.4\linewidth} - Avec l'environnement \verb|eqnarray*| : - \begin{eqnarray*} - a & = & a\\ - b & = & b - \end{eqnarray*} -\end{minipage} -\hspace{1cm} -\begin{minipage}[t]{0.4\linewidth} - Avec l'environnement \verb|align*| : - \begin{align*} - a & = a\\ - b & = b - \end{align*} -\end{minipage} -\end{gztcode} -\end{tcboutputlisting} -L'exemple suivant illustre l'usage de cette option\conseilslatex{}. Le -code : -\tcbinputlisting{codes,listing only,listing options={deletekeywords={listing}}} -donne : -\input{\jobname.listing} -\end{docKey} - -L'environnement \refEnv{gztcode} permet d'afficher du code informatique -arbitraire. Mais, dans les listings précédents, on constate que certaines -commandes \LaTeX{} sont mises en évidence, en l'occurrence en gras. Ceci -provient du fait que l'environnement \refEnv{gztcode} est configuré pour, par -défaut, colorer syntaxiquement le code \LaTeX{}. Mais d'autres langages sont -pris en charge. - -\begin{dbremark}{Environnement \protect\refEnv*{gztcode} : pas seulement pour le - code \LaTeX{}}{} - L'environnement \refEnv{gztcode} permet de colorer syntaxiquement le code - informatique de tout langage connu du \Package*{listings}. Pour ce faire, il - suffit de le spécifier (selon la syntaxe de ce package) en argument de - l'option \refKey{listing options} suivante. -\end{dbremark} - -\begin{docKey}{listing options}{}{} - Cette clé de l'environnement \refEnv{gztcode} permet de passer au listing - toute option connue du \Package*{listings}, notamment le langage sous-jacent - au moyen de l'option \docAuxKey{language}. -\lstset{escapechar={},escapeinside={}} -\begin{bodycode}[listing and text] -\lstdefinestyle{mon-style}{% - language=Python,% - basicstyle=\ttfamily,% - keywordstyle=\color{magenta},% - commentstyle=\color{gray}\itshape,% - stringstyle=\color{cyan}% -} -% -\begin{gztcode}[listing options={style=mon-style}] -"""Calcul de la factorielle""" # En python -def factorielle(x): - if x < 2: - return 1 - else: - return x * factorielle(x-1) -\end{gztcode} -\end{bodycode} -\lstset{escapechar="} -\end{docKey} - -\begin{docCommand}{gztverb}{\marg{code}} - Cette commande permet d'afficher \emph{verbatim}\footnote{\Cad*{} tel quel, - sans être interprété par \LaTeX{}.} un (court) extrait de \meta{code} passé en - argument. - - L'exemple suivant illustre l'usage de cette commande\conseilslatex. -\begin{bodycode}[listing and text,colback=white,listing options={deletekeywords={listing},deletekeywords={[3]style}}] -Dans le cas de \LaTeX, les commandes de style de caractères \gztverb{\bf}, -\gztverb{\it}, \gztverb{\sf}, \gztverb{\tt}, \gztverb{\sc}, \gztverb{\sl}, -\gztverb{\rm} sont désormais à proscrire. Elles doivent être remplacées par -les commutateurs, respectivement \gztverb{\bfseries}, \gztverb{\itshape}, -\gztverb{\sffamily}, \gztverb{\ttfamily}, \gztverb{\scshape}, -\gztverb{\slshape}, \gztverb{\rmfamily}. -\end{bodycode} -\end{docCommand} - -\section{Autres outils communs à tous types d'articles} -\label{sec-outils-communs-tous-1} - -Cette section donne une liste d'outils (commandes et environnements) fournis par -des packages automatiquement chargés par la \gztauthorcl\footnote{La - \vref{sec-packages-charges-par} liste ceux dont les fonctionnalités peuvent - être utiles aux auteurs.}. - -\begin{dbwarning}{Liste des fonctionnalités des packages tiers non exhaustive}{} - Cette liste est \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. - \end{itemize} -\end{dbwarning} - -\subsection{Guillemets, 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. - -\begin{docCommand}{enquote}{\marg{texte}} - Cette commande compose le \meta{texte} entre guillemets, automatiquement - adaptés : - \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. - \end{itemize} -\begin{bodycode}[listing and text] -Il lui répondit: \enquote{Courteline disait: \enquote{Passer pour un idiot aux - yeux d'un imbécile est une volupté de fin gourmet.}} -\end{bodycode} -\end{docCommand} - -\begin{docCommand}{textelp}{\marg{texte}} - Cette commande est à employer pour signifier une omission, avec éventuel ajout - de \meta{texte}. - - Cf. \vref{sec-epigraphes} pour un exemple d'utilisation de cette commande. -\end{docCommand} - -(\textsc{À suivre...}) - -\subsection{Adresses Web (\enquote{\textsc{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{\textsc{url}}), -même si elles comportent des caractères spéciaux de \TeX{} (|#|, |_|, |~|, -\lstinline[commentstyle={}]+%+, |&|, etc.). - -\begin{docCommand}{url}{\marg{adresse Web}} - Cette commande affiche l'\meta{adresse Web} saisie \emph{telle - quelle}\footnote{Notamment sans faire précéder les éventuels caractères - spéciaux qu'elle contient de la commande d'échappement - \protect\lstinline+\\+.} et fait d'elle un lien hypertexte. -\begin{bodycode}[listing and text,listing options={deletekeywords={[2]{url}},deletekeywords={[1]{math}}}] -Pour plus d'information, nous renvoyons à notre site Web -\url{http://math.univ-lille1.fr/~nwejm/}. -\end{bodycode} -\begin{bodycode}[listing and text,listing options={deletekeywords={[2]{url}},deletekeywords={[1]{exemple}}}] -Par exemple, \url{www.cnrs.fr/insmi/IMG/pdf/Parite_ReunionDU290312.pdf}. -\end{bodycode} -\end{docCommand} - -\subsection{Graphiques de très haute qualité} -\label{sec-graphiques-de-tres} - -Le \Package*{pgfplots} permet de créer aisément des graphiques (de dimensions -$2$ ou $3$) de très haute qualité, que ce soit pour représenter des fonctions ou -des jeux de données. - -(\textsc{À suivre...}) - -\subsection{Références croisées} -\label{sec-references-croisees} - -Le \Package*{cleveref}, utilisé conjointement avec le \Package*{varioref}, rend la -commande \refCom{vref} de ce dernier très puissante. - -\begin{docCommand}{vref}{\marg{label}} - Cette commande affiche le numéro de la référence labellisée par \meta{label} - et : - \begin{itemize} - \item affiche (ou pas selon le contexte) la page où se situe cette - référence\footnote{Fonctionnalité fournie par le \Package{varioref}.} ; - \item détecte automatiquement la nature de la référence (section, tableau, - figure, équation, théorème, etc.) et fait précéder le numéro de celle-ci du - mot clé correspondant\footnote{Fonctionnalité fournie par le - \Package{cleveref}.} ; - \item fait de la référence un lien hypertexte\footnote{Fonctionnalité fournie - par le \Package{hyperref}.}. - \end{itemize} -\begin{bodycode}[listing and text,listing options={deletekeywords={[2]url,[1]math}}] -[...] on se reportera à la \vref{sec-canevas-de-fichier} pour un canevas de -fichier source [...] -\end{bodycode} -\end{docCommand} - -\subsection{Épigraphes} -\label{sec-epigraphes} - -Le \Package*{epigraph} permet de composer des épigraphes au moyen de la commande -\refCom{epigraph}. - -\begin{docCommand}{epigraph}{\marg{épigraphe}{\marg{source}}} - Cette commande\footnote{Légèrement redéfinie par la \gztauthorcl.} compose un - \meta{épigraphe} et sa \meta{source} (qui peut éventuellement être vide). -\end{docCommand} - -\begin{bodycode}[listing and text] -\epigraph{% - Parce qu'un secret, ce n'est pas quelque chose qui ne se raconte pas. \textelp{}% -}{% - César\\M. \textsc{Pagnol}, \emph{César}. Livre de Poche~161, p.~115% -} -\end{bodycode} - -\begin{dbremark}{Source de l'épigraphe en entrée bibliographique}{} - La source de l'épigraphe pourra faire l'objet d'une entrée bibliographique en - vue d'être citée en 2\ieme{} argument de \refCom{epigraph} au moyen de la - commande \lstinline[moretexcs={fullcite}]+\fullcite+ du \Package*{biblatex} - (cf. \vref{sec-bibliographie}).% - \footnote{% - \lstset{deletekeywords={options},deletekeywords={[2]skipbib},morekeywords={[2]{options}},morekeywords={[3]skipbib}}% - Dans le fichier \hologo{BibTeX}, on ajoutera à cette entrée la ligne - % - \protect\lstinline+options = \{skipbib\}+ - % - pour éviter que cette source figure dans la liste des - références bibliographiques.% - } -\end{dbremark} - -% Dans le source \hologo{BibTeX} de l'exemple suivant, on notera la ligne -% \lstinline|options = {skipbib}| permettant d'éviter que la source de l'épigraphe -% ne figure dans la liste des références bibliographiques. -% \begin{preamblecode}[title=Source \hologo{BibTeX}] -% @book{pagnol, -% title = {César}, -% author = {Pagnol, Marcel}, -% number = {161}, -% pages = {115}, -% series = {Livre de poche}, -% options = {skipbib} -% } -% \end{preamblecode} -% \begin{bodycode}[listing and text,listing options={deletekeywords={options,[2]number}}] -% \epigraph{Je ne peux pas vous le dire à tous à la fois, et si vite que ça. Parce -% qu'un secret, ce n'est pas quelque chose qui ne se raconte pas. Mais c'est une -% chose qu'on se raconte à voix basse, et séparément.}{César\\\fullcite{pagnol}} -% \end{bodycode} - - -\subsection{Listes en ligne} -\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 -\enquote{à puces}, \enquote{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}, \cad*{} 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 de la \gzt{} car cela pourrait - contrevenir à la marche typographique qu'elle a adoptée.}. - -\begin{docEnvironment}[doclang/environment content=liste]{itemize*}{} - Cet environnement compose une liste \enquote{à puces} en ligne. -\end{docEnvironment} - -\begin{docEnvironment}[doclang/environment content=liste]{enumerate*}{} - Cet environnement compose une liste \enquote{numérotée} en ligne. -\end{docEnvironment} - -\begin{docEnvironment}[doclang/environment content=liste]{description*}{} - Cet environnement compose une liste \enquote{de description} en ligne. -\end{docEnvironment} - -\begin{bodycode}[listing and text,listing options={deletekeywords={[1]math,[2]url}}] -\begin{enumerate} -\item Les données que j'ai rassemblées [...] -\item Les données que j'ai recueillies sont - \begin{enumerate*} - \item disponibles publiquement sur internet : [...] ; - \item accessibles par Wikipédia, [...] ; - \item pour 60 des conférenciers [...]. - \end{enumerate*} -\end{enumerate} -\end{bodycode} - -\section{Canevas de fichier source typique} -\label{sec-canevas-de-fichier} - -\newcommand{\attachfilename}{mon-article.tex}% -\newcommand{\attachfiletextlink}{Canevas de fichier source typique}% -\tcbset{listing file=\attachfilename}% -\begin{tcboutputlisting} -\documentclass{gztarticle} -% -% Indiquer le (chemin vers le) fichier .bib utilisé. -\addbibresource{.bib} -% -\begin{document} -\title{} -% \subtitle[short=]{} -% -\author[% - affiliation={% - },% - photo=,% - email=,% - webpage=,% - minibio={% - }% -]{} -% -% \acknowledgements{% -% } -% -% \begin{abstract} -% \end{abstract} -% -\maketitle -% -% Ici vient le contenu de l'article. - -% -\printbibliography % ou \printauthorsdetails -\end{document} -\end{tcboutputlisting} -% -Pour le lecteur souhaitant écrire un article pour la \gzt*{}, un modèle typique -d'article standard\footnote{Où les commandes et environnement moins fréquents - ont été mis en commentaire.} est : -\begin{itemize} -\item reproduit ci-dessous ; -\item attaché à la version \format{pdf} du présent document et atteignable par - simple clic sur l'icône ci-dessous. -\end{itemize} -% -\tcbinputlisting{% - codes, - listing only,% - listing options={moretexcs={addbibresource}},% - title={\attachfiletextlink\ \attachfile{\attachfilename}}% -} - -%%% Local Variables: -%%% mode: latex -%%% eval: (latex-mode) -%%% ispell-local-dictionary: "fr_FR" -%%% TeX-master: "../gzt-fr.tex" -%%% End: diff --git a/Master/texmf-dist/doc/latex/gzt/latexmkrc b/Master/texmf-dist/doc/latex/gzt/latexmkrc deleted file mode 100644 index 400046cd557..00000000000 --- a/Master/texmf-dist/doc/latex/gzt/latexmkrc +++ /dev/null @@ -1,23 +0,0 @@ -$pdf_mode = 1; - -$bibtex_use = 1; -$bibtex = 'biber %O %B'; - -add_cus_dep('glo', 'gls', 0, 'makeglossaries'); -add_cus_dep('acn', 'acr', 0, 'makeglossaries'); -add_cus_dep('slo', 'sls', 0, 'makeglossaries'); -sub makeglossaries{ - system( "makeglossaries \"$_[0]\"" ); -} - -add_cus_dep('idx', 'ind', 0, 'texindy'); -sub texindy{ - system("texindy -L french \"$_[0].idx\""); -} - -push @generated_exts, 'acn', 'acr', 'alg', 'bcf', 'fls', 'gl*', 'sbl*', 'sl*', 'sym*' ; - -$clean_ext .= 'synctex.gz* run.xml tex.bak ind idx out bbl bcf fdb_latexmk run - tdo listing *~ lo* unq mw tcbtemp ins drv atfi db* ain' ; - -$quote_filenames = 0; diff --git a/Master/texmf-dist/doc/latex/gzt/latexmkrc.tex b/Master/texmf-dist/doc/latex/gzt/latexmkrc.tex deleted file mode 100644 index 400046cd557..00000000000 --- a/Master/texmf-dist/doc/latex/gzt/latexmkrc.tex +++ /dev/null @@ -1,23 +0,0 @@ -$pdf_mode = 1; - -$bibtex_use = 1; -$bibtex = 'biber %O %B'; - -add_cus_dep('glo', 'gls', 0, 'makeglossaries'); -add_cus_dep('acn', 'acr', 0, 'makeglossaries'); -add_cus_dep('slo', 'sls', 0, 'makeglossaries'); -sub makeglossaries{ - system( "makeglossaries \"$_[0]\"" ); -} - -add_cus_dep('idx', 'ind', 0, 'texindy'); -sub texindy{ - system("texindy -L french \"$_[0].idx\""); -} - -push @generated_exts, 'acn', 'acr', 'alg', 'bcf', 'fls', 'gl*', 'sbl*', 'sl*', 'sym*' ; - -$clean_ext .= 'synctex.gz* run.xml tex.bak ind idx out bbl bcf fdb_latexmk run - tdo listing *~ lo* unq mw tcbtemp ins drv atfi db* ain' ; - -$quote_filenames = 0; diff --git a/Master/texmf-dist/doc/latex/gzt/notations.tex b/Master/texmf-dist/doc/latex/gzt/notations.tex deleted file mode 100644 index 666d6059a9e..00000000000 --- a/Master/texmf-dist/doc/latex/gzt/notations.tex +++ /dev/null @@ -1,138 +0,0 @@ -\etocsettocdepth.toc{section}% -% -\section{Notations, syntaxe, terminologie et codes couleurs}\label{sec-synt-term-notat} - -Ce chapitre précise les notations, syntaxe, terminologie et codes couleurs de -la présente documentation. - - -\subsection{Commandes, environnements, clés, valeurs}\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 : -\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}. -\end{itemize} - -\subsection{Arguments génériques} -\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é : -\begin{itemize} -\item en fonte à chasse fixe ; -\item en italique ; -\item entre chevrons simples ; -\end{itemize} -le tout en marron, ainsi : \meta{argument générique}. - -\subsection{Liens hypertextes} -\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) : -\begin{itemize} -\item \refCom{author} ; -\item \refEnv{abstract}. -\end{itemize} - - -\subsection{Éléments \enquote{obligatoires}} -\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}. - -\subsection{Codes sources} -\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. -% 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 de couleur bleu : -\begin{itemize} -\item non ombrés s'ils doivent être saisis dans le corps du document ; -\item ombrés s'ils doivent être saisis en préambule du fichier (maître). -\end{itemize} -Ces cadres pourront en outre comporter d'éventuels titres : -\begin{multicols}{2} -\begin{bodycode} -"\meta{code source}" -\end{bodycode} -\begin{bodycode}[title=\meta{titre}] -"\meta{code source}" -\end{bodycode} -\begin{preamblecode} -"\meta{code source à insérer en préambule}" -\end{preamblecode} -\begin{preamblecode}[title=\meta{titre}] -"\meta{code source à insérer en préambule}" -\end{preamblecode} -\end{multicols} - -\subsection{Espaces dans les codes sources} -\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]+ +. - -\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 se présentent sous la forme -\meta{clé}|=|\meta{valeur} et la \meta{valeur} passée à une \meta{clé} peut -être : -%^^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: -%^^A \begin{docKey*}{option}{}{\meta{valeurs par défaut et initiale}} -%^^A \meta{Description de \refKey{option}} -%^^A \end{docKey*} -%^^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}} - \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}, \docValue*{valeur2}, ..., \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\docValue*{valeur2}\textbar...\textbar\docValue*{valeurN}}{\meta{valeurs par défaut et initiale}} - \meta{Description de \refKey{choicekey} et de ses valeurs possibles} - \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 : -\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. -\end{description} - -%%% Local Variables: -%%% mode: latex -%%% eval: (latex-mode) -%%% ispell-local-dictionary: "fr_FR" -%%% TeX-master: "../gzt-fr.tex" -%%% End: diff --git a/Master/texmf-dist/doc/latex/gzt/packages-charges.tex b/Master/texmf-dist/doc/latex/gzt/packages-charges.tex deleted file mode 100644 index d51dbb840b3..00000000000 --- a/Master/texmf-dist/doc/latex/gzt/packages-charges.tex +++ /dev/null @@ -1,38 +0,0 @@ -\section{Packages chargés par la classe}\label{sec-packages-charges-par} - -On a vu que, pour plusieurs de ses fonctionnalités, la \gztauthorcl{} s'appuie -sur des packages qu'elle charge automatiquement. Ceux dont les fonctionnalités -peuvent être utiles aux auteurs sont répertoriés dans la liste suivante qui -indique leur fonction et le cas échéant : -\begin{itemize} -\item la ou les options avec lesquelles ils sont chargés ; -\item les options de la \gztauthorcl{} ou leurs commandes propres permettant de les - personnaliser. -\end{itemize} -En sus des outils propres à la \gztauthorcl, tous ceux fournis par ces -différents packages sont donc à disposition des auteurs de la \gzt{}. - -\begin{description} -\item[\package{xcolor} :] couleurs ; - \begin{description} - \item[option par défaut :] \docAuxKey{table} et \docAuxKey{cmyk} ; - \end{description} -\item[\package{kpfonts} :] police principale du document ; - \begin{description} - \item[option par défaut :] \docAuxKey{sfmath}, \docAuxKey{easyscsl}, - \docAuxKey{noDcommand} ; - \end{description} -\item[\package*{graphicx} :] inclusion d'images ; -\item[\package*{csquotes} :] citations formelles et informelles ; - \begin{description} - \item[option par défaut :] \docAuxKey{autostyle} ; - \end{description} -\item[...] (à suivre). -\end{description} - -%%% Local Variables: -%%% mode: latex -%%% eval: (latex-mode) -%%% ispell-local-dictionary: "fr_FR" -%%% TeX-master: "../gzt-fr.tex" -%%% End: diff --git a/Master/texmf-dist/doc/latex/gzt/todo.tex b/Master/texmf-dist/doc/latex/gzt/todo.tex deleted file mode 100644 index 0a266c3d2ba..00000000000 --- a/Master/texmf-dist/doc/latex/gzt/todo.tex +++ /dev/null @@ -1,15 +0,0 @@ -\chapter{To do} -\label{cha:do} - -% \begin{enumerate} -% \item Revoir les pointillés de la 2\ieme{} de couverture avec le \Pkg{TikZ} (au -% moyen de quelque chose comme : -% \verb|\tikz \draw[dotted] (0pt,0pt) -- (50pt,0pt);|). -% \end{enumerate} - -%%% Local Variables: -%%% mode: latex -%%% eval: (latex-mode) -%%% ispell-local-dictionary: "fr_FR" -%%% TeX-master: "../gzt-fr.tex" -%%% End: -- cgit v1.2.3