summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/plain/impatient-fr/fusebook.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-05-19 00:52:39 +0000
committerKarl Berry <karl@freefriends.org>2009-05-19 00:52:39 +0000
commita00c526e00a6843ced2e5962906b9d7ec48cdec4 (patch)
treea063ae9ddd34a930d94b5e13437aff792f9d1342 /Master/texmf-dist/doc/plain/impatient-fr/fusebook.tex
parent57e2bc6866ae84cbb5c539506ea229d28e5e1eb4 (diff)
move impatient-fr out of texmf-doc
git-svn-id: svn://tug.org/texlive/trunk@13224 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/plain/impatient-fr/fusebook.tex')
-rw-r--r--Master/texmf-dist/doc/plain/impatient-fr/fusebook.tex227
1 files changed, 227 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/plain/impatient-fr/fusebook.tex b/Master/texmf-dist/doc/plain/impatient-fr/fusebook.tex
new file mode 100644
index 00000000000..2e933cf225c
--- /dev/null
+++ b/Master/texmf-dist/doc/plain/impatient-fr/fusebook.tex
@@ -0,0 +1,227 @@
+% This is part of the book TeX for the Impatient.
+% Copyright (C) 2003 Paul W. Abrahams, Kathryn A. Hargreaves, Karl Berry.
+% Copyright (C) 2004 Marc Chaudemanche pour la traduction française.
+% See file fdl.tex for copying conditions.
+
+\input fmacros
+\chapter{Utiliser ce livre}
+
+\chapterdef{usebook}
+
+Ce livre est un guide et un manuel de bricolage pour \TeX. Dans cette
+section nous vous pr\'esentons comment utiliser ce livre avec le maximum de
+b\'en\'efice.
+
+Nous vous recommandons de lire ou survoler les sections
+\chapternum{usebook} \`a \chapternum{examples}, qui vous indiquent ce que
+vous devez savoir afin de pouvoir commencer \`a utiliser \TeX. Si vous avez
+d\'ej\`a de l'exp\'erience dans l'utilisation de \TeX, il vous sera
+toujours utile de conna\^\i tre quels types d'information sont dans ces
+sections du livre. Les sections~\chapternum{concepts} -- \chapternum{tips},
+qui occupent la majeure partie du reste du livre, sont con\c cues pour
+\^etre atteintes directement. N\'eanmoins, si vous \^etes le genre de
+personne qui aime lire les manuels de r\'ef\'erence, vous constaterez qu'il
+\emph{est} possible de proc\'eder s\'equentiellement si vous \^etes pr\^et
+\`a prendre beaucoup de d\'etours au d\'ebut.
+
+Dans la \chapterref{usingtex}, ``Utiliser \TeX'', nous expliquons comment
+produire un document \TeX\ \`a partir d'un fichier source \TeX{}. Nous
+d\'ecrivons \'egalement les conventions pour pr\'eparer ce fichier source,
+expliquons un peu la fa\c con dont \TeX{} fonctionne et vous pr\'esentons
+des ressources suppl\'ementaires disponibles. La lecture de cette section
+vous aidera \`a comprendre les exemples dans la section suivante.
+
+La \chapterref{examples}, ``exemples'', contient une suite d'exemples qui
+illustrent l'utilisation de \TeX. Chaque exemple se compose d'une page de
+sortie ainsi que de la source que nous avons utilis\'ee pour la cr\'eer. Ces
+exemples vous orienteront et vous aideront \`a localiser le mat\'eriel le
+plus d\'etaill\'e dont vous aurez besoin pour faire ce que vous voulez. En
+voyant quelles commandes sont utilis\'ees dans la source, vous saurez o\`u
+rechercher des informations plus d\'etaill\'ees sur la fa\c con de
+r\'ealiser les effets montr\'es dans la sortie. Les exemples peuvent
+\'egalement servir de mod\`eles \`a des docu\-ments simples, bien que nous
+devions vous avertir que parce que nous avons essay\'e de compiler une
+vari\'et\'e de commandes \TeX\ dans un nombre de pages restreint, les
+exemples ne sont pas n\'ecessairement de bonnes ou compl\`etes
+illustrations de la cr\'eation d'imprim\'es.
+
+Quand vous lisez l'explication d'une commande, vous pouvez rencontrer
+quelques termes techniques peu familiers. Dans la \chapterref{concepts},
+``concepts'', nous d\'efinissons et expliquons ces termes. Nous discutons
+\'egalement d'autres mati\`eres dont il n'est pas fait mention ailleurs
+dans le livre. L'int\'erieur de la couverture du livre contient une
+liste de tous les concepts et les pages o\`u elles sont d\'ecrites. Nous
+vous proposons de tirer une copie de cette liste et de la maintenir pr\`es
+de vous pour que vous puissiez identifier et rechercher imm\'ediatement un
+concept peu familier.
+
+Les commandes de \TeX\ sont son vocabulaire primaire et la plus grande
+partie de ce livre est consacr\'ee \`a les expliquer. Dans les
+sections~\chapternum{paras} \`a~\chapternum{general} nous d\'ecrivons les
+commandes. Vous trouverez des informations g\'en\'erales au sujet des
+descriptions de commandes sur la \xrefpg{cmddesc}. Les descriptions de
+commande sont arrang\'ees fonctionnellement, plut\^ot comme un thesaurus,
+ainsi si vous savez ce que vous voulez faire mais ne savez pas quelle
+commande le fait pour vous, vous pouvez utiliser la table des mati\`eres
+pour vous guider vers le bon groupe de commandes. Les commandes que nous
+pensons \`a la fois particuli\`erement utiles et faciles \`a comprendre
+sont indiqu\'ees avec un doigt point\'e~(\hand).
+
+la \chapterref{capsule}, ``sommaire des commandes'', est un index
+sp\'ecialis\'e qui compl\`ete les descriptions plus compl\`etes des
+sections~\chapternum{paras} -- \chapternum{general}. Il \'enum\`ere les
+commandes de \TeX\ alphab\'etiquement, avec une br\`eve explication de
+chaque commande et une r\'ef\'erence de la page o\`u il est d\'ecrit plus
+compl\`etement. Le sommaire vous aidera quand vous ne voulez qu'un rappel
+rapide de la fonction d'une commande.
+
+\TeX\ est un programme complexe qui fonctionne parfois selon sa propre
+volont\'e de mani\`ere myst\'erieuse. Dans la \chapterref{tips}, `` trucs
+et astuces'', nous fournissons des conseils pour r\'esoudre une vari\'et\'e
+de probl\`emes sp\'ecifiques que vous pouvez rencontrer de temps en temps.
+Et si vous \^etes d\'erout\'es par les messages d'erreur de \TeX, vous
+trouverez de l'aide dans la \chapterref{errors}, ``comprendre les messages
+d'erreur''.
+
+Les \'etiquettes grises sur le c\^ot\'e du livre vous aideront \`a
+rep\'erer les parties du livre rapidement. Elles divisent le livre dans les
+parties principales suivantes~:
+\olist
+\li explications g\'en\'erales et exemples
+\li concepts
+\li descriptions de commandes (cinq \'etiquettes plus courtes)
+\li conseils, messages d'erreur et macros d'|eplain.tex|
+\li sommaire des commandes
+\li index
+\endolist
+
+Dans beaucoup d'endroits nous avons fourni des r\'ef\'erences de page de
+^{\texbook} (voir la \xrefpg{ressources} pour une citation). Ces
+r\'ef\'erences s'appliquent \`a la dix-septi\`eme \'edition de \texbook.
+Pour d'autres \'editions, quelques r\'ef\'erences peuvent \^etre
+d\'epass\'ees par une ou deux pages.
+
+\section Conventions syntaxiques
+
+Dans n'importe quel livre concernant la pr\'eparation de fichier source pour un
+ordinateur, il est n\'ecessaire d'indiquer clairement les caract\`eres litt\'eraux qui
+doivent \^etre saisis et distinguer ces caract\`eres du texte explicatif. Nous
+employons la police Computer Moderne de machine \`a \'ecrire pour les {\tt sources
+litt\'erales comme ceci} ainsi que pour les noms des commandes \TeX{}. Quand il y a
+possibilit\'e de confusion, nous enfermons le source \TeX\ entre des guillemets
+simples, `{\tt comme ceci}'. Cependant, nous utilisons de temps en temps des
+parenth\`eses quand nous indiquons des caract\`eres simples tels que (|`|) (vous
+pouvez voir pourquoi).
+
+Pour pr\'eserver vos yeux nous ne mettons normalement les espaces que l\`a o\`u vous
+devez mettre les espaces. Cependant, \`a quelques endroits o\`u nous devons
+souligner un espace, nous employons le caract\`ere `\visiblespace'
+{\catcode `\ =\other\pix^^| |}%
+pour l'indiquer. Assez naturellement, ce caract\`ere s'appelle un \emph{espace
+visible}.
+\pix^^{espace//visible}
+
+\section Descriptions des commandes
+
+\xrdef{cmddesc}
+Les sections~\chapternum{paras} -- \chapternum{general} contiennent une
+description de ce que fait presque chaque commande \TeX. ^^{commandes} Les
+commandes primitives ^^{primitive//commande} et celles de ^{\plainTeX} sont
+couvertes. Les commandes primitives sont celles construites dans le
+programme \TeX, alors que les commandes de \plainTeX{} sont d\'efinies dans
+un fichier standard de d\'efinitions auxiliaires (voir \xref\plainTeX). Les
+seules commandes que nous avons omises sont celles qui ne sont employ\'ees
+que localement dans la d\'efinition de \plainTeX\ (\knuth{annexe~B}{}). Les
+commandes sont organis\'ees comme suit~:
+\ulist\compact
+\li ``Commandes pour composer des paragraphes'', \chapterref{paras},
+traite des caract\`eres, des mots, des lignes et des paragraphes entiers.
+\li ``Commandes pour composer des pages'', \chapterref{pages},
+traite des pages, de leurs composants et de la routine de rendu.
+\li ``Commandes pour les modes horizontaux et verticaux'',
+\chapterref{hvmodes}, comprend les formes correspondantes ou identiques des
+modes hori\-zontaux (les paragraphes et les hbox) et des modes verticaux
+(les pages et les vbox). Ces commandes fournissent les bo\^\i tes, les
+espaces, les r\`egles, les leaders et les alignements.
+\li ``Commandes pour composer les formules de math\'ematiques'',
+\chapterref{math}, donne les possibilit\'es de construction de formules
+math\'ema\-tique.
+\li ``Commande pour les op\'erations g\'en\'erales'',
+\chapterref{general}, fournit les dispositifs de programmation de \TeX\ et
+tout ce qui n'entre dans aucune des autres sections.
+\endulist
+Vous devez voir ces cat\'egories comme \'etant suggestives plut\^ot que
+rigoureuses, parce que les commandes n'entrent pas vraiment de mani\`ere
+ordonn\'ee dans ces (ou tout autre) cat\'egories.
+
+Dans chaque section, les descriptions des commandes sont organis\'ees par
+fonction. Quand plusieurs commandes sont \'etroitement li\'ees, elles sont
+d\'ecrites en tant que groupe~; autrement chaque commande a sa propre
+explication. La description de chaque commande inclut un ou plusieurs
+exemples et le rendu produit par chaque exemple quand ils sont appropri\'es
+(pour quelques commandes ils ne sont pas). Quand vous regardez une sous-section
+ contenant des commandes fonctionnellement li\'ees, regardez en fin
+de sous-section l'article ``voir aussi'' pour vous assurer qu'il ne renvoit
+pas \`a des commandes li\'ees qui seraient d\'ecrites ailleurs.
+
+Quelques commandes sont \'etroitement li\'ees \`a certains concepts. Par
+exemple, les commandes |\halign| et |\valign| sont li\'ees \`a
+``alignement'', la commande |\def| est li\'ee \`a ``macro'' et les commandes
+|\hbox| et |\vbox| sont li\'ees \`a ``bo\^\i te''. Dans ce cas nous avons
+habituellement donn\'e un squelette de description des commandes elles-%
+m\^emes et avons expliqu\'e les id\'ees fondamentales dans le concept.
+
+Les exemples associ\'es aux commandes ont \'et\'e compos\'es avec une
+indentation de paragraphe ^|\parindent|, fix\'e \`a z\'ero pour que les
+paragraphes soient normalement non indent\'es. Cette convention facilite la
+lecture des exemples. Dans les exemples o\`u l'indentation de paragraphe
+est essentielle, nous l'avons explicitement plac\'ee \`a une valeur
+diff\'erente de z\'ero.
+
+Le doigt point\'e devant une commande ou un groupe de commandes indique que
+nous jugeons cette commande ou groupe de commandes particuli\`erement
+utiles et faciles \`a comprendre.
+
+Beaucoup de commandes attendent des ^{arguments} d'un type ou d'un autre
+(voir \xref{arg1}). Les arguments d'une commande fournissent \`a \TeX\ une
+information compl\'ementaire dont il a besoin afin d'ex\'ecuter la
+commande. Chaque argument est indiqu\'e par un terme entre chevrons
+imprim\'e en italique qui indique de quel genre d'argument il s'agit~:
+
+\display{%
+\halign{\<#>\quad&#\hfil\cr
+argument&un seul token ou du texte entre accolades\cr
+code de caract\`ere&un entier entre $0$ et $255$\cr
+dimension&une dimension, c'est-\`a-dire, une longueur\cr
+ressort&un ressort (avec \'etirement et r\'etr\'ecissement)\cr
+nombre&un entier \'eventuellement sign\'e (nombre entier)\cr
+registre&un num\'ero de registre entre $0$ et $255$\cr
+}}
+^^{\<dimension>}
+^^{\<argument>}
+^^{\<code de caract\`ere>}
+^^{\<ressort>}
+^^{\<nombre>}
+^^{\<registre>}
+
+\noindent
+Tous ces termes sont expliqu\'es plus en d\'etail dans la
+\chapterref{concepts}. De plus, nous utilisons parfois les termes comme
+\<liste de token> qui sont explicites ou expliqu\'es dans la description de
+la commande. Quelques commandes ont des formats sp\'eciaux qui exigent des
+accolades ou des mots particuliers. Celles-ci sont plac\'ees dans la m\^eme
+police "grasse" que celle utilis\'ee pour les titres de commande.
+
+Quelques commandes sont des param\`etres (\xref{introparms}) ou des
+entr\'ees de table.
+^^{param\`etres//comme commandes}
+Ceci est indiqu\'e dans le listing de la commande. Vous pouvez employer un
+param\`etre comme argument ou lui assigner une valeur. De m\^eme pour des
+entr\'ees de table. Nous utilisons le terme ``param\`etre'' pour faire
+r\'ef\'erence aux entit\'es telles que |\pageno| qui sont en fait des
+registres mais qui se comportent comme des param\`etres.
+^^{registres//param\`etres comme}
+
+
+\endchapter
+\byebye