1 .\" -*- mode: nroff; coding: utf-8; -*-
3 .\" Copyright (c) 1986 The Regents of the University of California.
4 .\" All rights reserved.
6 .\" Redistribution and use in source and binary forms are permitted
7 .\" provided that the above copyright notice and this paragraph are
8 .\" duplicated in all such forms and that any documentation,
9 .\" advertising materials, and other materials related to such
10 .\" distribution and use acknowledge that the software was developed
11 .\" by the University of California, Berkeley. The name of the
12 .\" University may not be used to endorse or promote products derived
13 .\" from this software without specific prior written permission.
14 .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
15 .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
16 .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
18 .\" @(#)intro.me 6.4 (Berkeley) 7/17/89
20 .\" Modified for groff by jjc@jclark.com.
22 .\" Translated to French by Grégoire Babey <gibux@gmx.ch>
28 .he 'GROFF EN OPTION \-ME''%'
29 .\"eh 'USD:22-%''Writing Papers with NROFF using \-me'
30 .\"oh 'Writing Papers with NROFF using \-me''USD:22-%'
38 .b "Rédiger des documents avec GROFF \-me"
45 Electronics Research Laboratory
46 University of California, Berkeley
47 Berkeley, California 94720
49 .i "Modifié pour \*G by James Clark"
51 .i "Adapté au français par Grégoire Babey"
55 Ce document décrit les outils de traitement de texte
56 sur un système \*U\(lz
58 \(lz\*U est une marque déposée de AT&T Bell Laboratories
64 Il présuppose que le lecteur
65 est déjà familiarisé avec les systèmes \*U
66 et un éditeur de texte
70 Son intention est d'être une introduction
71 simple et concrète, et par conséquent,
72 il ne traitera pas toute la matière disponible.
74 de nombreuses variantes et fonctionnalités supplémentaires
75 du paquet de macros \-me ne seront pas décrites.
76 Pour une discussion plus complète de telle ou telle fonctionnalité, voyez
78 The \-me Reference Manual
81 The \*N/\*T Reference Manual.
84 fonctionnant sur le système d'exploitation \*U.
85 Il lit un fichier d'entrée
86 préparé par l'utilisateur
87 et sort un texte formaté,
88 prêt à être publié ou mis en page.
89 Le fichier d'entrée est formé de
91 les mots destinés à être imprimés,
94 qui donnent des instructions au programme \*G
95 et lui indiquent quelle forme donner à la copie imprimée.
98 Chapitre 1: décrit les éléments de base du traitement de texte.
100 Chapitre 2: décrit les requêtes de base.
102 Chapitre 3: introduit les mises en évidence: citations, tableaux, figures.
104 Chapitre 4: annotations (notes en bas de page, texte différé, index).
106 Chapitre 5: requêtes plus complexes, n'ayant pu être traitées au chapitre 2.
108 Chapitre 6: les choses que vous devez savoir pour pouvoir rédiger des documents.
111 Si vous êtes novice, vous ne voudrez sans doute pas attendre d'avoir lu jusqu'au chapitre 4 pour tester par vous mêmes les fonctions de base du programme.
112 Quand votre texte sera prêt à être traité,
113 appelez le formateur \*G en tapant
114 cette commande dans votre shell \*U (ou terminal):
116 groff \-me \-k \ foo > \ foo.ps
118 L'option -k tient compte des caractères accentués propres au français.
120 Remplacez foo par le nom de votre fichier qui devra être en un mot.
122 Le fichier devra être placé dans votre répertoire personnel, sinon remplacez foo par le chemin du fichier.
124 À la place de .ps, vous pouvez mettre .pdf ou le format que vous désirez obtenir.
126 Vous trouverez un description plus complète des options pour la commande \*G en tapant
128 dans votre terminal ou console.
132 est utilisé dans ce manuel
133 pour décrire un mot ou un nombre
134 qui apparait sur la même ligne qu'une requête
135 en modifiant le sens de cette requête.
141 met un espace après une ligne,
146 met 4 espaces après une ligne.
153 qui lui dit d'espacer de quatre lignes
155 Les arguments sont séparés de la requête et des autres arguments
157 .sh 1 "Éléments de base du traitement de texte"
163 des mots sur les lignes du fichier d'entrée, de
165 de ces mots les lignes du ficher de sortie, de
167 le texte sur la marge de droite
168 en insérant des espaces supplémentaires entre les mots,
169 et de rendre le fichier de sortie.
173 Maintenant il est temps
174 pour tous les hommes bons
177 Il y a quatre-vingt-sept ans...
180 rendu dans des lignes de sortie,
184 Maintenant il est temps
185 pour tous les hommes bons
188 Il y a quatre-vingt-sept ans...
190 Parfois, vous désirerez commencer une nouvelle ligne, même si la ligne actuelle n'est pas encore pleine;
192 à la fin d'un paragraphe.
194 vous pouvez provoquer une
196 une ligne d'entrée vide, ou une nouvelle ligne commençant par un espacement
197 provoquent le début d'une nouvelle ligne.
198 Certaines requêtes provoquent automatiquement une interruption.
200 Les lignes d'entrée ne sont pas toutes destinées à être formatées (voir plus bas).
201 Certaines lignes sont des
204 comment le texte doit être formaté.
205 Les requêtes commencent toujours par un point ou une apostrophe
209 Le formateur de texte effectue aussi des tâches plus complexes,
210 comme la numérotation automatique des pages,
211 le saut de page automatique,
212 le placement des notes en bas de page au bon endroit,
215 Je peux vous donner quelques conseils
216 comment préparer votre texte d'entrée pour \*G.
218 écrivez des lignes d'entrée courtes.
219 Des lignes d'entrée courtes seront plus faciles à modifier,
220 et de toutes façons, \*G les saisira pour vous en lignes plus longues.
221 En accord avec cette idée,
222 il est pratique de commencer une
224 chaque virgule ou point,
225 puisque habituellement les corrections consistent à
226 modifier ou supprimer des propositions ou des phrases.
228 n'ajoutez pas d'espacements à la fin des lignes,
229 ceci pourrait en certains cas induire en erreur le processeur \*N.
231 ne séparez pas vous-même les mots en fin de ligne avec des traits d'union
232 (excepté les mots qui en contiennent naturellement,
235 \*G est assez futé pour séparer pour vous les mots qui doivent l'être,
236 mais il ne l'est pas assez pour réunir les syllabes
237 que vous auriez séparées vous-même.
241 ne devraient pas être écrit sur deux lignes,
242 sinon vous obtiendrez un espacement là ou vous n'en vouliez pas,
243 comme ici par exemple:
250 .sh 1 "Requêtes de base"
253 On commence un nouveau paragraphe
254 en utilisant la requête
260 Maintenant il est temps pour tous les hommes bons
261 de venir en aide à leur parti.
262 Il y a quatre-vingt-sept ans...
264 donne un ligne d'espacement, suivie d'une ligne indentée.
268 Maintenant il est temps pour tous les hommes bons
269 de venir en aide à leur parti.
270 Il y a quatre-vingt-sept ans...
273 Notez que les phrases d'un paragraphes ne
275 commencer par un espacement,
276 puisque une ligne d'espacement ou un espace en début de ligne
277 provoque une interruption.
282 Maintenant il est temps pour tous les hommes bons
283 de venir en aide à leur parti.
284 Il y a quatre-vingt-sept ans...
289 Maintenant il est temps pour tous les hommes bons
290 de venir en aide à leur parti.
291 Il y a quatre-vingt-sept ans...
293 Une nouvelle ligne commence après le mot
295 parce que la deuxième ligne d'entrée a été commencée avec un espacement.
297 Il existe beaucoup de types de paragraphes plus élaborés,
298 qui seront décrits plus tard.
299 .sh 2 "En-têtes et pied de page "
301 On peut ajouter si on veut des en-têtes et des pieds de page.
309 définissent les titres à mettre respectivement en haut et en pied de page.
310 Ces titres sont appelés titres
311 .i "en trois parties"
313 une première partie est justifiée sur la gauche, la deuxième est centrée, la troisième justifiée sur la droite. Les trois parties sont séparées par des apostrophes.
314 Le signe %, si il est présent dans le titre, sera automatiquement remplacé par le numéro de page courant.
315 Par exemple l'entrée:
317 \&.he \(aa\(aa%\(aa\(aa
319 donnera le numéro de page courant centré sur chaque page.
321 \&.he \(aa\(aa\(aa%\(aa
323 donnera le numéro de page jusifié à droite sur chaque page.
325 \&.he \(aaGroff -me\(aaTraduction\(aa%\(aa
327 donnera à gauche "Groff -me", au centre "Traduction" et à droite le numéro de page courant.
329 Les éléments de l'en-tête peuvent débuter par n'importe quelle lettre, mais antislash et guillemets sont à éviter.
332 fonctionne de manière analogue.
333 .sh 2 "Double espacement"
336 \*G insère un double espacement vertical dans le texe de sortie
337 si vous utilisez la requête
339 comme cela a été fait ici.
340 Vous pouvez retourner à l'espacement vertical simple en tapant
343 .sh 2 "Layout de la page"
345 Un certain nombre de requêtes vous permettent de modifier la présentation de la copie imprimée, ce qu'on appelle le
347 de la page de sortie.
348 La plupart de ces requêtes ajustent dans le texte des
350 (espacement, espacement vertical).
351 Dans les explications qui suivent, les caractères en italique
352 doivent être remplacés par les valeurs que vous souhaitez;
354 devront être tapés tels quels.
358 commence une nouvelle page.
365 lignes d'espacement vertical.
368 (dans ce cas, il n'y aura qu'une ligne d'espacement),
369 ou peut prendre la forme
381 Par exemple, l'entrée:
384 Mes pensées sur le sujet
387 laissera trois centimètres et demi d'espace sur la gauche,
389 .q "Mes pensées sur le sujet" ,
390 suivie elle-même d'un espacement vertical.
395 change le nombre d'espacements sur la gauche de la page
405 espacements de plus que ce qu'il y avait avant),
410 espacements de moins que ce qu'il y avait avant),
413 (ce qui veut dire exactement
417 peut aussi avoir la forme
438 indenté à 5 espacements
439 de la marge de gauche,
440 .q "encore plus d texte"
441 indenté à 5 espacements
443 de la marge de gauche
444 (15 espacements sur une machine à écrire à picas),
449 moins deux centimètres
450 de la marge de gauche.
451 C'est à dire la sortie suivante:
465 (indentation temporaire)
466 est utilisée de la même manière que
469 quand l'indentation ne concerne qu'une seule ligne,
470 après quoi on retourne à l'indentation initiale.
476 Ware, James R. The Best of Confucius,
479 qui présente en traduction (anglaise)
480 les phrases les plus délicieuses de Confucius.
481 Décidément un passage obligé
482 pour tous ceux qui s'intéressent
483 au fondements primitifs de la philosophie chinoise.
489 Ware, James R. The Best of Confucius,
491 Un livre excellent, qui présente
492 en traduction (anglaise) les phrases les plus délicieuses de Confucius.
493 Décidément un passage obligé pour tous ceux qui s'intéressent au fondements primitifs de la philosophie chinoise.
495 Les lignes de texte peuvent être centrées en utilisant la requête
499 est centrée (horizontalement)
501 Pour centrer plus qu'une ligne,
507 est le nombre de lignes à centrer),
511 Si vous voulez centrer plusieurs lignes, mais vous vous refusez à les compter,
520 dit à \*G de ne centrer plus que 0 lignes,
522 d'arrêter de centrer.
524 Toutes ces requêtes provoquent une interruption;
525 c'est à dire qu'elles commencent toutes une nouvelle ligne.
526 Si vous voulez commencer une nouvelle ligne sans rien faire d'autre,
529 .sh 1 "Mises en évidences"
531 Les mises en évidences sont des passages de textes sortis du corps de texte.
535 sont des types de mise en évidence,
536 comme le sont tous les exemples
537 exposés dans ce document.
538 Toutes les mises en évidence,
539 exceptés les blocs centrés,
540 sont précédés et suivis en sortie d'un seul espacement vertical.
541 .sh 2 "Citations longues"
543 Les citations longues
544 sont des citations qui s'étalent sur plusieurs lignes,
545 elles sont donc sorties du corps de texte
546 et ne sont pas entourées de guillemets.
547 Cela peut être réalisé
548 en utilisant les commandes
552 entourant la citation.
556 Comme l'indique Weizenbaum:
558 On dit qu'expliquer, c'est expliquer en s'éloignant.
559 Cette maxime ne s'accomplit nulle part aussi bien
560 que dans le domaine de la programmation informatique,...
565 Comme l'indique Weizenbaum:
567 On dit qu'expliquer, c'est expliquer en s'éloignant.
568 Cette maxime ne s'accomplit nulle part aussi bien
569 que dans le domaine de la programmation informatique,...
575 est une mise en évidence
577 à espacements simples,
579 On devrait utiliser une liste
580 quand le matériel à imprimer
581 ne doit pas être justifié comme un texte normal,
582 tels les colonnes de figures
583 ou les exemples utilisés dans ce document.
584 Les listes sont encadrées par les requêtes
591 La famille des Équidés comprend:
601 La famille des Équidés comprend:
612 est un ensemble de lignes mises en évidences
613 que l'on désire garder sur la même page
615 Par exemple un diagramme.
616 Les clos diffèrent des listes.
617 Les listes peuvent être réparties sur plusieurs pages,
618 tandis que les clos ne peuvent pas l'être.
620 Les blocs sont un genre primitif de clos.
621 Ils débutent avec la requête
623 et se terminent avec la requête
625 Si il n'y a pas de place sur la page courante
626 pour y placer le bloc entier,
627 il sera placé sur une nouvelle page.
628 Cela a pour effet déplaisant de laisser
629 un espace blanc en fin de page.
630 Quand cela n'est pas approprié,
631 vous pouvez user d'une alternative
633 .i "clos flottants" .
637 se déplacent dans le texte.
639 il sont appropriés pour les choses
640 auxquelles on se réfère nommément, comme
642 Un clos flottant apparaîtra
643 au bas de la page courante
647 sur la page suivante.
648 Les clos flottants commencent par
652 Comme exemple de clos flottant,
660 Texte du clos flottant
663 Figure 1. Exemple de clos flottant.
668 Figure 1. Exemple de clos flottant.
674 pour dessiner une ligne horizontale
675 de sorte que la figure
676 soit séparée du texte.
678 .sh 2 "Mises en évidences plus élaborées"
680 Les clos et les listes sont normalement collectés en mode
682 Ils sont donc propres à contenir des tableaux et autres.
683 Si vous voulez obtenir une mise en évidence
688 [Tout au long de ce chapitre,
689 les remarques s'appliquant à
695 Cette espèce de mise en évidence
696 sera indentée des deux côtés.
701 Et maintenant les garçons et les filles,
702 un jouet plus grand, plus beau que tout ce qui a existé auparavant!
703 Soyez le premier, la première de votre quartier
704 à posséder votre propre ordinateur!
705 Oui les enfants, vous aussi vous pouvez posséder
706 une de ces machines à gérer les informations.
707 Vous aussi vous pouvez produire de beaux papiers formatés
708 sans même remuer le petit doigt!
713 Et maintenant les garçons et les filles,
714 un jouet plus grand, plus beau que tout ce qui a existé auparavant!
715 Soyez le premier, la première de votre quartier
716 à posséder votre propre ordinateur!
717 Oui les enfants, vous aussi vous pouvez posséder
718 une de ces machines à gérer les informations.
719 Vous aussi vous pouvez produire de beaux papiers formatés
720 sans même remuer le petit doigt!
724 pour obtenir une liste justifiée,
725 alignée sur la gauche, entrez:
728 Et maintenant les garçons et les filles,
729 un jouet plus grand, plus beau que tout ce qui a existé auparavant!
730 Soyez le premier, la première de votre quartier
731 à posséder votre propre ordinateur!
732 Oui les enfants, vous aussi vous pouvez posséder
733 une de ces machines à gérer les informations.
734 Vous aussi vous pouvez produire de beaux papiers formatés
735 sans même remuer le petit doigt!
740 Et maintenant les garçons et les filles,
741 un jouet plus grand, plus beau que tout ce qui a existé avant!
742 Soyez le premier, la première de votre quartier
743 à posséder votre propre ordinateur!
744 Oui les enfants, vous aussi vous pouvez posséder
745 une de ces machines à gérer les informations.
746 Vous aussi vous pouvez produire de beaux papiers formatés
747 sans même remuer le petit doigt!
750 Normalement, les listes et les blocs sont indentés
751 (les clos flottant sont normalement alignés sur la gauche).
752 Pour obtenir une liste
753 alignée sur la gauche,
756 Pour obtenir une ligne centrée
763 première ligne d'une mise en évidence non-justifiée
767 produit un texte indenté:
769 première ligne d'une mise en évidence non-justifiée
776 cela produira le même résultat, mais aligné à gauche:
778 première ligne d'une mise en évidence non-justifiée
785 vous obtenez une liste centrée:
787 première ligne d'une mise en évidence non-justifiée
793 plusieurs lignes en groupe
794 plutôt que de centrer ligne par ligne.
796 utilisez les blocs centrés
797 qui sont produits par les requêtes
801 Toutes les lignes sont centrées en tant que groupe.
802 La ligne la plus longue est centrée par rapport aux marges
803 et les lignes plus courtes sont alignées sur la plus longue.
804 Notez que si vous utilisez un bloc centré,
805 les lignes ne bougent pas les unes par rapport aux autres,
806 tandis qu'elles le feront si vous utilisez l'argument
810 Les blocs centrés ne sont
813 et peuvent même être combinés
814 avec eux comme nous allons le voir.
816 pour centrer des lignes
824 première ligne d'une mise en évidence non-justifiée
832 première ligne d'une mise en évidence non-justifiée
841 le résultat aurait été le même,
843 que les lignes du bloc centré
844 aient été sur la même page.
845 Notez l'usage de l'argument
850 que le bloc se centre
851 sur toute la longueur de la ligne
852 plutôt que sur la longueur de ligne raccourcie de l'indentation.
854 la requête demandant de centrer
857 de la requête formant le clos.
860 Un certain nombre de requêtes
861 servent à mettre du texte de côté
862 pour l'imprimer plus tard, comme les
863 .i "notes en bas de page"
864 qui sont imprimées au bas de la page courante.
868 est en quelque sorte une variante de la
870 le texte n'est imprimé
871 qu'au moment où on fait appel à lui,
872 par exemple à la fin de chaque chapitre.
876 sont un genre de texte différé
877 ayant un numéro de rappel
878 (habituellement le numéro de la page)
879 attaché à chaque entrée
880 après une rangée de points.
881 Les Index sont aussi mis de côté
882 jusqu'à ce qu'on fasse explicitement appel à eux.
883 .sh 2 "Notes en bas de page"
885 Une note en bas de page commence avec la requête
887 et se termine avec la requête
889 La note en bas de page courante
890 est maintenue automatiquement,
891 et peut être utilisée en tapant \e**,
892 ce qui produira un numéro de note\**.
896 Le numéro est automatiquement incrémenté
897 après chaque note en bas de page.
902 Un homme qui n'est pas honnête
903 et qui, en même temps, est présomptueux;
904 un homme qui n'est pas attentif
905 et qui, en même temps, est ignorant;
906 un homme qui est rempli de mensonge
907 et qui, en même temps, est incompétent;
908 un tel homme ne fait pas partie de mes relations.\e**
910 \e**Traduit de :James R. Ware,
912 The Best of Confucius,
918 génère le résultat suivant:
920 Un homme qui n'est pas honnête
921 et qui, en même temps, est présomptueux;
922 un homme qui n'est pas attentif
923 et qui, en même temps, est ignorant;
924 un homme qui est rempli de mensonge
925 et qui, en même temps, est incompétent;
926 un tel homme ne fait pas partie de mes relations.\**
928 \**Traduit de: James R. Ware,
930 The Best of Confucius,
935 Il est important que la note en bas de page
944 .sh 2 "Texte différé"
947 ressemble beaucoup à la note en bas de page
948 sauf qu'il est imprimé seulement
949 si on fait explicitement appel à lui.
950 Cela permet de faire apparaître par exemple
951 une liste de références
952 à la fin de chaque chapitre,
953 ce qui est une convention dans certaines disciplines.
956 pour le texte différé
959 des notes en bas de page.
961 Si vous faites du texte différé
962 votre moyen habituel de noter les références,
963 vous pourrez toujours utiliser en parallèle
964 les notes en bas de page,
965 mais, comme référence,
966 vous utiliserez alors des signes spéciaux*
968 *comme un astérisque (!)
970 plutôt que des numéros.
972 Pour faire apparaître une note en bas de page munie d'un signe spécial comme celle que vous admirez ci- dessus, entrez:
974 \&...vous utiliserez alors des signes spéciaux*.
980 *comme un astérisque (!).
988 (ou plutôt table des matières
989 puisque les éléments ne sont pas classés
990 par ordre alphabétique)
991 ressemble au texte différé,
992 par le fait qu'il est gardé en réserve
993 jusqu'à ce qu'on fasse appel à lui.
995 chaque élément de l'index
997 (ou un autre signe distinctif)
998 à la fin de la dernière ligne le décrivant,
999 à la suite d'une rangée de points (voir ci-dessous).
1001 Les entrées pour l'index
1006 Dans chaque chapitre
1007 dont vous voulez qu'il apparaisse dans l'index,
1008 introduisez une telle requête
1009 en répétant l'énoncé du titre**.
1011 **Voir aussi le plan de thèse exposé au chapitre 5.3.
1015 peut avoir un argument,
1016 quand on veut formuler soi-même
1017 une valeur prenant la place du
1018 .q "numéro de page" .
1019 Sans argument, c'est le numéro de page où se trouve la requête qui sera utilisé automatiquement.
1020 Si le numéro de page donné est un trait de soulignage
1023 aucun numéro de page
1024 ou ligne de points ne sera imprimé.
1025 Pour obtenir une ligne de points
1026 sans numéro de page,
1029 ce qui signifie qu'il n'y a pas de numéro de page.
1042 Des choux et des rois
1045 Pourquoi la mer bout
1048 Si les cochons avaient des ailes
1051 Ceci est une entrée d'index terriblement longue,
1052 comme on pourrait en avoir besoin pour
1053 une liste d'illustrations, de tableaux, ou de figures;
1054 je m'attends à ce qu'elle fasse au moins deux lignes.
1063 Des choux et des rois
1066 Pourquoi la mer bout
1069 Si les cochons avaient des ailes
1072 Ceci est une entrée d'index terriblement longue,
1073 comme on pourrait en avoir besoin pour
1074 une liste d'illustrations, de tableaux, ou de figures; je m'attends à ce qu'elle fasse au moins deux lignes.
1080 peut avoir comme argument
1081 un caractère unique,
1085 l'index normal répond à la requête
1088 on peut maintenir plusieurs
1092 **Voir aussi le plan de thèse exposé au chapitre 5.3
1094 (un pour la liste des tableaux, un pour la table des matières, etc.).
1096 Notez que l'index doit
1101 où il apparaîtra sans doute
1102 (en temps que table des matières);
1103 les pages devront peut-être être réarrangées physiquement après impression.
1104 .sh 1 "Fonctionnalités plus complexes"
1106 Il existe un grand nombre d'autres possibilités,
1107 notamment des requêtes
1108 qui fournissent d'autres types de paragraphes,
1109 des chapitres numérotés en forme
1111 (comme ils le sont dans le présent document),
1112 et l'impression sur plusieurs colonnes.
1113 .sh 2 "Autres types de paragraphes"
1115 Généralement, les paragraphes
1116 commencent par un espacement vertical et
1117 la première ligne est indentée.
1118 On peut obtenir des paragraphes justifiés
1124 comme démontré au paragraphe suivant.
1126 Parfois, vous voudrez utiliser des paragraphes dont le
1129 et la première ligne
1131 et munie d'un label.
1132 Cela peut être réalisé grâce à la requête
1134 Un mot spécifié sur la même ligne que
1136 est imprimé dans la marge,
1137 et le corps du paragraphe est aligné
1138 sur une position prédéfinie
1139 (normalement cinq espacements).
1144 Ceci est le premier paragraphe.
1145 Notez comment le reste de la première
1147 sur les autres lignes du paragraphe.
1149 Et ici nous sommes déjà au second paragraphe.
1150 Vous noterez que l'argument de \c
1152 apparaît dans la marge.
1154 Nous pouvons poursuivre ce texte...
1156 produit comme sortie:
1158 Ceci est le premier paragraphe.
1159 Notez comment le reste de la première
1161 sur les autres lignes du paragraphe.
1163 Et ici nous sommes déjà au second paragraphe.
1164 Vous noterez que l'argument de
1166 apparaît dans la marge
1168 Nous pouvons poursuivre ce texte sans
1169 commencer un nouveau paragraphe indenté
1170 en utilisant la requête
1173 Si vous avez des espacements
1174 dans le label de la requête
1176 vous devrez utiliser un
1177 .q "espacement inremplissable"
1178 au lieu d'un espacement normal.
1179 On crée celui-ci à l'aide d'un caractère antislash
1182 suivi d'un espacement.
1184 pour imprimer le label
1191 Si le label prévu pour un paragraphe indenté
1192 (c'est à dire l'argument de
1194 est plus long que l'espace prévu pour le label (cinq espacements),
1196 commencera une nouvelle ligne après le label.
1201 Ce paragraphe a un label long.
1202 Le premier caractère du texte de la première ligne
1203 ne s'alignera pas sur le texte de la seconde ligne et suivantes,
1204 bien que celles-ci soient alignées entre elles.
1208 Ce paragraphe a un label long.
1209 Le premier caractère du texte de la première ligne
1210 ne s'alignera pas sur le texte de la seconde ligne et suivantes,
1211 bien que celles-ci soient alignées entre elles.
1213 Il est possible de changer la taille du label
1214 en utilisant un second argument
1215 qui définit la taille du label.
1217 on pourra écrire l'exemple ci-dessus correctement
1220 \&.ip label\ long 10
1222 qui rendra l'indentation du paragraphe longue de
1223 10 espacements pour ce paragraphe seulement.
1224 Si vous avez plusieurs paragraphes à indenter
1225 de la même longueur,
1227 .i "registre de nombres"
1229 Par exemple, pour laisser un pouce d'espace
1235 quelque part avant le premier appel de
1237 Pour plus d'informations, voyez le
1238 .i "Manuel de Référence" .
1244 aucun label ne sera imprimé.
1249 Ceci est le premier paragraphe de l'exemple.
1250 Nous avons déjà vu ce genre d'exemples auparavant.
1252 Ce paragraphe est aligné sur le précédent,
1253 mais il n'a pas de label dans la marge.
1257 Ceci est le premier paragraphe de l'exemple.
1258 Nous avons déjà vu ce genre d'exemples auparavant.
1260 Ce paragraphe est aligné sur le précédent,
1261 mais il n'a pas de label dans la marge.
1267 qui numérote automatiquement
1268 les paragraphes de manière séquentielle à partir de 1.
1269 La numérotation repart de 1 à la prochaine requête
1274 (cette dernière est décrite au chapitre suivant).
1279 Ceci est le premier point.
1281 Ceci est le second point.
1282 Les "points" sont juste des paragraphes normaux
1283 auxquels on donne automatiquement un numéro
1284 à l'aide de la requête .np.
1286 Ce paragraphe remet la numérotation par .np à 1.
1289 nous avons recommencé la numérotation à 1.
1293 Ceci est le premier point.
1295 Ceci est le second point.
1296 Les "points" sont juste des paragraphes normaux
1297 auxquels on donne automatiquement un numéro
1298 à l'aide de la requête .np.
1300 Ce paragraphe remet la numérotation à 1 à cause de .pp.
1303 nous avons recommencé la numérotation à 1.
1307 donne des listes de ce type,
1308 qui sont identifiées par des puces
1309 plutôt que par des numéros.
1310 Les paragraphes sont aussi regroupés verticalement.
1317 \&Une c.-à-s. de crème
1319 \&Sel, poivre de Cayenne et jus de citron pour assaisonner
1321 \&Deux bonnes c.-à-s. de beurre
1326 si vous mettez ces trois ingrédients
1327 dans une cocotte assez haute,
1328 et que vous remuez le tout comme un cinglé à feu moyen
1329 (ne lâchez jamais l'anse de la cocotte) jusqu'à ce que le mélange ait la consistance d'une béchamel (ce qui prend juste une à deux minutes), si ensuite, vous retirez la cocotte du feu et vous incorporez le beurre, vous obtiendrez une délicieuse sauce hollandaise.
1334 Une c.-à-s. de crème
1336 Sel, poivre de Cayenne et jus de citron pour assaisonner
1338 Deux bonnes c.-à-s. de beurre
1339 .sh 2 "Titres de chapitres"
1341 Les titres de chapitre
1342 (comme ceux utilisés dans ce document)
1343 peuvent être générés automatiquement
1346 Vous devez indiquer à la requête
1350 du numéro de chapitre
1351 et le titre du chapitre.
1352 La profondeur indique
1353 combien de nombres doivent apparaître
1354 (séparés par des points décimaux)
1355 dans le numéro de chapitre.
1357 le numéro de chapitre
1359 a une profondeur de trois.
1361 Les numéros de chapitres
1363 de façon assez intuitive.
1364 Si vous ajoutez un numéro
1365 (ce faisant, vous augmentez la profondeur),
1366 le nouveau numéro commencera à 1.
1367 Si vous enlevez un numéro de chapitre
1368 (vous réduisez la profondeur)
1370 le même nombre de chapitre
1371 (vous gardez la même profondeur),
1372 le numéro final sera incrémenté.
1376 \&.sh 1 "Le Préprocesseur"
1377 \&.sh 2 "Concepts de base"
1378 \&.sh 2 "Entrées de contrôle"
1381 \&.sh 1 "Produire du code"
1384 donnera comme résultat:
1388 1.1. Concepts de base
1389 1.2. Entrées de contrôle
1396 Vous pouvez spécifier le numéro de chapitre dès le départ
1397 en plaçant le numéro de chapitre après le titre de chapitre,
1398 en utilisant des espacements à la place des points.
1402 \&.sh 3 "un autre chapitre" 7 3 4
1404 commencera par le chapitre ayant le numéro
1408 suivantes seront numérotées relativement à ce chapitre.
1410 Il y a des fonctionnalités encore plus complexes
1411 qui vont indenter le titre de chaque chapitre,
1412 sous-chapitre, ou sous-sous-chapitre
1413 relativement à sa profondeur.
1414 Par exemple, si vous entrez:
1419 chaque titre et sous-titre sera indenté d'une quantité
1422 a un facteur d'échelle attaché,
1423 c'est à dire qu'il doit avoir la forme
1427 indique de quelle unité est
1429 Les valeurs courantes pour
1432 pour les pouces (inches),
1434 pour les centimètres,
1439 (= une largeur de caractère).
1441 pour indenter chaque sous-chapitre
1447 après cette requête,
1448 les titre de chapitres seront indentés
1450 par niveau de profondeur.
1452 le présent document a écrit
1453 en ayant recours à la requête
1457 au début du fichier d'entrée,
1458 ce qui donne trois espacements d'indentation
1459 par niveau de profondeur du chapitre.
1461 Des numéros de chapitre
1462 sans indentation automatique
1468 qui fera un titre de chapitre,
1470 .sh 2 "Les parties du document"
1472 Certaines requêtes sont là pour
1473 aider à mettre en forme le document.
1476 initialise une page de titre.
1477 Sur une page de titre,
1478 il n'y a ni en-tête ni pied de page, et,
1479 contrairement à ce qui se passe sur les autres pages,
1480 vous pouvez laisser des grands espaces blancs
1483 une page de titre typique aura cette apparence:
1488 LA CROISSANCE DES ONGLES D'ORTEILS
1489 CHEZ LES PRIMATES SUPÉRIEURS
1501 peut être utilisée pour
1502 commencer un nouveau chapitre.
1503 Chaque nouveau chapitre sera numéroté automatiquement
1505 et le titre sera imprimé au début de chaque chapitre
1506 avec le numéro de chapitre
1507 et le nom du chapitre
1510 pour commencer un chapitre s'intitulant
1512 utilisez la requête:
1516 qui produira sur une nouvelle page,
1522 avec des espacements appropriés pour une thèse.
1523 L'en-tête aussi est déplacé en bas de page
1524 sur la première page d'un chapitre\** .
1526 \**Voir la première page de ce document
1529 Si on omet le paramètre de titre
1534 Le chapitre résultant sera un chapitre sans titre.
1535 cela peut être utilisé au commencement d'un document;
1538 a été utilisé pour créer la page 1
1539 du présent document.
1541 Même si traditionnellement
1542 les documents ont le résumé,
1543 la table des matières,
1544 etc... au début du document,
1547 il sera plus pratique
1548 de les rédiger en dernier.
1549 Il faut vous dire que les entrées d'index
1550 peuvent être collectées en amont
1552 dans la table des matières
1553 (ou d'autres index).
1554 À la fin du document,
1557 qui commence la partie préliminaire du document.
1558 Après cette requête,
1561 commencera une section préliminaire
1562 pour votre document.
1564 cela imprime le numéro de la page
1566 en chiffres romains minuscules.
1568 peut être utilisé plusieurs fois d'affilée
1569 pour ébaucher les différentes parties du document.
1572 la table des matières,
1574 la liste des illustrations,
1578 peut aussi être employée
1579 pour commencer le chapitre de bibliographie
1580 à la fin du document.
1582 Une ébauche peut être organisée
1583 comme le montre la figure 2 ci-dessous.
1585 les commentaires débutent par la requête
1592 \&.fo \(aa\(aaÉBAUCHE\(aa\(aa \e" définir un pied de page pour chaque page.
1593 \&.tp \e" commencer la page de titre
1594 \&.(l C \e" liste centrée
1596 DES ONGLES D'ORTEILS
1597 CHEZ LES PRIMATES SUPÉRIEURS
1602 \&.)l \e" fin de la liste centrée
1603 \&.+c INTRODUCTION \e" début du chapitre intitulé "INTRODUCTION"
1604 \&.(x t \e" faire une entrée pour l'index `t'
1606 \&.)x \e" fin de l'entrée d'index
1607 texte du chapitre 1 \e" =Introduction
1608 \&.+c "CHAPITRE SUIVANT" \e" commencer un nouveau chapitre
1609 \&.(x t \e" faire un entrée pour 'index `t'
1612 texte du chapitre 2 \e" =chapitre suivant
1617 texte du chapitre 3 \e" =Conclusions
1618 \&.++ B \e" commencer la bibliographie
1619 \&.+c BIBLIOGRAPHIE \e" commencer un nouveau `chapitre'
1623 texte de la bibliographie
1624 \&.++ P \e" commencer la partie préliminaire du document
1625 \&.+c "TABLE DES MATIÈRES"
1626 \&.xp t \e" imprimer l'index `t' collecté en amont
1627 \&.+c PREFACE \e" commencer un nouveau chapitre dans la partie préliminaire.
1632 Figure 2. Ébauche d'un exemple de document.
1635 .sh 2 "Équations et Tableaux"
1637 Il existe deux programmes \*U spécialement conçus
1638 pour formater les types de matières spéciaux.
1640 imprime les équations.
1643 de très jolis tableaux
1644 dans toute une variété de formats.
1645 Le présent document décrira seulement comment
1647 leur fonctionnalités standard.
1649 comment ces deux programmes fonctionnent
1650 consultez les manuels de référence de ces processeurs\**.
1660 est décrit complètement
1663 Typesetting Mathematics \- User's Guide
1664 par Brian W. Kernighan
1665 and Lorinda L. Cherry\**.
1667 \**Disponible sur la toile
1669 Les équations sont centrées
1670 et restent sur une page.
1671 On les introduit dans le texte par la requête
1673 et on les termine par la requête
1678 peut avoir un numéro d'équation comme
1680 Ce numéro sera imprimé centré
1681 à droite de l'équation.
1682 Si l'équation devient trop longue,
1683 on devra l'imprimer sur deux lignes.
1684 Pour faire ceci, tapez:
1687 texte de l'équation 34
1690 continuation de l'équation 34
1697 spécifie que l'équation
1702 produit des tableaux.
1703 Il est décrit complètement
1704 (avec des exemples numériques)
1707 Tbl \- A Program to Format Tables
1710 \**Également disponible sur la toile
1712 Les tableaux commencent par la requête
1714 et se terminent par la requête
1716 Normalement, les tableaux restent sur la même page.
1717 Si vous avez un tableau trop grand
1718 pour tenir sur une seule page,
1720 qu'il lui en faudra plusieurs,
1721 commencez le tableau avec la requête
1723 et mettez la requête
1725 après la ligne du tableau
1727 imprimer au début de chaque page
1728 contenant le tableau.
1729 Par exemple, la définition
1732 .ds TA \|\h'.4n'\v'-.2n'\s-4\zT\s0\v'.2n'\h'-.4n'\(ci\|
1733 .if n .ds TA \ \o'-T'\ \"
1744 .sh 2 "Sortie sur deux colonnes"
1746 Vous pouvez rédiger votre texte sur deux colonnes
1750 Cela rendra tout contenu
1751 suivant cette requête
1755 commencera une nouvelle colonne;
1760 peut laisser une colonne totalement
1761 vide quand il commence une nouvelle page.
1762 Pour revenir à l'impression sur une colonne,
1765 .sh 2 "Définir un macro"
1769 est un ensemble formé de requêtes et de texte
1770 qui peut être résumé
1771 en une seule requête.
1772 Les macros commencent par la ligne
1777 est le nom du macro que l'on va définir)
1778 et elle finit par une ligne consistant en 2 points.
1779 Après avoir défini le macro,
1783 revient à écrire toutes les autres lignes.
1785 pour définir un macro
1786 qui espace de trois lignes
1787 et centre les lignes qui suivent,
1795 et utilisez en rédigeant:
1802 Les noms des macros peuvent être formés d'un ou deux caractères.
1803 Pour éviter les conflits avec des noms de requêtes
1805 utilisez toujours des majuscules.
1806 Les seuls noms à éviter sont
1813 .sh 2 "Annotations à l'intérieur d'un clos"
1815 Parfois, vous voudrez insérer
1816 une note en bas de page
1817 ou une entrée d'index
1818 à l'intérieur d'un clos.
1820 si vous vouliez maintenir une
1821 .q "liste des figures"
1822 vous pourriez vouloir faire quelque chose comme:
1835 et vous pourriez espérer
1836 que ça donne une figure
1838 et une entrée d'index
1840 (probablement une liste des figures).
1843 est lue et interprétée
1844 lorsque le clos est lu,
1845 et non pas lorsqu'il est imprimé,
1846 et donc le numéro de page dans l'index sera probablement erroné.
1847 La solution est d'utiliser la chaîne magique
1849 au début de chaque ligne se rapportant à l'index.
1864 qui différera l'indexation
1865 jusqu'à ce que la figure soit en sortie.
1867 que le numéro de la page dans l'index soit correct.
1868 Le même commentaire s'applique aussi
1874 .sh 1 "\*T et le photocompositeur"
1876 Avec un peu de soin,
1877 vous pouvez préparer
1879 qui seront joliment imprimés
1880 sur un terminal normal,
1881 ou, si vous avez besoin d'un photocompositeur,
1882 en utilisant le programme de formatage \*T .
1887 est un style de caractères.
1889 disponibles simultanément,
1893 plus la police spéciale pour les maths.
1894 La police normale est Roman.
1896 On peut à tout instant
1904 changent respectivement sur Roman,
1908 Vous pouvez mettre un seul mot
1909 dans une certaine police
1910 en tapant (par exemple):
1917 mais n'affectera pas le texte environnant.
1919 Notez que si vous voulez mettre plus d'un mot à la fois
1920 dans une police de votre choix,
1921 vous devez entourer ces mots de guillemets
1923 ainsi, pour le processeur \*G, ils apparaîtront comme un seul mot.
1924 Les guillemets n'apparaîtront pas dans le texte.
1925 Si vous voulez que des guillemets apparaissent dans le texte,
1926 vous devrez mettre toute la chaîne de caractères entre guillemets
1927 (même si il s'agit d'un seul mot),
1930 paires de guillemets,
1931 quand vous voulez qu'une paire apparaisse.
1933 si vous voulez produire le texte:
1935 .i """poisson d'avril\|"""
1937 en italique, vous devez taper:
1939 \&.i """poisson d'avril\e|"""
1943 produit un petit espacement
1948 ne soit pas trop proche des guillemets dans \*G,
1949 comme cela l'est ici:
1951 .i """poisson d'avril"""
1961 \&.bx "mots dans un cadre"
1967 .bx "mots dans un cadre"
1969 Notez que les requêtes de pseudo-police
1970 ne mettent qu'un seul paramètre dans la pseudo-police;
1971 les requêtes de police ordinaire (.r, .i, .b, et .bi)
1972 vont commencer à mettre
1973 tout le texte qui suit
1974 dans la police spéciale
1975 si vous ne fournissez pas de paramètre précis\**.
1977 \**N.d.tr. Pour cela, commencer une nouvelle ligne directement après la requête.
1978 La police spéciale sera maintenue jusqu'à la fin du paragraphe.
1980 Si vous utilisez ces requêtes de pseudo-polices (.u, .bx)
1981 au milieu des lignes,
1982 elles ne devraient porter vraiment que sur un seul mot.
1983 Ceci à cause de la manière
1984 de laquelle \*G justifie le texte.
1986 si vous voulez utiliser les requêtes:
1988 \&.u "italiques gras"
1990 \&.bx "mots dans un cadre"
1992 au milieu d'une ligne,
1996 .bx "mots dans un cadre" ,\p
1997 ce qui, vous l'admettrez sans peine, n'est pas très joli.
2000 de toutes les requêtes de police
2001 est dans la police d'origine.
2003 la requête de police:
2012 dans la police du texte environnant,
2017 Pour avoir les deux mots
2028 Vous pouvez panacher les polices à l'intérieur d'un seul mot en utilisant
2029 une séquence spéciale
2033 .q "continuer à traiter le texte" ;
2034 cela permet aux lignes d'entrée
2035 d'être mises bout à bout
2036 sans être interrompues par un espacement.
2037 Par exemple, l'entrée:
2045 mais si nous avions tapé:
2050 le résultat aurait été
2054 .sh 2 "Tailles de caractères"
2057 supporte différentes tailles de caractères,
2059 La taille de caractères par défaut
2061 pour le corps de texte,
2062 8 points pour les notes en bas de page.
2063 Pour changer la taille des caractères,
2071 est la taille souhaitée exprimée en points.
2073 .q "ajouter de la taille"
2081 en utilisant le signe - à la place de + .
2084 .i "espacement vertical"\**
2086 \**Distance entre le bas de la plupart des lettre
2089 de deux lignes adjacentes.
2091 sera proportionnel à
2092 la taille des caractères.
2096 , ces changements de tailles de caractères sont
2098 Pour revenir à la taille par défaut, tapez simplement
2102 Si vous voulez influencer systématiquement la taille des éléments de votre texte, utilisez les commandes
2107 met tout corps de texte se trouvant après cette commande à 12 pts.
2111 met tous les titres de chapitre suivant cette commande à 12 pts.
2115 met tous les en-têtes et pieds de page suivant cette commande à 12 pts.
2116 Vous la placerez avantageusement directement après la commande .he (ou .fo).
2118 On peut donner à un seul mot ou phrase
2119 une taille plus petite
2120 que celle du texte environnant
2121 en utilisant la requête
2123 Cela convient spécialement aux mots écrits en capitales,
2124 à cause d'une illusion d'optique qui les fait paraître
2125 plus grandes qu'elles ne le sont vraiment.
2132 ce qui est plus joli que UNIX.
2135 changer les tailles de caractères
2136 sur le photocompositeur
2137 est une opération mécanique lente.
2138 Sur les imprimantes laser, il faudra peut-être recharger de nouvelles polices.
2139 Dès lors les changements de tailles de caractères devraient être utilisés avec prudence.
2143 pour créer des guillemets,
2145 d'utiliser deux accents graves et deux accents aigus,
2146 plutôt que les guillemets
2149 deux accents graves et deux accents aigus
2150 donnent un meilleur résultat optique.
2151 Par exemple, comparez
2155 Vous pourrez aussi utiliser la séquence
2159 pour mettre les guillemets respectivement à gauche et à droite
2160 du mot ou de l'expression concernés.
2164 \e*(lqCertaines choses ne sont pas vraies,
2165 même si elles ont eu lieu.\e*(rq
2169 .q "Certaines choses ne sont pas vraies, même si elles ont eu lieu"
2171 Plus rapide, la requête:
2173 \&.q "texte entre guillemets"
2176 .q "texte entre guillemets" .
2177 Notez que vous devez entourer
2178 le texte concerné de guillemets
2179 s'il est formé de plusieurs mots.
2184 J'aimerais remercier
2188 pour avoir eu le courage
2189 d'utiliser les macros \-me
2190 pour écrire des documents inhabituels
2191 durant la phase de développement;
2195 pour leur aide durant la phase de documentation;
2197 pour ses nombreux griefs,
2198 des années après que j'aie considéré le projet comme
2200 le plus souvent accompagnés de propositions de solutions
2201 (qui m'ont donc forcé à réparer plusieurs petits bogues);
2202 et la foule de gens qui ont contribué à ce projet
2203 par leurs idées ou leur soutien.
2207 le 27 octobre 2001 et s'applique à la version des macros \-me
2208 inclus dans la version 1.17.2 de \*G.
2210 La traduction française a été
2212 le 20 octobre 2013, toutes les commandes ont été testées sur la version 1.21 de \*G.
2214 .uh "Annexe: petit lexique des noms de requêtes"
2215 Par ordre d'apparition dans le texte
2220 \&.sp|space|espacement
2221 \&.pp|paragraph|nouveau paragraphe
2222 \&.he|header|en-tête
2223 \&.fo|footer|pied de page
2224 \&.ls|line spacing|espacement vertical (entre les lignes)
2225 \&.in|indent|indentation
2226 \&.ce|center|centrer
2227 \&.br|break|interruption (commence une nouvelle ligne)
2228 \&.(q|quote|citation (début)
2229 \&.)q|quote|citation (fin)
2230 \&.(l|list|liste (début)
2231 \&.)l|list|liste (fin)
2232 \&.(b|bloc|bloc (début)
2233 \&.)b|bloc|bloc (fin)
2234 \&.(z|floating keep|clos flottant (début)
2235 \&.)z|floating keep|clos flottant (fin)
2236 \&.hl|horizontal line|ligne horizontale
2237 \&.(c|centered block|bloc centré (début)
2238 \&.)c|centered block|bloc centré (fin)
2239 \&.(f|footnote|note en bas de page (début)
2240 \&.)f|footnote|note en bas de page (fin)
2241 \&.(x|index|faire apparaître dans l'index (début)
2242 \&.)x|index|faire apparaître dans l'index (fin)
2243 \&.xp|print index|imprimer l'index
2244 \&.lp|lined up paragraph|paragraphe aligné (à 1e ligne non-indentée)
2245 \&.ip|indented paragraph|paragraphe indenté, sauf en sa première ligne
2246 \&.np|numbered paragraph|paragraphe numéroté
2247 \&.sh|set header|faire un titre
2248 \&.uh|unnumbered header|titre non-numéroté
2249 \&.tp|title page|page de titre
2250 \&.+c|add chapter|ajouter un chapitre
2251 \&.EQ|equation|équation (début)
2252 \&.EN|equation|équation (fin)
2253 \&.TS|table start|tableau (début)
2254 \&.TE|table end|tableau (fin)
2255 \&.2c|2 column|écrire sur 2 colonnes
2256 \&.1c|1 columns|écrire sur 1 colonne
2257 \&.de xx|define macro|définir un macro
2259 \&.i|italic|italique
2261 \&.bi|bold italic|italique gras
2262 \&.u|underlined|souligné
2264 \&.sz|size|taille de police
2265 \&.sm|small|plus petit que le texte environnant
2266 \&.q|quoted|entre guillemets