gbranden pushed a commit to branch master
in repository groff.
commit 10f7f1e889f5750f2092347701142106c0f73c9b
Author: G. Branden Robinson <[email protected]>
AuthorDate: Wed Aug 6 04:49:34 2025 -0500
doc/meintro_fr.me.in: Better nroff-mode cosmetics.
* Configure page offset to more closely resemble that of a traditional,
formal, but still typewritten, document.
* Illustrate use of brace escape sequences to group formatting commands.
* Add a page footer to (1) disclose the corresponding groff version and
(2) illustrate where the bottom page margin is.
* Fix unfilled text in examples to not overrun the line length. This
includes an adjustment to the tab stops in one example. Like the new
nroff-mode line lengths and page offset, we use ens instead of inches
as (what I regard as) preferably pedagogy for learners.
* Repeat the unfilled text verbatim in the examples illustrating their
input, even if the changed input line breaks "don't matter"; it is
better pedagogy to demonstrate rendering of identical inputs.
* Disable adjustment prior to rendering the table at the end of the
document, so its text blocks don't look funny.
---
doc/meintro_fr.me.in | 96 ++++++++++++++++++++++++++++++++++------------------
1 file changed, 63 insertions(+), 33 deletions(-)
diff --git a/doc/meintro_fr.me.in b/doc/meintro_fr.me.in
index f63b9e9ef..426296f54 100644
--- a/doc/meintro_fr.me.in
+++ b/doc/meintro_fr.me.in
@@ -41,12 +41,16 @@
.\"
.\" Translated to French by Grégoire Babey <[email protected]>
.\"UC 7
-.if t .ll 6.5i
-.if t .lt 6.5i
+.if t \{\
+. ll 6.5i
+. lt 6.5i
+.\}
+.if n .po 10n
.nr sx 0
.ds MO @VERSION@
.nr si 3n
.he '\f(BIgroff\fP en option \f(BI\-me\fP''%'
+.fo ''\f(BIgroff\fP \*(MO''
.\"eh 'USD:19-%''Writing Papers with NROFF using \-me'
.\"oh 'Writing Papers with NROFF using \-me''USD:19-%'
.ds U Unix
@@ -545,7 +549,8 @@ qui présente en traduction (anglaise)
les phrases les plus délicieuses de Confucius.
Décidément un passage obligé
pour tous ceux qui s'intéressent
-au fondements primitifs de la philosophie chinoise.
+au fondements primitifs
+de la philosophie chinoise.
.)b
produira:
.sp 2
@@ -553,10 +558,13 @@ produira:
.ti \n($iu
Ware, James R. The Best of Confucius,
Halcyon House, 1950.
-Un livre excellent, qui présente
-en traduction (anglaise) les phrases les plus délicieuses de Confucius.
-Décidément un passage obligé pour tous ceux
-qui s'intéressent au fondements primitifs de la philosophie chinoise.
+Un livre excellent,
+qui présente en traduction (anglaise)
+les phrases les plus délicieuses de Confucius.
+Décidément un passage obligé
+pour tous ceux qui s'intéressent
+au fondements primitifs
+de la philosophie chinoise.
.pp
Les lignes de texte peuvent être centrées en utilisant la requête
.b .ce .
@@ -623,18 +631,22 @@ l'entrée:
.(b
Comme l'indique Weizenbaum:
\&.(q
-On dit qu'expliquer, c'est expliquer en s'éloignant.
+On dit qu'expliquer, c'est expliquer
+en s'éloignant.
Cette maxime ne s'accomplit nulle part aussi bien
-que dans le domaine de la programmation informatique,...
+que dans le domaine
+de la programmation informatique,...
\&.)q
.)b
génère comme sortie:
.lp
Comme l'indique Weizenbaum:
.(q
-On dit qu'expliquer, c'est expliquer en s'éloignant.
+On dit qu'expliquer, c'est expliquer
+en s'éloignant.
Cette maxime ne s'accomplit nulle part aussi bien
-que dans le domaine de la programmation informatique,...
+que dans le domaine
+de la programmation informatique,...
.)q
.sh 2 "Listes"
.pp
@@ -832,13 +844,15 @@ tapez
L'entrée:
.(b
\&.(l
-première ligne d'une mise en évidence non-justifiée
+première ligne d'une mise
+en évidence non-justifiée
lignes suivantes
\&.)l
.)b
produit un texte indenté:
.(b
-première ligne d'une mise en évidence non-justifiée
+première ligne d'une mise
+en évidence non-justifiée
lignes suivantes
.)b
En tapant
@@ -847,16 +861,19 @@ après la requête
.b .(l
cela produira le même résultat, mais aligné à gauche:
.(b L
-première ligne d'une mise en évidence non-justifiée
+première ligne d'une mise
+en évidence non-justifiée
lignes suivantes
.)b
+.ne 2v
Si vous utilisez
.b C
à la place de
.b L
vous obtenez une liste centrée:
.(b C
-première ligne d'une mise en évidence non-justifiée
+première ligne d'une mise
+en évidence non-justifiée
lignes suivantes
.)b
.pp
@@ -893,7 +910,8 @@ utilisez:
.(b
\&.(b L
\&.(c
-première ligne d'une mise en évidence non-justifiée
+première ligne d'une mise
+en évidence non-justifiée
lignes suivantes
\&.)c
\&.)b
@@ -902,7 +920,8 @@ lignes suivantes
ce qui produira:
.(b L
.(c
-première ligne d'une mise en évidence non-justifiée
+première ligne d'une mise
+en évidence non-justifiée
lignes suivantes
.)c
.)b
@@ -978,7 +997,8 @@ un homme qui n'est pas attentif
et qui, en même temps, est ignorant;
un homme qui est rempli de mensonge
et qui, en même temps, est incompétent;
-un tel homme ne fait pas partie de mes relations.\e**
+un tel homme ne fait pas partie
+de mes relations.\e**
\&.(f
\e**Traduit de :James R. Ware,
\&.ul
@@ -996,7 +1016,8 @@ un homme qui n'est pas attentif
et qui, en même temps, est ignorant;
un homme qui est rempli de mensonge
et qui, en même temps, est incompétent;
-un tel homme ne fait pas partie de mes relations.\**
+un tel homme ne fait pas partie
+de mes relations.\**
.(f
\**Traduit de: James R. Ware,
.ul
@@ -1127,8 +1148,10 @@ Si les cochons avaient des ailes
\&.(x
Ceci est une entrée d'index terriblement longue,
comme on pourrait en avoir besoin pour
-une liste d'illustrations, de tableaux, ou de figures;
-je m'attends à ce qu'elle fasse au moins deux lignes.
+une liste d'illustrations, de tableaux,
+ou de figures;
+je m'attends à ce qu'elle fasse
+au moins deux lignes.
\&.)x
\&.xp
.)b
@@ -1148,8 +1171,10 @@ Si les cochons avaient des ailes
.(x
Ceci est une entrée d'index terriblement longue,
comme on pourrait en avoir besoin pour
-une liste d'illustrations, de tableaux, ou de figures;
-je m'attends à ce qu'elle fasse au moins deux lignes.
+une liste d'illustrations, de tableaux,
+ou de figures;
+je m'attends à ce qu'elle fasse
+au moins deux lignes.
.)x
.xp
.pp
@@ -1398,7 +1423,8 @@ l'entrée:
\&.bu
\&Une c.-à-s. de crème
\&.bu
-\&Sel, poivre de Cayenne et jus de citron pour assaisonner
+\&Sel, poivre de Cayenne et jus de citron
+pour assaisonner
\&.bu
\&Deux bonnes c.-à-s. de beurre
.)b
@@ -1420,7 +1446,8 @@ Un jaune d'oeuf
.bu
Une c.-à-s. de crème
.bu
-Sel, poivre de Cayenne et jus de citron pour assaisonner
+Sel, poivre de Cayenne et jus de citron
+pour assaisonner
.bu
Deux bonnes c.-à-s. de beurre
.sh 2 "Titres de chapitres"
@@ -1675,9 +1702,9 @@ les commentaires débutent par la requête
.hl
.if t .in 0.5i
.if t .ta 2i
-.if n .ta \w'.+c "CHAPITRE SUIVANT"'u+1n
-\&.fo \(aq\(aqÉBAUCHE\(aq\(aq \e" définir un pied de page pour chaque\
- page
+.if n .ta 23n
+\&.fo \(aq\(aqÉBAUCHE\(aq\(aq \e" définir un pied de page...
+\&. \e" ...pour chaque page
\&.tp \e" commencer la page de titre
\&.(l C \e" liste centrée
LA CROISSANCE
@@ -1688,7 +1715,8 @@ par
\&.sp
Frank Furter
\&.)l \e" fin de la liste centrée
-\&.+c INTRODUCTION \e" début du chapitre intitulé "INTRODUCTION"
+\&.+c INTRODUCTION \e" début du chapitre intitulé...
+\&. \e" ..."INTRODUCTION"
\&.(x t \e" faire une entrée pour l\(aqindex "t"
Introduction
\&.)x \e" fin de l\(aqentrée d\(aqindex
@@ -1709,12 +1737,13 @@ texte du chapitre 3 \e" =Conclusions
Bibliographie
\&.)x
texte de la bibliographie
-\&.++ P \e" commencer la partie préliminaire...
-\&. \e" ...du document
+\&.++ P \e" commencer la partie...
+\&. \e" ...préliminaire du document
\&.+c "TABLE DES MATIÈRES"
-\&.xp t \e" imprimer l\(aqindex "t" collecté en amont
+\&.xp t \e" imprimer l\(aqindex "t" collecté...
+\&. \e" ...en amont
\&.+c PREFACE \e" commencer un nouveau chapitre...
-\&. \e" ...dans la partie préliminaire.
+\&. \e" ...dans la partie préliminaire.
texte de la préface
.sp 2
.in 0
@@ -2305,6 +2334,7 @@ par leurs idées ou leur soutien.
.uh "Annexe: petit lexique des noms de requêtes"
Par ordre d'apparition dans le texte
.sp
+.na
.TS
tab(|);
L L Lx.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
