%% %% 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 %% %% %% 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'.