diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/paresse/paresse-fr.ltx')
-rw-r--r-- | Master/texmf-dist/doc/latex/paresse/paresse-fr.ltx | 375 |
1 files changed, 375 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/paresse/paresse-fr.ltx b/Master/texmf-dist/doc/latex/paresse/paresse-fr.ltx new file mode 100644 index 00000000000..a207479d417 --- /dev/null +++ b/Master/texmf-dist/doc/latex/paresse/paresse-fr.ltx @@ -0,0 +1,375 @@ +%% +%% This is file `paresse-fr.ltx', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% paresse-doc.dtx (with options: `doc,fr') +%% This is a generated file. +%% +%% Copyright (C) 2011 +%% by Yvon Henel, alias le TeXnicien de surface +%% <le.texnicien.de.surface@wanadoo.fr> +%% +%% This file may be distributed and/or modified under the conditions of +%% the LaTeX Project Public License, either version 1.2 of this license +%% or (at your option) any later version. The latest version of this +%% license is in: +%% +%% http://www.latex-project.org/lppl.txt +%% +%% and version 1.2 or later is part of all distributions of LaTeX +%% version 1999/12/01 or later. +\documentclass[a4paper]{ltxdoc} +\usepackage[latin1]{inputenc} +\usepackage[T1]{fontenc} +\usepackage[tame]{paresse} +\usepackage{xspace,url,array,ifthen,hologo} +\IfFileExists{lmodern.sty}{\usepackage{lmodern}}{} +\usepackage[english,frenchb]{babel} +\usepackage[colorlinks=true, + linkcolor=blue, + urlcolor=blue, + citecolor=blue]{hyperref} +\input{common} +\makeatletter +\newcommand\DescribeOption[1]{\@bsphack \marginpar{\raggedleft + \textsc{#1}}\index{#1 (option)}\@esphack} +\newcommand*\PS{\texttt{\S}\xspace} +\newcommand*\PSVerb[1]{\texttt{\S #1}} +\GlossaryPrologue{% + \section*{{Changements}} + \markboth{{Changements}}{{Changements}}} +\IndexPrologue{% + \section*{Index}\markboth{Index}{Index}% + Les nombres en italique renvoient à la page où l'entrée est décrite; + les nombres soulignés renvoient à la ligne de code de la définition; + les nombres en caractères romains renvoient à la ligne de code où + l'entrée est utilisée.} +\def\generalname{Général} +\def\SpecialMainEnvIndex#1{% + \@bsphack\special@index{% + #1\actualchar + {\string\ttfamily\space#1} + (environnement)% + \encapchar main}% + \special@index{environnements:\levelchar#1\actualchar{% + \string\ttfamily\space#1}\encapchar + main}\@esphack} +\makeatother +\newcommand{\CAD}{c.-à-d.\xspace} +\newcommand{\TO}{\textemdash\ \ignorespaces} +\newcommand{\TF}{\unskip\ \textemdash\xspace} +\newcommand\BOP{\discretionary{}{}{}} +\newcommand\Option[1]{\textsc{#1}} +\newcommand\Pkg[1]{\textsf{#1}} +\newcommand\NOUVO{% + \marginpar{\hspace*{\stretch{1}}% + \textbf{N (v4)}\hspace*{.5em}}\xspace} + +\EnableCrossrefs +\CodelineIndex + +\begin{document} + +\title{Le module \Pkg{paresse}\thanks{Ce document correspond au + fichier \Pkg{paresse}~\fileversion, du \filedate.}} +\author{Le \TeX nicien de surface\\ +\url{le.texnicien.de.surface@wanadoo.fr}} +\maketitle{} + +\begin{abstract} + Ce module, 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 |§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 § soit une lettre pour \TeX. + + Le fichier \texttt{paresse.pdf} contient le code commenté en + anglais. +\end{abstract} +\begin{otherlanguage}{english} + \begin{abstract} + This is the French documentation for the final user of the package + \Pkg{paresse}. The English documentation for the final user is + available in the file \texttt{paresse-en.pdf}. + \end{abstract} +\end{otherlanguage} + +\tableofcontents{} + +\newpage + +\section{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 + +\section{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\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: +\NOUVO\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. + +\section{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} 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}| \textbf{après} +l'extension \Pkg{inputenc} quand on utilise \hologo{LaTeX}. Il faut +que la \og caractère \fg § soit reconnu par \TeX\ comme une lettre. On +pourra, par exemple, utiliser l'option |latin1| de \Pkg{inputenc} pour +obtenir cela. + +On obtiendra le même comportement, à l'exception signalée +page~\pageref{restriction} près, avec \Pkg{inputenc} et l'option +\texttt{utf8}.\NOUVO + +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.\NOUVO + +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 à |paresse| l'option \Option{tame} avec +|\usepackage[tame]{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. + +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} + +\subsection{Les options} + +\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.sty} 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}. + +\subsection{Tableaux des macros} + +\subsubsection{Codage originel de \Pkg{paresse.sty}} + +C'est le codage actif lorsque l'on a choisit l'option \Option{legacy} qui +est l'option par défaut. + +\begin{center}\Large +\begin{ParesseActive} \label{codageorig} +\begin{tabular}{*4{||>{\ttfamily \§}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} + +\paragraph{Remarques : } à l'exception de {\ActiveLaParesse §v, §y +et §q} les lettres utilisées dans les noms des macros sont chargées +de vertu mnémotechniques \texttt{:-)} et les majuscules grecques +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 \§}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{\§v/\§t}&\CT{\§y/\§t}&\CT{\§c} +&\CT{\§q}&\CT{\§V/\§T}&\CT{\§Q}& --- \\\hline +codage de S. \textsc{Levi} +&\CT{\§j}&\CT{\§t}&\CT{\§q}&\CT{\§y} +&\CT{\§J}&\CT{\§Y} & \CT{\§c}\\\hline +\end{tabular} +\end{ParesseActive} +\end{center} + +\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} +\PrintIndex +\end{document} +\endinput +%% +%% End of file `paresse-fr.ltx'. |