summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/paresse/paresse-fr.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/paresse/paresse-fr.tex')
-rw-r--r--Master/texmf-dist/doc/latex/paresse/paresse-fr.tex331
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'.