summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/paresse/paresse-fra.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/paresse/paresse-fra.tex')
-rw-r--r--Master/texmf-dist/doc/latex/paresse/paresse-fra.tex421
1 files changed, 421 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/paresse/paresse-fra.tex b/Master/texmf-dist/doc/latex/paresse/paresse-fra.tex
new file mode 100644
index 00000000000..cb9cbea48ef
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/paresse/paresse-fra.tex
@@ -0,0 +1,421 @@
+%%
+%% This is file `paresse-fra.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% paresse.dtx (with options: `doc,FRA')
+%%
+%% Do not distribute this file without also distributing the
+%% source files specified above.
+%%
+%% Do not distribute a modified version of this file.
+%%
+%% File: paresse.dtx
+%% Copyright (C) 2020 Yvon Henel aka Le TeXnicien de surface
+%%
+%% It may be distributed and/or modified under the conditions of the
+%% LaTeX Project Public License (LPPL), either version 1.3c of this
+%% license or (at your option) any later version. The latest version
+%% of this license is in the file
+%%
+%% http://www.latex-project.org/lppl.txt
+%%
+\RequirePackage{expl3}[2020/09/24]
+\GetIdInfo$Id: paresse.dtx 5.0 2020-10-06 TdS $
+ {}
+\documentclass[full, french]{l3doc}
+\usepackage[utf8]{inputenc}
+\usepackage[T1]{fontenc}
+\usepackage[english,main=french]{babel}
+\usepackage{xparse}
+\usepackage{xspace}
+
+\usepackage[tame]{paresse}[2020-10-06]
+
+\newcommand*\PS{\texttt{\S}\xspace}
+\newcommand*\PSVerb[1]{\texttt{\S #1}}
+\newcommand\BOP{\discretionary{}{}{}}
+\newcommand\Option[1]{\textsc{#1}}
+\newcommand{\TO}{\textemdash\ \ignorespaces}
+\newcommand{\TF}{\unskip\ \textemdash\xspace}
+
+\begin{document}
+\title{Guide de l'utilisateur de \pkg{paresse}\thanks{Ce fichier décrit la
+ version~\ExplFileVersion, dernière révision~\ExplFileDate. Édition
+ \emph{Adieu à skeyval}.}}
+\author{Yvon Henel\thanks{E-mail:
+ \href{mailto:le.texnicien.de.surface@yvon-henel.fr}
+ {le.texnicien.de.surface@yvon-henel.fr}}}
+\maketitle
+\noindent\hrulefill
+
+\begin{abstract}
+ Cette extension, reprenant un exemple de T.~\textsc{Lachand-Robert}
+ dans~\cite{tlachand}, fournit un moyen de taper des lettres grecques isolées
+ à l'aide du caractère \PS actif et redéfini. Au lieu de |\(\alpha\)| ou tape
+ \PSVerb{a} pour obtenir \(\alpha\).
+
+ \textbf{Important} : Il doit être chargé \textbf{après} \pkg{inputenc} si ce
+ dernier est utilisé. De plus, il faut que le signe \PS soit une lettre pour
+ \TeX.
+
+ Depuis la version~4, on peut utiliser cette extension même dans un source
+ codé en utf-8 avec \hologo{LaTeX}, \hologo{LuaLaTeX} ou \hologo{XeLaTeX}.
+\end{abstract}
+
+\noindent\hrulefill
+
+ \begin{otherlanguage}{english}
+\begin{abstract}
+The English documentation for the final user of the package
+\pkg{paresse} is available in the file \texttt{paresse-eng}.
+\end{abstract}
+\end{otherlanguage}
+
+\noindent\hrulefill
+\vspace{\baselineskip}
+
+\tableofcontents{}
+
+\section{Introduction}
+\label{sec:introduction}
+
+Cette extension ne fournit qu'un accès \og rapide et économique \fg aux lettres
+grecques qui s'obtiennent à l'aide d'une macro comme \cs{alpha} ou
+\cs{Omega}. Elle fournit un environnement et une commande qui permettent
+d'utiliser § pour taper ces lettres. Un \cs{ensuremath} nous dispense de nous
+placer explicitement \TO c'est-à-dire en tapant |$ $| ou bien |\( \)| ou encore
+|\[ \]| ou tout autre chose ayant le même effet\TF en mode mathématique pour
+obtenir une lettre grecque.
+
+
+L'idée de la méthode est due à T.~\textsc{Lachand-Robert} et est
+exposée dans~\cite{tlachand}. Je n'ai fait qu'ajouter le
+\cs{ensuremath} bien agréable pour l'écriture de macros.
+
+Bien entendu, on \textbf{ne} dispose \textbf{pas} de macros pour la
+minuscule omicron ni pour les majuscules alpha, beta\dots{} qui
+s'obtiennent à l'aide des latines romaines de même
+apparence\footnote{Je ne ferai aucune remarque sur les problèmes de
+ codage que cela pose.}. Je ne me suis pas senti le courage ni la
+force de fournir une solution qui permettent d'obtenir dans une
+formule baignant dans un texte en italique gras un alpha majuscule
+droit, romain, \&c.
+
+Pour finir cette introduction, glosons le nom de cette
+extension. |paresse| vient de ce que le signe § indique un \og
+paragraphe \fg en ayant une forme lointainement apparentée au
+S et n'a donc aucun lien avec le \emph{défaut} si fréquent,
+encore que, à bien y réfléchir\dots
+
+\subsection{Pourquoi une 5\ieme version?}
+
+\emph{Sur mon brin de laurier, je dormais comme un loir} en utilisant
+\pkg{paresse} presque quotidiennement quand il y a quelques jours, patatras!
+Plus rien ne va, je me fais insulter rien qu'à charger l'extension. Je passe sur
+les détails: la faute en revient à une modification du noyau qui vient perturber
+le code acrobatique de \pkg{skeyval}. Comme la mise à jour de la dite extension
+semble extrèmement improbable, j'ai décidé de réparer \pkg{paresse} en recourant
+aux commandes de expl3.
+
+Ce n'est donc que pour remettre en marche ce dont je me sers souvent que je
+viens soulever le capot de cette extension vieille de plus de 7~ans.
+
+Avec cette 5\ieme version, apparaissent deux \emph{sous}-extensions:
+\pkg{paresse-old} et \pkg{paresse-utf8} que l'on peut charger directement et qui
+offrent les mêmes options et les mêmes commandes. De fait, \pkg{paresse} charge
+l'une ou l'autre suivant la situation.
+
+On utilisera \pkg{paresse-utf8} uniquement si le source est codé en utf-8 et que
+l'on compile avec \texttt{latex} c.-à-d. avec le moteur \TeX{} et le format
+\LaTeX{}. Dans tous les autres cas de figure on utilisera \pkg{paresse-old}.
+
+La documentation de \pkg{paresse} couvre donc l'utilisation des trois
+extensions.
+
+\subsection{Pourquoi une 4\ieme version?}
+
+Je ne sais plus bien à quelle occasion \TO l'age et les pannes de machine
+avec \og crachage\fg de disque aidant\TF et encore moins quand \TO si ce
+n'est que cela remonte à plus d'un an maintenant\footnote{J'ai écrit cette
+ section à l'occasion de la sortie de la 4\ieme version, en 2013.}\TF
+Christian \textsc{Tellechea} me faisait part de son désir d'utiliser
+\pkg{paresse} avec des sources codées en utf-8 sous \hologo{LaTeX} \TO et
+non \hologo{XeLaTeX} ou \hologo{LuaLaTeX}.
+
+Une discussion s'engagea, Christian me fit parvenir du matériel en
+ordre de marche. Il me fit même cadeau de deux versions, la deuxième
+améliorant la reconnaissance du codage déclaré avec
+\pkg{inputenc}. Toutefois, je procrastinais. Il se peut que ma vie
+personnelle et mon travail aient interféré avec le développement de
+cette extension.
+
+Enfin, voici la chose.
+
+Le plus nouveau devrait échapper à l'utilisateur de \hologo{LuaLaTeX}
+ou \hologo{XeLaTeX} et même de \hologo{LaTeX} chargeant \pkg{inputenc}
+avec une option comme \texttt{latin1} ou \texttt{latin9}. Cependant,
+désormais, on peut utiliser cette extension avec \hologo{LaTeX} en
+chargeant \pkg{inputenc} avec l'option \texttt{utf8}.
+
+J'ai profité de cette nouvelle version pour ajouter une macro en \PS:
+\PSVerb{Z} qui produit \S, symbole déjà accessible par |\S|, ce qui
+fait que je n'ose pas vraiment parler de \og raccourci\fg.
+
+\subsection{Pourquoi une 3\ieme version?}
+
+C'est par courriel que Claudio \textsc{Beccari} m'a signalé très
+aimablement qu'il existait un codage de l'alphabet grec en lettres
+latines près de 15~ans avant que je ne commette cette extension. Ce
+codage était dû à Sylvio \textsc{Levi} qui l'avait mis au point, alors
+qu'il dessinait les premières fontes grecques pour \TeX, en s'appuyant
+sur la correspondance entre les claviers américain et grec. Il me
+faisait remarquer à juste titre que si quelqu'un avait pris l'habitude
+du codage de Sylvio \textsc{Levi}, il préférerait conserver ses
+habitudes pour \pkg{paresse}.
+
+J'ai donc décidé de fournir un nouveau couple d'options exclusives
+l'une de l'autre que j'ai nommées, pour l'une, \Option{legacy} ---
+pour \og héritage\fg --- qui assure le codage originel de cette
+extension et qui est active par défaut et, pour l'autre, \Option{Levi}
+qui assure le codage de Sylvio \textsc{Levi}.
+
+J'en profite pour faire quelques changements cosmétiques:
+désormais toutes les macros internes \emph{secrètes}\footnote{À la mode
+ \LaTeXe{}, pour la version~5.0 j'utilise en partie expl3 et, dans ce cas,
+ le préfixe \texttt{paresse}.} ont un nom qui
+commence par \cs{GA@};
+le fichier |.dtx| est réorganisé pour faciliter la tache de
+traduction de la documentation.
+
+\section{Utilisation}
+
+On charge cette extension avec |\usepackage{paresse}|. Quand on utilise
+\hologo{LaTeX} avec un codage 8-bits (comme \texttt{latin9} par exemple),
+on la charge \textbf{après} l'extension \pkg{inputenc} avec l'option
+idoine. Avec un \hologo{LaTeX} moderne \TO post 2019\TF et un source codé
+en utf-8, on n'a pas besoin de charger explicitement \pkg{inputenc}. Dans
+ce cas, \pkg{paresse} suppose que le source est codé en utf-8.
+
+Dans tous les cas il faut que le \og caractère \fg § soit reconnu par \TeX\
+comme une lettre.
+
+
+On obtiendra le même comportement, à l'exception \TO signalée dans le
+paragraphe intitulé \textbf{restriction} page~\pageref{restriction}\TF
+près, avec \pkg{inputenc} et l'option \texttt{utf8}.
+
+Il n'y a pas ce genre de restriction quand on travaille avec
+\hologo{LuaLaTeX} ou \hologo{XeLaTeX} sur un source codé en utf-8.
+
+Par défaut, l'extension est chargée avec l'option |wild| ce qui
+signifie que les macros de la forme |§a| sont disponibles. Si l'on
+préfère, on peut passer à \pkg{paresse} l'option \Option{tame} avec
+|\usepackage[tame]|\BOP|{paresse}|. Il faut alors utiliser la commande
+\cs{ActiveLaParesse} ou l'environnement |ParesseActive| pour utiliser
+les macros en~§.
+
+Lorsque la \og paresse est active \fg, il suffit de taper |§a| pour
+obtenir \(\alpha\). On a de même accès à toutes les lettres grecques
+auxquelles sont consacrées une macro comme \cs{alpha},
+voyez~\ref{codageorig} et~\ref{codagelevi}. On obtient, de même,
+\(\alpha^{\beta}\) avec |\(§a^{§b}\)| lorsque § est active.
+
+\paragraph{Restriction}
+On notera que les accolades sont optionelles et qu'on obtient un
+résultat identique avec |\(§a^§b\)|, \textbf{à moins que} l'on utilise
+un source codé en utf-8 avec \hologo{LaTeX}.\label{restriction}
+
+
+\section{Les options de l'extension}
+\label{sec:clefs}
+
+
+\begin{itemize}
+\item \Option{tame} \DescribeOption{tame / wild} s'oppose à
+ \Option{wild} qui est l'option par défaut. Lorsque \Option{tame}
+ règne, il \textbf{faut} un environnement |ParesseActive| ou une
+ commande \cs{ActiveLaParesse} pour utiliser les macros à §.
+
+\item \Option{Levi} \DescribeOption{legacy / Levi} s'oppose à
+ \Option{legacy} qui est l'option par défaut. Avec l'option
+ \Option{legacy} on utilise le codage \og originel\fg de
+ \pkg{paresse} tel que le donne la
+ table~\ref{codageorig}. Sinon, le codage est celui défini par Sylvio
+ \textsc{Levi}, cf. la table~\ref{codagelevi}.
+
+\item \Option{ttau} \DescribeOption{ttau / ttheta} s'oppose à
+ \Option{ttheta} qui est l'option par défaut. Lorsque \Option{ttheta}
+ est active |§t| donne \(\theta\) dans le cas contraire |§t| donne
+ \(\tau\). En tous cas, \(\theta\) est accessible par |§v| et
+ \(\tau\) par |§y|. Cette option est inopérante si l'option
+ \Option{Levi} a été choisie.
+
+ \textbf{Remarque :} quand l'option \Option{legacy} a été choisie,
+ \(\Theta\) est obtenu par |§V| de manière \og régulière \fg et
+ \emph{également} par |§T| quelle que soit l'option choisie. Dans
+ le cas de l'option \Option{Levi}, |§V| ne correspond à aucune lettre
+ grecque.
+
+\item \Option{epsilon} \DescribeOption{epsilon / varepsilon} s'oppose à
+ \Option{varepsilon} qui est l'option par défaut. Avec
+ \Option{epsilon}, |§e| donne \(\epsilon\) sinon |§e| donne
+ \(\varepsilon\).
+
+\item Se comportent comme le couple \Option{epsilon},
+ \Option{varepsilon} les couples suivants \Option{theta} et
+ \Option{vartheta} ; \Option{pi} et \Option{varpi} ; \Option{rho} et
+ \Option{varrho} ; \Option{sigma} et \Option{varsigma} \og |§s| donne
+ \(\varsigma\)\fg; \Option{phi} et \Option{varphi}.
+\end{itemize}
+
+Par défaut on a \Option{varepsilon}, \Option{theta}, \Option{pi},
+\Option{rho}, \Option{sigma}, \Option{varphi}, \Option{wild} et
+\Option{legacy}. Cela assure que cette version~3, se comporte,
+par défaut, comme la précédente.
+
+\subsection{Commandes et environnement}
+
+\DescribeMacro{\makeparesseletter}
+Cette macro donne au \og caractère \fg § le catcode d'une
+lettre. Après cela, on peut se servir de § dans un nom de macro, par
+exemple. C'est le pendant de \cs{makeatletter}.
+
+\DescribeMacro{\makeparesseother}
+Cette macro donne au caractère § le catcode \emph{other}. C'est le \og
+contraire \fg de la précédente. Cela équivaut au \cs{makeatother}.
+
+Cette macro est inactive avec un codage utf-8 sous
+\hologo{LaTeX}. Elle n'aurait d'ailleurs pas vraiment de sens. Son
+utilisation produit un avertissement dans le fichier |.log|.
+
+\DescribeMacro{\ActiveLaParesse}
+Cette macro active le caractère § et permet ainsi d'accéder aux
+macros dont le nom commence par § comme |§a|. Pour une liste de ces
+macros et leurs significations, voyez les tableaux~\ref{codageorig}
+et~\ref{codagelevi}.
+
+\DescribeEnv{ParesseActive}
+Dans cet environnement le caractère § est actif ce qui permet
+d'utiliser les macros en §. On utilisera cet environnement si l'on
+veut utiliser les macros quand on a chargé l'extension
+\pkg{paresse} avec l'option \texttt{tame}.
+
+\newpage{}
+
+\subsection{Tableaux des macros}
+
+\subsubsection{Codage originel de \pkg{paresse}}
+
+C'est le codage actif lorsque l'on a choisit les options \Option{legacy} et
+\Option{ttheta} qui sont des options par défaut.
+
+Cette version~5.0 ajoute \(\varsigma\) obtenu avec \PSVerb{j}.
+
+\begin{center}\Large
+\begin{ParesseActive} \label{codageorig}
+\begin{tabular}{*4{||>{\ttfamily \S}c|c}||}\hline
+a & §a & b & §b & g & §g & d & §d\\ \hline
+e & §e & z & §z & h & §h & v & §v\\ \hline
+i & §i & k & §k & l & §l & m & §m\\ \hline
+n & §n & x & §x & p & §p & r & §r\\ \hline
+s & §s & y & §y & u & §u & f & §f\\ \hline
+c & §c & q & §q & w & §w &\multicolumn{1}{c|}{}&\\ \hline\hline
+G & §G & D & §D & V & §V & L & §L\\ \hline
+X & §X & P & §P & S & §S & U & §U\\ \hline
+F & §F & Q & §Q & W & §W & Z & §Z\\ \hline
+\end{tabular}
+\end{ParesseActive}
+\end{center}
+
+\vspace{2\baselineskip}
+
+\begin{center}\Large
+\begin{ParesseActive} \label{codageorig}
+\begin{tabular}{*7{||>{\ttfamily \S}c|c}||}\hline
+a&§a&b&§b&c&§c&d&§d&e&§e&f&§f\\ \hline
+g&§g&h&§h&i&§i&j&§j&k&§k&l&§l\\ \hline
+m&§m&n&§n&o& &p&§p&q&§q&r&§r\\ \hline
+s&§s&t&§t&u&§u&v&§v&w&§w&x&§x\\ \hline
+y&§y&z&§z&A& &B& &C& &D&§D\\ \hline
+E& &F&§F&G&§G&H& &I& &J& \\ \hline
+K& &L&§L&M& &N& &O& &P&§P\\ \hline
+Q&§Q&R& &S&§S&T&§T&U&§U&V&§V\\ \hline
+W&§W&X&§X&Y& &Z&§Z&\multicolumn{4}{c||}{}\\ \hline
+\end{tabular}
+\end{ParesseActive}
+\end{center}
+
+\paragraph{Remarques : } à l'exception de {\ActiveLaParesse §v, §y, §q et §j}
+les lettres utilisées dans les noms des macros sont chargées de vertu
+mnémotechniques \texttt{:-)} et les capitales grecques, quand elles différent
+des capitales latines, s'obtiennent à l'aide de la majuscule correspondante.
+
+\pagebreak[4]
+
+\subsubsection{Codage de Sylvio \textsc{Levi}}
+
+On active ce codage avec l'option \Option{Levi}.
+
+\begin{center}\Large
+\begin{ParesseActive} \label{codagelevi}
+\begin{tabular}{*4{||>{\ttfamily \S}c|c}||}\hline
+a & §a & b & §b & g & §g & d & §d\\ \hline
+e & §e & z & §z & h & §h & j & §v\\ \hline
+i & §i & k & §k & l & §l & m & §m\\ \hline
+n & §n & x & §x & p & §p & r & §r\\ \hline
+s & §s & t & §y & u & §u & f & §f\\ \hline
+q & §c & y & §q & w & §w & c & \(\varsigma\)\\ \hline\hline
+G & §G & D & §D & J & §V & L & §L\\ \hline
+X & §X & P & §P & S & §S & U & §U\\ \hline
+F & §F & Y & §Q & W & §W & Z & §Z\\ \hline
+\end{tabular}
+\end{ParesseActive}
+\end{center}
+
+Le codage de Sylvio \textsc{Levi} donne accès directement à \cs{varsigma}
+(\(\varsigma\)) avec |§c| et ne diffère du codage originel que pour
+les lettres {\ActiveLaParesse §v, §y, §c et §q}. Voici un résumé de
+ces différences:
+
+\begin{center}
+\newcommand\CT[1]{\multicolumn{1}{c|}{\texttt{#1}}}
+\begin{ParesseActive}
+\begin{tabular}{|l|*{7}{c|}}\hline
+lettres grecques
+& §v & §y & §c & §q & §V & §Q & \(\varsigma\)\\\hline
+codage originel
+&\CT{\S{}v/\S{}t}&\CT{\S{}y/\S{}t}&\CT{\S{}c}
+&\CT{\S{}q}&\CT{\S{}V/\S{}T}&\CT{\S{}Q}& \CT{\S{}j} \\\hline
+codage de S. \textsc{Levi}
+&\CT{\S{}j}&\CT{\S{}t}&\CT{\S{}q}&\CT{\S{}y}
+&\CT{\S{}J}&\CT{\S{}Y} & \CT{\S{}c}\\\hline
+\end{tabular}
+\end{ParesseActive}
+\end{center}
+
+\vspace{\stretch{2}}
+
+\begin{thebibliography}{99}
+\addcontentsline{toc}{section}{Bibliographie}
+\bibitem{tlachand} T.~\textsc{Lachand-Robert}.
+\emph{La maîtrise de \TeX{} et \LaTeX{}}.
+Masson, Paris, Milan, Barcelone, \oldstylenums{1995}.
+\textsc{isbn} : \texttt{2-225-84832-7}.
+\end{thebibliography}
+
+\vspace{\stretch{2}}
+
+\noindent\hspace*{0.2\textwidth}\hrulefill\hspace*{0.2\textwidth}
+\begin{center}
+ \textsl{Le TeXnicien de Surface scripsit.}
+\end{center}
+\noindent\hspace*{0.2\textwidth}\hrulefill\hspace*{0.2\textwidth}
+
+\vspace*{\stretch{2}}
+
+\end{document}
+\endinput
+%%
+%% End of file `paresse-fra.tex'.