diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/paresse/paresse-fr.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/paresse/paresse-fr.tex | 331 |
1 files changed, 331 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/paresse/paresse-fr.tex b/Master/texmf-dist/doc/latex/paresse/paresse-fr.tex new file mode 100644 index 00000000000..d8e8164363e --- /dev/null +++ b/Master/texmf-dist/doc/latex/paresse/paresse-fr.tex @@ -0,0 +1,331 @@ +%% +%% This is file `paresse-fr.tex', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% paresse.dtx (with options: `doc,fr') +%% This is a generated file. +%% +%% Copyright (C) 2003-2010 Y. Henel, 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. +\def\fileversion{v3} +\def\filedate{2010/03/21} +\documentclass[a4paper]{ltxdoc} +\usepackage[latin1]{inputenc} +\usepackage[T1]{fontenc} +\usepackage[tame]{paresse} +\usepackage{xspace,url,array,ifthen} +\IfFileExists{lmodern.sty}{\usepackage{lmodern}}{} +\usepackage[english,frenchb]{babel} +\usepackage[colorlinks=true, + linkcolor=blue, + urlcolor=blue, + citecolor=blue]{hyperref} +\makeatletter +\newcommand\DescribeOption[1]{\@bsphack \marginpar{\raggedleft + \textsc{#1}}\index{#1 (option)}\@esphack} +\GlossaryPrologue{% + \section*{{Changements}} + \markboth{{Changements}}{{Changements}}} +\IndexPrologue{% + \section*{Index}\markboth{Index}{Index}% + Les nombres en italique renvoient ^^e0 la page o^^f9 l'entr^^e9e est d^^e9crite; + les nombres soulign^^e9s renvoient ^^e0 la ligne de code de la d^^e9finition; + les nombres en caract^^e8res romains renvoient ^^e0 la ligne de code o^^f9 + l'entr^^e9e est utilis^^e9e.} +\def\generalname{G^^e9n^^e9ral} +\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{\TO}{\textemdash\ \ignorespaces} +\newcommand{\TF}{\unskip\ \textemdash\xspace} +\newcommand{\CAD}{c.-^^e0-d.\xspace} +\newcommand\BOP{\discretionary{}{}{}} +\newcommand\Option[1]{\textsc{#1}} +\newcommand\MODULE[1]{\textsf{#1}} +\newcommand\NOUVO{% + \marginpar{\hspace*{\stretch{1}}% + \textbf{N (v3)}\hspace*{.5em}}\xspace} + +\begin{document} +\GetFileInfo{paresse.sty} % marche p^^f4! :( + +\title{Le module \MODULE{paresse}\thanks{Ce document correspond au + fichier \MODULE{\filename}~\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^^e9es ^^e0 l'aide du caract^^e8re actif et red^^e9fini. Au lieu de + |\(\alpha\)| ou tape |^^a7a| pour obtenir \(\alpha\). + + \textbf{Important} : Il doit ^^eatre charg^^e9 \textbf{apr^^e8s} + \MODULE{inputenc} si ce dernier est utilis^^e9. De plus, il faut que le + signe ^^a7 soit une lettre pour \TeX. + + Le fichier \texttt{paresse.pdf} contient le code comment^^e9 en + fran^^e7ais. +\end{abstract} +\begin{otherlanguage}{english} + \begin{abstract} + This is the French documentation for the final user of the package + \MODULE{paresse}. The English documentation for the final user is + available in the file \texttt{paresse-en.pdf}. + + The code is not commented in English any more. Sorry. See the + French documentation for French commented code in + \texttt{paresse.pdf}. + \end{abstract} +\end{otherlanguage} + +\tableofcontents{} + +\newpage + +\section{Introduction} + +Cette extension ne fournit qu'un acc^^e8s \og rapide et ^^e9conomique \fg +aux lettres grecques qui s'obtiennent ^^e0 l'aide d'une macro comme +\cs{alpha} ou \cs{Omega}. Elle fournit un environnement et une commande +qui permettent d'utiliser ^^a7 pour taper ces lettres. Un \cs{ensuremath} +nous dispense de nous placer explicitement \TO c'est-^^e0-dire en +tapant |$ $| ou bien |\( \)| ou encore |\[ \]| ou tout autre chose +ayant le m^^eame effet\TF en mode math^^e9matique pour obtenir une lettre +grecque. + +L'id^^e9e de la m^^e9thode est due ^^e0 T.~\textsc{Lachand-Robert} et est +expos^^e9e dans~\cite{tlachand}. Je n'ai fait qu'ajouter le +\cs{ensuremath} bien agr^^e9able pour l'^^e9criture 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 ^^e0 l'aide des latines romaines de m^^eame +apparence\footnote{Je ne ferai aucune remarque sur les probl^^e8mes 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 ^^a7 indique un \og +paragraphe \fg en ayant une forme lointainement apparent^^e9e au +S et n'a donc aucun lien avec le \emph{d^^e9faut} si fr^^e9quent, +encore que, ^^e0 bien y r^^e9fl^^e9chir\dots + +\section{Pourquoi une 3\ieme version?} + +C'est par un courriel du 3~mars 2003 que Claudio \textsc{Beccari} me +signalait tr^^e8s aimablement qu'il existait un codage de l'alphabet +grec en lettres latines pr^^e8s de 15~ans avant que je ne commette +cette extension. Ce codage ^^e9tait d^^fb ^^e0 Sylvio \textsc{Levi} qui +l'avait mis au point, alors qu'il dessinait les premi^^e8res fontes +grecques pour \TeX, en s'appuyant sur la correspondance entre les +claviers am^^e9ricain et grec. Il me faisait remarquer ^^e0 juste titre +que si quelqu'un avait pris l'habitude du codage de Sylvio +\textsc{Levi}, il pr^^e9f^^e9rerait conserver ses habitudes pour +\MODULE{paresse}. + +J'ai donc d^^e9cid^^e9 de fournir un nouveau couple d'options exclusives +l'une de l'autre que j'ai nomm^^e9es, pour l'une, \Option{legacy} --- +pour \og h^^e9ritage\fg --- qui assure le codage originel de cette +extension et qui est active par d^^e9faut et, pour l'autre, \Option{Levi} +qui assure le codage de Sylvio \textsc{Levi}. + +J'en profite pour faire quelques changements cosm^^e9tiques: +d^^e9sormais toutes les macros internes \emph{secr^^e8tes} ont un nom qui +commence par \cs{GA@}; +le fichier |.dtx| est r^^e9organis^^e9 pour faciliter la tache de +traduction de la documentation. + +\section{Utilisation} + +On charge cette extension avec |\usepackage{paresse}| \textbf{apr^^e8s} +l'extension |inputenc|. Il faut que la \og caract^^e8re \fg ^^a7 soit +reconnu par \TeX\ comme une lettre. On pourra, par exemple, utiliser +l'option |latin1| de |inputenc| pour obtenir cela. + +Par d^^e9faut, l'extension est charg^^e9e avec l'option |wild| ce qui +signifie que les macros de la forme |^^a7a| sont disponibles. Si l'on +pr^^e9f^^e8re, on peut passer ^^e0 |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 ^^a7. + +Lorsque la \og paresse est active \fg, il suffit de taper |^^a7a| pour +obtenir \(\alpha\). On a de m^^eame acc^^e8s ^^e0 toutes les lettres grecques +auxquelles sont consacr^^e9es une macro comme \cs{alpha}, +voyez~\ref{codageorig} et~\ref{codagelevi}. On obtient, de m^^eame, +\(\alpha^{\beta}\) avec |\(^^a7a^{^^a7b}\)| lorsque ^^a7 est active. On notera +que, si l'extension |amsmath| est utilis^^e9e, les accolades sont +optionelles et qu'on obtient un r^^e9sultat identique avec |\(^^a7a^^^a7b\)|. + +\subsection{Les options} + +\begin{itemize} +\item \Option{tame}\DescribeOption{tame / wild} s'oppose ^^e0 + \Option{wild} qui est l'option par d^^e9faut. Lorsque \Option{tame} + r^^e8gne, il \textbf{faut} un environnement |ParesseActive| ou une + commande \cs{ActiveLaParesse} pour utiliser les macros ^^e0 ^^a7. + +\item \Option{Levi}\NOUVO\DescribeOption{legacy / Levi} s'oppose ^^e0 + \Option{legacy} qui est l'option par d^^e9faut. Avec l'option + \Option{legacy} on utilise le codage \og originel\fg de + \MODULE{paresse.sty} tel que le donne la + table~\ref{codageorig}. Sinon, le codage est celui d^^e9fini par Sylvio + \textsc{Levi}, cf. la table~\ref{codagelevi}. + +\item \Option{ttau}\DescribeOption{ttau / ttheta} s'oppose ^^e0 + \Option{ttheta} qui est l'option par d^^e9faut. Lorsque \Option{ttheta} + est active |^^a7t| donne \(\theta\) dans le cas contraire |^^a7t| donne + \(\tau\). En tous cas, \(\theta\) est accessible par |^^a7v| et + \(\tau\) par |^^a7y|. \NOUVO Cette option est inop^^e9rante si l'option + \Option{Levi} a ^^e9t^^e9 choisie. + + \textbf{Remarque :} \NOUVO quand l'option \Option{legacy} a ^^e9t^^e9 choisie, + \(\Theta\) est obtenu par |^^a7V| de mani^^e8re \og r^^e9guli^^e8re \fg et + \emph{^^e9galement} par |^^a7T| quelle que soit l'option choisie. Dans + le cas de l'option \Option{Levi}, |^^a7V| ne correspond ^^e0 aucune lettre + grecque. + +\item \Option{epsilon}\DescribeOption{epsilon / varepsilon} s'oppose ^^e0 + \Option{varepsilon} qui est l'option par d^^e9faut. Avec + \Option{epsilon}, |^^a7e| donne \(\epsilon\) sinon |^^a7e| 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 |^^a7s| donne + \(\varsigma\)\fg; \Option{phi} et \Option{varphi}. +\end{itemize} + +Par d^^e9faut on a \Option{varepsilon}, \Option{theta}, \Option{pi}, +\Option{rho}, \Option{sigma}, \Option{varphi}, \Option{wild} et +\Option{legacy}\NOUVO. Cela assure que cette version~3, se comporte, +par d^^e9faut, comme la pr^^e9c^^e9dente. + +\subsection{Commandes et environnement} + +\DescribeMacro{\makeparesseletter} +Cette macro donne au \og caract^^e8re \fg ^^a7 le catcode d'une +lettre. Apr^^e8s cela, on peut se servir de ^^a7 dans un nom de macro, par +exemple. C'est le pendant de \cs{makeatletter}. + +\DescribeMacro{\makeparesseother} +Cette macro donne au caract^^e8re ^^a7 le catcode \emph{other}. C'est le \og +contraire \fg de la pr^^e9c^^e9dente. Cela ^^e9quivaut au \cs{makeatother}. + +\DescribeMacro{\ActiveLaParesse} +Cette macro active le caract^^e8re ^^a7 et permet ainsi d'acc^^e9der aux +macros dont le nom commence par ^^a7 comme |^^a7a|. Pour une liste de ces +macros et leurs significations, voyez les tableaux~\ref{codageorig} +et~\ref{codagelevi}. + +\DescribeEnv{ParesseActive} +Dans cet environnement le caract^^e8re ^^a7 est actif ce qui permet +d'utiliser les macros en ^^a7. On utilisera cet environnement si l'on +veut utiliser les macros quand on a charg^^e9 l'extension +\MODULE{paresse} avec l'option \texttt{tame}. + +\subsection{Tableaux des macros} + +\subsubsection{Codage originel de \MODULE{paresse.sty}} + +C'est le codage actif lorsque l'on a choisit l'option \Option{legacy} qui +est l'option par d^^e9faut. + +\begin{center}\Large +\begin{ParesseActive} \label{codageorig} +\begin{tabular}{*4{||>{\ttfamily \^^a7}c|c}||}\hline +a & ^^a7a & b & ^^a7b & g & ^^a7g & d & ^^a7d\\ \hline +e & ^^a7e & z & ^^a7z & h & ^^a7h & v & ^^a7v\\ \hline +i & ^^a7i & k & ^^a7k & l & ^^a7l & m & ^^a7m\\ \hline +n & ^^a7n & x & ^^a7x & p & ^^a7p & r & ^^a7r\\ \hline +s & ^^a7s & y & ^^a7y & u & ^^a7u & f & ^^a7f\\ \hline +c & ^^a7c & q & ^^a7q & w & ^^a7w &\multicolumn{1}{c|}{}&\\ \hline\hline +G & ^^a7G & D & ^^a7D & V & ^^a7V & L & ^^a7L\\ \hline +X & ^^a7X & P & ^^a7P & S & ^^a7S & U & ^^a7U\\ \hline +F & ^^a7F & Q & ^^a7Q & W & ^^a7W &\multicolumn{1}{c|}{}&\\ \hline +\end{tabular} +\end{ParesseActive} +\end{center} + +\paragraph{Remarques : } ^^e0 l'exception de {\ActiveLaParesse ^^a7v, ^^a7y +et ^^a7q} les lettres utilis^^e9es dans les noms des macros sont charg^^e9es +de vertu mn^^e9motechniques \texttt{:-)} et les majuscules grecques +s'obtiennent ^^e0 l'aide de la majuscule correspondante. + +\subsubsection{Codage de Sylvio \textsc{Levi}} + +On active ce codage avec l'option \Option{Levi}. + +\begin{center}\Large\NOUVO +\begin{ParesseActive} \label{codagelevi} +\begin{tabular}{*4{||>{\ttfamily \^^a7}c|c}||}\hline +a & ^^a7a & b & ^^a7b & g & ^^a7g & d & ^^a7d\\ \hline +e & ^^a7e & z & ^^a7z & h & ^^a7h & j & ^^a7v\\ \hline +i & ^^a7i & k & ^^a7k & l & ^^a7l & m & ^^a7m\\ \hline +n & ^^a7n & x & ^^a7x & p & ^^a7p & r & ^^a7r\\ \hline +s & ^^a7s & t & ^^a7y & u & ^^a7u & f & ^^a7f\\ \hline +q & ^^a7c & y & ^^a7q & w & ^^a7w & c & \(\varsigma\)\\ \hline\hline +G & ^^a7G & D & ^^a7D & J & ^^a7V & L & ^^a7L\\ \hline +X & ^^a7X & P & ^^a7P & S & ^^a7S & U & ^^a7U\\ \hline +F & ^^a7F & Y & ^^a7Q & W & ^^a7W &\multicolumn{1}{c|}{}&\\ \hline +\end{tabular} +\end{ParesseActive} +\end{center} + +Le codage de Sylvio \textsc{Levi} donne acc^^e8s directement ^^e0 \cs{varsigma} +(\(\varsigma\)) avec |^^a7c| et ne diff^^e8re du codage originel que pour +les lettres {\ActiveLaParesse ^^a7v, ^^a7y, ^^a7c et ^^a7q}. Voici un r^^e9sum^^e9 de +ces diff^^e9rences: + +\begin{center} +\newcommand\CT[1]{\multicolumn{1}{c|}{\texttt{#1}}} +\begin{ParesseActive} +\begin{tabular}{|l|*{7}{c|}}\hline +lettres grecques +& ^^a7v & ^^a7y & ^^a7c & ^^a7q & ^^a7V & ^^a7Q & \(\varsigma\)\\\hline +codage originel +&\CT{\^^a7v/\^^a7t}&\CT{\^^a7y/\^^a7t}&\CT{\^^a7c} +&\CT{\^^a7q}&\CT{\^^a7V/\^^a7T}&\CT{\^^a7Q}& --- \\\hline +codage de S. \textsc{Levi} +&\CT{\^^a7j}&\CT{\^^a7t}&\CT{\^^a7q}&\CT{\^^a7y} +&\CT{\^^a7J}&\CT{\^^a7Y} & \CT{\^^a7c}\\\hline +\end{tabular} +\end{ParesseActive} +\end{center} + +\begin{thebibliography}{99} +\addcontentsline{toc}{section}{Bibliographie} +\bibitem{tlachand} T.~\textsc{Lachand-Robert}. +\emph{La ma^^eetrise de \TeX{} et \LaTeX{}}. +Masson, Paris, Milan, Barcelone, \oldstylenums{1995}.\\ +\textsc{isbn} : \texttt{2-225-84832-7}. +\end{thebibliography} + +\end{document} +\endinput +%% +%% End of file `paresse-fr.tex'. |