freetable (2.3-4) fr.pod

Summary

 fr.pod |  186 ++++++++++++++++++++++++++++++++++++++++++++++-------------------
 1 file changed, 132 insertions(+), 54 deletions(-)

    
download this patch

Patch contents

--- freetable-2.3.orig/fr.pod
+++ freetable-2.3/fr.pod
@@ -1,16 +1,10 @@
-freetable 0.11
-Tomasz Wêgrzanowski <taw@users.sf.net>
+=head1 NOM
 
-French Documentation 0.11-1
-Denis Barbier <barbier@imacs.polytechnique.fr>
-
-=head1 NAME
-
-freetable - outil de génération automatique de tableaux HTML
+B<freetable> - outil de génération automatique de tableaux HTML
 
 =head1 VERSION
 
-Cette documentation décrit l'utilisation de freetable 1.1.
+Cette documentation décrit l'utilisation de B<freetable> version 2.3.
 
 Si vous utilisez une autre version, certaines différences peuvent
 apparaitre.
@@ -19,17 +13,20 @@
 
 B<freetable> I<[options]> F<fichier>
  
+ou
+
+B<freetable> I<[options]>
+
 Options:
 
-I<-h>, I<--help>        Print usage info and exit
+I<-h>, I<--help>        Affiche cette aide et stoppe
 
 I<-V>, I<--version>     Affiche seulement le numéro de version
-                  de F<freetable>
 
 I<-c>, I<--comment>     Affiche un commentaire avant chaque
                   cellule pour indiquer son emplacement
 
-I<-b>, I<--no-nbsp>     N'ajoute pas C<&nbsp;> dans les cellules
+I<-b>, I<--no-nbsp>     N'ajoute pas I<&nbsp;> dans les cellules
                   vides pour modifier le rendu 3D
 
 I<-w>, I<--warning>     Affiche un commentaire avant chaque
@@ -42,23 +39,24 @@
                   tableaux par la position de la cellule
                   courante.
 
-I<-m>, I<--macro>       Avec cette option, le contenu des
+I<-m>, I<--macro> I<[program]>
+                  Avec cette option, le contenu des
                   cellules est passé à un pré-processeur,
-                  qui est F<m4> par défaut
+                  qui est B<m4> par défaut
 
-=head1 AVERTISSEMENT SUR LA SECURITE
+=head1 AVERTISSEMENT SUR LA SÉCURITÉ
 
- N'UTILISEZ PAS DE MACRO PROCESSEUR SUR UN
- FICHIER SOURCE DONT VOUS N'ETES PAS SUR.
- CELA POURRAIT COMPROMETTRE LA SECURITE DE
- VOTRE SYSTEME
+ N'UTILISEZ PAS DE MACRO-PROCESSEUR SUR UN
+ FICHIER SOURCE DONT VOUS N'ÊTES PAS SÛR.
+ CELA POURRAIT COMPROMETTRE LA SÉCURITÉ DE
+ VOTRE SYSTÈME
 
- Plus d'informations dans la documentation de F<m4>,
- en particulier la commande I<syscmd>.
+Plus d'informations dans la documentation de B<m4>,
+en particulier la commande I<syscmd>.
 
 =head1 DESCRIPTION
 
-Ce programme est un logiciel libre qui remplace F<wwwtable>.
+Ce programme est un logiciel libre qui remplace B<wwwtable>.
 
 HTML est un langage agréable, mais avec un énorme défaut : les tableaux.
 J'ai passé de nombreuses heures à lire le code source que j'avais tout
@@ -69,8 +67,8 @@
 documentation et votre peine ne sera plus qu'un mauvais souvenir.
 
 Le programme reçoit en entrée du code HTML provenant soit de l'entrée
-standard, soit d'un fichier. Il recherche alors les caractères suivants,
-qui annoncent l'ouverture d'un tableau:
+standard (I<stdin>), soit d'un fichier. Il recherche alors les
+caractères suivants, qui annoncent l'ouverture d'un tableau:
 
    <wwwtable [options]>
 
@@ -90,42 +88,43 @@
     ...
     </wwwtable>
 
-La chaine optionnelle wwwtable_options est passée telle quelle comme
-attribut de la balise C<E<lt>TABLEE<gt>>. Le préambule n'est pas traité,
+La chaîne optionnelle wwwtable_options est passée telle quelle comme
+attribut de la balise C<E<lt>tableE<gt>>. Le préambule n'est pas traité,
 il peux contenir n'importe quel code HTML, il sera inséré au début du
 tableau.
 
-Les cellules sont soit des cellules normales (balise C<E<lt>TDE<gt>>),
-soit des cellules d'en-tête (balise C<E<lt>THE<gt>>).
+Les cellules sont soit des cellules normales (balise C<E<lt>tdE<gt>>),
+soit des cellules d'en-tête (balise C<E<lt>thE<gt>>).
+Il en était ainsi jusqu'aux versions 1.x, voyez la prochaine section
+pour une autre méthode d'adressage des colonnes.
 
     cellule normale:
-    (ligne,colonne) cellule_options
+    (ligne,colonne) options_cellule
     contenu_cellule
 
     cellule en-tête:
-    ((ligne,colonne)) cellule_options  
+    ((ligne,colonne)) options_cellule  
     contenu_cellule
 
-Le texte contenu dans cellule_options est passé comme attribut
-de la balise de la cellule. Les mots-clés C<colspan> et C<rowspan>
+Le texte contenu dans options_cellule est passé comme attribut
+de la balise de la cellule. Les mots-clés I<colspan> et I<rowspan>
 sont interprétés pour générer des tableaux corrects.
 
 Le contenu des cellules (contenu_cellule) est quelconque, il peut même
 contenir d'autres wwwtables !
 
-Si vous utilisez l'option I<-m>, le contenu des cellules sera passé
-comme entrée standard de la commande F<m4>(1), après avoir remplacé les
-chaines de caractères B<E<lt>rowE<gt>> (resp. B<E<lt>colE<gt>>)
-par le numéro de ligne (resp. colonne) de la cellule.
-
-Les indices de ligne et colonne sont soit des nombres, soit une
-expression régulière qui désigne un ensemble de cellules. À la
-différence de F<wwwtable>, F<freetable> peut aussi utiliser des
-expressions régulières dans les cellules d'en-tête. Un autre ajout est
-la possiblité d'utiliser C<*> à la place de C<.*>.
+Si vous utilisez l'option I<-m> (ou son synonyme I<--macro>), le contenu
+des cellules sera passé comme entrée standard de la commande B<m4>(1),
+après avoir remplacé les chaînes de caractères B<E<lt>rowE<gt>> (resp.
+B<E<lt>colE<gt>>) par le numéro de ligne (resp. colonne) de la cellule.
+
+Les indices de ligne et colonne sont soit des nombres, soit un adressage
+relatif, soit une expression régulière qui désigne un ensemble de
+cellules. À la différence de B<wwwtable>, B<freetable> peut aussi
+utiliser des expressions régulières dans les cellules d'en-tête. Un
+autre ajout est la possiblité d'utiliser I<*> à la place de I<.*>.
 
-Les expressions régulières suivantes sont reconnues dans les indices de
-lignes et colonnes:
+L'adressage relatif est de la forme :
 
 I<=> ou vide : même indice que la cellule précédente
 
@@ -133,8 +132,8 @@
 
 I<-> ou I<-X> : décrémente l'indice de I<X> (défaut: 1)
 
-Lorsqu'une cellule est désignée par plusieurs expressions régulières, à
-la fois les options et le contenu de chaque cellule sont ajoutés.
+Lorsqu'une cellule est désignée par plusieurs expressions, à la fois les
+options et le contenu de chaque cellule sont ajoutés.
 
 Si vous n'utilisez que des expressions régulières, il faut indiquer au
 programme la position de la dernière cellule.
@@ -147,21 +146,91 @@
     (4,4)
     </wwwtable>
 
-=head1 INCOMPATIBILITES AVEC WWWTABLE
+=head1 AUTRE SYNTAXE D'ADRESSAGE
+
+Il n'est pas très pratique de spécifier les numéros de cellules avec des
+expressions régulières. B<Freetable> 2.0 a introduit deux nouvelles
+méthodes d'adressage, qui peuvent être utilisées sur les cellules
+normales et les cellules d'en-tête.
+
+Une compatibilité totale avec les versions antérieures est assurée.
+Pour cette raison, il n'était pas question de modifier la syntaxe
+actuelle. Malheureusement, vous ne pouvez pas spécifier les lignes en
+utilisant une syntaxe d'adressage, et les colonnes avec une autre
+syntaxe. Pour remédier à ce problème, les deux méthodes sont très
+souples, si bien que vous ne devriez jamais avoir à les mélanger, et
+elles vous permettent d'utiliser I<=>, I<+>, I<->, I<+X>, I<-X> et la
+chaîne vide de la même façon qu'avec B<freetable> 1.x.
+
+De plus, ces nouvelles méthodes déterminent automatiquement la dernière
+cellule, contrairement à l'adressage par des expressions régulières.
+
+=head2 BORNES EXPLICITES
+
+    (bornes_ligne;bornes_colonne) options_cellule
+    contenu_cellule
+
+La syntaxe pour I<bornes_ligne> et I<bornes_colonne> est de la forme:
+1-2,4-7,9,12. Les doublons sont éliminés. Pour les besoins de
+l'adressage relatif, le dernier nombre est utilisée. Ainsi, quand vous
+écrivez
+
+    (1-100,32;1)
+    foo
+    (+,)
+    bar
+
+la cellule (33,1) contiendra « foo bar » et toutes les autres seulement
+« foo ».
+
+=head2 CODE PERL QUELCONQUE
+
+    ({code pour les lignes},{code pour les colonnes}) options_cellule
+    contenu_cellule
+
+Vous pouvez utiliser n'importe quel code Perl qui tient sur une seule
+ligne du moment qu'il est repéré oar notre expression régulière (pas
+très futée) et renvoie une liste. Il n'est malheureusement pas possible
+de détecter n'importe quel code de Perl grâce à une expression
+régulière, mais du moment qu'il ne contient pas les séquences I<},{> et
+I<})>, cela devrait marcher. Exemple :
+    <wwwtable>
+    ({grep {$_%3 == 1} 1..100},{1..2,4})
+    foo
+    </wwwtable>
+
+va créer un tableau de 100 lignes par 4 colonnes avec « foo » dans les
+premières, deuxième et quatrième colonnes de chaque ligne dont le numéro
+vaut 1 modulo 3.
+
+Si vous voulez mélanger cet adressage avec le précédent, il suffit de
+remplacer I<-> par I<..> dans la définition des bornes, et l'entourer
+par des accolades I<{> et I<}>.
+
+Si vous voulez mélanger cet adressage avec une expression régulière,
+vous pouvez remplacer cette dernière par I<{grep {/expression/} min..max}>.
+Il est malheureusement obligatoire de spécifier explicitement la
+dimension du tableau.
+
+=head1 INCOMPATIBILITÉS AVEC WWWTABLE
 
-Les utilisateurs de F<wwwtable> qui décident de passer à F<freetable>
+Les utilisateurs de B<wwwtable> qui décident de passer à B<freetable>
 devraient lire cette section. La majorité des incompatibilités
 proviennent du traitement des expressions régulières. Il faut aussi
-noter que F<wwwtable> ne permettait ni le remplacement automatiques des
+noter que B<wwwtable> ne permettait ni le remplacement automatiques des
 numéros de lignes et de colonnes, ni l'utilisation d'un
 pré-processeur.
 
+L'option I<-w> a le comportement opposé. Nous n'écrivons aucun
+commentaire par défaut, et I<-w> ou I<--warning> est utilisée pour les
+ajouter.
+
 Les cellules d'en-tête peuvent être définies avec des expressions
 régulières, par exemple
 
-    ((1,*)) align=right
+    ((1,*))
     
-ce qui était impossible avec F<wwwtable>.
+ce qui était impossible avec B<wwwtable>.
 
 Les indices des axes sont 100% orthogonaux, ce qui signifie qu'avec le code
 suivant
@@ -172,7 +241,7 @@
     (=,=)
     Foo
 
-C<Foo> va apparaitre en 3e colonne, et si vous vouliez qu'il soit en 1e
+Foo va apparaitre en 3e colonne, et si vous vouliez qu'il soit en 1e
 position, il faut écrire
 
     (*,1) width=30
@@ -189,15 +258,24 @@
     (=,1)
     Foo
 
+Avec B<freetable> 2.0, deux méthodes complètement nouvelles d'adressage
+des cellules ont été introduites. Elles sont totalement incompatibles
+avec B<wwwtable>.
+
+=head1 BUGS
+
+L'utilisation de « code Perl quelconque » échouera avec du code
+complexe.
+
 =head1 VOIR AUSSI
 
-    B<m4(1)>
+B<m4(1)>
 
 =head1 AUTEUR
 
 Tomasz Wegrzanowski <taw@users.sourceforge.net>
 
 Traduction française de la documentation:
-Denis Barbier <barbier@imacs.polytechnique.fr>
+Denis Barbier <barbier@debian.org>
 
 =cut