flnews_post_proc 1.72 → 1.74

data/doc/fr/rst/flnews_post_proc.rst

@@ -1,16 +1,15 @@
-=======================
- flnews_post_proc
+flnews_post_proc
 =======================
 ------------------------------------------
- Post-Traitement pour flnews
+Post-Traitement pour flnews
 ------------------------------------------
 
 SYNOPSIS
 =======================
 
-Un article est envoyé au logiciel de post-traitement via STDIN. Ceci se passe
-automatiquement, quand la variable « post_proc » dans le fichier de
-configuration de flnews a la valeur *flnews_post_proc*.
+Un article est envoyé au logiciel de post-traitement via STDIN. Cela se fait
+automatiquement lorsque la variable « post_proc » dans le fichier de
+configuration de flnews est définie sur *flnews_post_proc*.
 
 Si un article a été sauvegardé dans un fichier, il peut servir pour tester le
 fonctionnement de flnews_post_proc, en lançant une commande comme :
@@ -24,38 +23,38 @@ ou si vous préférez l'équivalent :
 DESCRIPTION
 =======================
 
-Le lecteur de news **flnews** est suffisant pour l'accès au Usenet, c'est à
-dire pour lire les articles et pour les rédiger et les envoyer aux newsgroups
+Le lecteur de news **flnews** est suffisant pour l'accès au Usenet, c'est-à-dire
+pour lire les articles et pour les rédiger et les envoyer aux newsgroups
 de votre choix.
 
-Quand vous comparez les clients pour les news, vous allez toujours identifier
-le logiciel qui correspond à vos attentes et vos habitudes. Flnews, comme un
-logiciel basique, vous offre la possibilité d'influencer comment il fonctionne
-et aussi de manipuler directement les articles qu'il produit, juste avant qu'ils
-soient envoyés au serveur nntp.
+Lorsque vous comparez les clients pour les news, vous identifierez toujours celui
+qui correspond à vos attentes et habitudes. Flnews, en tant que logiciel simple,
+vous permet de modifier son fonctionnement et de manipuler directement les articles
+qu'il génère, juste avant qu'ils ne soient envoyés au serveur NNTP.
 
 Ce post-traitement peut servir à ajouter et à modifier des détails du message
-d'une manière qui n'est actuellement pas possible avec seulement flnews.  Comme
+d'une manière qui n'est actuellement pas possible avec seulement flnews. Comme
 le logiciel est configurable, il peut probablement répondre aux besoins de
 quelques utilisateurs du Usenet. Quand même, vous devez le comprendre comme un
 exemple pour ce qui est possible et pour inspiration, afin de créer vos propres
 solutions.
 
+-----------------------------------------------------------------------------
 Les limites d'un lecteur basique de news – ce qui peut faire flnews_post_proc
 -----------------------------------------------------------------------------
 
-Bien que les articles qui sont créés avec flnews sont complets et prêt pour
-l'envoi, certains utilisateurs ne seront pas toujours d'accord avec le résultat
-et ce pour des raisons arbitraires :  
+Bien que les articles créés avec flnews soient complets et prêts pour l'envoi,
+certains utilisateurs ne seront pas toujours satisfaits du résultat, et ce, pour
+des raisons parfois arbitraires :  
 
-* Il peut y avoir des inconvénients quand vous communiquez dans de groupes
-  diverses en plusieurs langues. La ligne d'introduction qui fait référence à
-  un article précédent, ne peut être configurée qu'une seule fois pour flnews.
+* Il peut y avoir des inconvénients lorsque vous communiquez dans des groupes
+  variés et en plusieurs langues. La ligne d'introduction faisant référence à
+  un article précédent ne peut être configurée qu'une seule fois dans flnews.
   La conséquence peut être une introduction en Anglais quand vous postez dans
   un groupe français.
 
-  Avec mon logiciel de post-traitement vous pouvez imposer des introductions
-  spécifiques, à chaque fois pour une ou plusieurs newsgroups.
+  Avec ce logiciel de post-traitement, vous pouvez définir des introductions
+  spécifiques, à chaque fois pour un ou plusieurs newsgroups.
 
 * Le même conflit se produit quand vous avez défini une signature mais voudriez
   la remplacer contre une autre, selon le groupe dans lequel vous êtes en train
@@ -63,21 +62,21 @@ et ce pour des raisons arbitraires :
 
   flnews_post_proc peut faire exactement ça, quand vous avez configuré quel
   signature doit apparaître dans quel newsgroup ou liste de newsgroups. Le
-  logiciel peut même choisir par hazard une signature, si un fichier, qui en
+  logiciel peut même choisir par hasard une signature, si un fichier, qui en
   contient plusieurs, est noté dans la configuration.
 
 * Quelques entêtes supplémentaires peuvent servir à transmettre des informations
   aux lecteurs intéressés, comme l'ID de votre clé GnuPG, vos connaissances en
   langues ou pareil. Il se trouve que la signature est mieux pour ça, mais vous
   êtes libres. Je veux mentionner « face » et « x-face » mais préfère que vous
-  ne vous en souvenez pas.
+  ne vous en souveniez pas.
 
   Ces entêtes, – Custom-Headers – peuvent être définis dans la configuration
-  du logiciel et vont être utilisées dans chaque article sortant.
+  du logiciel et vont être utilisés dans chaque article sortant.
 
 * Les entêtes « Archive » et « X-No-Archive » sont parfois utilisés afin
-  d'éviter l'archivage d'un article. Il ne devrait par conséquence pas être
-  trouvé par les moteurs de recherche ( Google notamment ). Les articles dans
+  d'éviter l'archivage d'un article. Il ne devrait par conséquent pas être
+  trouvé par les moteurs de recherche (Google notamment). Les articles dans
   les groupes de test, par exemple, ne valent probablement pas qu'on les trouve
   parmi les résultats des recherches.
 
@@ -93,26 +92,29 @@ et ce pour des raisons arbitraires :
   S'ils sont nombreux, ces références peuvent déranger la lecture à cause de
   leur syntaxe spécifique.
 
-  Mon logiciel est capable d'identifier des fragments de text marqué – pas
-  seulement des références – et les transformer en notes en bas de page.  Vous
+  Mon logiciel est capable d'identifier des fragments de texte marqué – pas
+  seulement des références – et les transformer en notes en bas de page. Vous
   pouvez imaginer ça comme le fonctionnement de la balise <ref/> de Wikipedia,
   mais vous pouvez définir votre propre séparateur pour marquer les fragments
-  de text dans le fichier de configuration.
+  de texte dans le fichier de configuration.
 
-  Exemple ( avec séparateur **%=** ) :
+  Exemple (avec séparateur **%=** ) :
   « Ceci est un objet %=et ceci devient la note en bas de page, qui décrit
-  l'objet plus précisement=% » 
+  l'objet plus précisément=% »
 
 Dialogue pour désactiver des options
 ------------------------------------
+ATTN! Depuis la version 1.72, YAD et Zenity ne sont plus utilisés pour le
+dialogue. 
+
 Juste avant d'entrer en action, flnews_post_proc peut afficher un dialogue, qui
 vous laisse **désactiver** des options fixées dans la configuration. Sous
-condition qu'un des outils YAD, Zenity, Whiptail ou seulement xterm est
-disponible, vous pouvez choisir dans les options suivantes, ceux que vous
-voulez ignorer pour l'article en préparation. Vous **ne pouvez pas** activer
-des options, qui ne l'ont pas été auparavant :
+condition que Whiptail ou seulement xterm soit disponible, vous pouvez choisir
+dans les options suivantes, ceux que vous voulez ignorer pour l'article en
+préparation. 
+Vous **ne pouvez pas** activer des options qui n'ont pas été activées au préalable :
 
-* Signatures, comme définis dans la configuration **peuvent être ignorées**.
+* Signatures, comme définies dans la configuration **peuvent être ignorées**.
   Soit une signature par défaut sera appliquée, si prévue, ou aucune.
 
 * Entêtes supplémentaires, si définis, peuvent rester absentes de l'article.
@@ -120,45 +122,45 @@ des options, qui ne l'ont pas été auparavant :
 * Les entêtes Archive et X-No-Archive, si prévus pour le newsgroup choisi,
   peuvent être ignorés.
 
-* L'auto correction de URLs et références à d'autres articles peut être
-  désactivé. 
+* L'auto-correction de URLs et références à d'autres articles peut être
+  désactivée. 
 
 * L'écriture d'un protocole peut être arrêtée.  
 
 En tapant Esc ou en poussant le bouton « Annuler » du dialogue, vous pouvez
-interrompre le processus, flnews ne vas pas envoyer l'article.
+interrompre le processus, flnews ne va pas envoyer l'article.
 
-Vous pouvez même désactiver le dialogue, ce qui assure que toutes les options
-configurées seront appliquées sans plus d'interaction ( à voir dessous : optoin
-OVERRIDE_CONFIG ).
+Vous pouvez même désactiver le dialogue, ce qui garantit que toutes les options
+configurées seront appliquées sans interaction supplémentaire (voir ci-dessous :
+option OVERRIDE_CONFIG).
 
 CONFIGURATION
 =============
 La première fois que vous exécutez le logiciel, une copie de la configuration
-par défaut sera écrit dans */home/[utilisateur]/.flnews_post_proc.conf* C'est
-ce fichier qui sera désormais utilisé. Si vous l'effacez, il sera recréé à la
+par défaut sera écrite dans */home/[utilisateur]/.flnews_post_proc.conf*.
+C'est ce fichier qui sera désormais utilisé. Si vous l'effacez, il sera recréé à la
 prochaine occasion, mais vos modifications seront perdues.
 
 Le fichier de configuration est en format YAML et plein d'explications. Les
-variables définis dans ce fichier peuvent être classées en deux catégories :
+variables définies dans ce fichier peuvent être classées en deux catégories :
 
-* Variables qui décrivent des valeurs déterminées par flnews. Ils peuvent être
-  utiilisées ou remplacées. Les composants importants sont normalement
-  spécifiés dans une « capture group ».
+* Variables qui décrivent des valeurs déterminées par flnews. Elles peuvent être
+  utilisées ou remplacées. Les composants importants sont normalement spécifiés
+  dans une « capture group ».
 
 * Variables qui définissent du nouveau contenu ou des changements dans le
   contenu.
 
 **FUP_NAME**
- Une « expression régulière » ( “regular expression” ) décrivant la chaîne de
- caractères qui contient le nom de l'auteur d'un article précédent, qu'on veut
- citer en partie.  Cet élément est reconnu dans l'article d'origine et peut
- être utilisé à la place de l'élément correspondant dans *GROUP_INTRO* ( à voir
- plus bas ). Le format de l'expression est celui de la classe Regexp dans Ruby.
- Veillez de masquer le backslash '\\' avec un autre, comme dans l'exemple.  Un
+ Une « expression régulière » (« regular expression ») décrivant la chaîne de
+ caractères contenant le nom de l'auteur d'un article précédent, que l'on souhaite
+ citer en partie. Cet élément est reconnu dans l'article d'origine et peut
+ être utilisé à la place de l'élément correspondant dans *GROUP_INTRO* (voir
+ plus bas). Le format de l'expression est celui de la classe Regexp dans Ruby.
+ Veillez à masquer le backslash '\\' avec un autre, comme dans l'exemple. Un
  « capture group » '()' sert à extraire le nom du résultat de la comparaison.
- 
- Laissez ce champs vide afin de maintenir le comportement configuré pour flnews.
+
+ Laissez ce champ vide afin de maintenir le comportement configuré pour flnews.
 
  CONTENU    : L'équivalent d'une regular expression en chaîne de caractères.
 
@@ -169,13 +171,13 @@ variables définis dans ce fichier peuvent être classées en deux catégories :
  EXEMPLE 2  : "**(.*)** wrote:"
 
 **FUP_GROUP**
- Une « expression régulière » ( “regular expression” ) décrivant la chaîne de
+ Une « expression régulière » (« regular expression ») décrivant la chaîne de
  caractères qui contient le newsgroup où a été publié l'article précédent à qui nous
  faisons référence dans un « followup ».
 
- Laissez ce champs vide afin d'ignorer le groupe précis.
+ Laissez ce champ vide afin d'ignorer le groupe précis.
 
- CONTENU    : l'équivalent d'une regular expression en chaîne de caractères.
+ CONTENU    : L'équivalent d'une regular expression en chaîne de caractères.
 
  PAR DÉFAUT : Vide
 
@@ -184,36 +186,40 @@ variables définis dans ce fichier peuvent être classées en deux catégories :
 **GROUP_INTROS**
  Des introductions qui font référence à l'auteur de l'article précédent que
  nous souhaitons citer. Si vous avez trouvé le newsgroup où l'article a été
- publié ( à voir : FUP_GROUP, ci-dessus ), et le nom de son auteur 
- ( FUP_NAME ), vous pouvez utiliser ces valeurs ici.
+ publié (voir : FUP_GROUP, ci-dessus), et le nom de son auteur
+ (FUP_NAME), vous pouvez utiliser ces valeurs ici.
 
- Jusqu'à prochaine ordre, seulement %fup_name% est %fup_group% sont reproduit
- dans l'introduction resultant.
+ Jusqu'à prochaine ordre, seulement %fup_name% et %fup_group% sont reproduits
+ dans l'introduction résultante.
 
  | CONTENU    : Un newsgroup ou regexp par ligne, suivi de deux points, un espace et
  |              une chaîne de caractères.
 
  PAR DÉFAUT : Comme configuré dans flnews.
  
- | EXEMPLE ( un groupe et une hiérarchie )   : 
- |   alt.test: "Thus spoke %fup_name% in %fup_group%"   
- |   fr\\.*: "C'était dans %fup_group%, que %fup_name% c'est exprimé ainsi"
+ | EXEMPLE (un groupe et une hiérarchie) : 
+ |   alt.test: "Thus spoke %fup_name%:"
+ |   fr.soc:  "%fup_name% dans %fup_group% écrit:"
 
 **GROUP_SIGS**
  Une signature par newsgroup ou expression ou le chemin d'accès d'un fichier,
- contenant plusieurs signatures, séparé par une ligne vide.
-
- ATTN! Vous devez noter \\r\\n pour les sautes de lignes, si une signature
- s'étend sur plusieurs lignes. 
-
- CONTENU : un newsgroup ou expression par ligne, suivi de deux poins, un espace
- et une chaîne de caractères.
+ contenant plusieurs signatures, séparé par une ligne vide. Vous pouvez inclure
+ (“source”) le contenu d'autres fichiers dans la liste des signatures, en
+ indiquant dans le fichier d'origine le nom de l'autre fichier après un point
+ et un espace, comme dans: 
+ . /home/user/.plus_de_signatures
+ Ceci ne fonctionne que dans le fichier indiqué dans la configuration, pas dans
+ les fichiers inclus. Prenez soin d'insérer une ligne vide entre chaque ligne
+ qui inclut un fichier et la suivante.
+
+ | CONTENU : un newsgroup ou expression par ligne, suivi de deux poins, un espace
+ | et une chaîne de caractères.
 
  PAR DÉFAUT : Comme configuré dans flnews.
 
- EXEMPLE : fr.test: "Signature pour alt.test\\r\\nseconde ligne"
+ | EXEMPLE : fr.test: "Signature pour alt.test\\r\\nseconde ligne"
 
- EXEMPLE : alt.fr.test: /home/[utilisateur]/.signatures
+ | EXEMPLE : alt.fr.test: /home/[utilisateur]/.signatures
 
 **CUSTOM_HEADERS**
  Entêtes supplémentaires pour l'article sortant.
@@ -225,8 +231,8 @@ variables définis dans ce fichier peuvent être classées en deux catégories :
  PAR DÉFAUT : Vide ( pas défini )
 
  | EXEMPLE ( 2 entêtes ) : 
- | - 'X-My-Header: nothing fancy'
- | - 'X-Another-Header: care not!' 
+ |    - 'X-My-Header: nothing fancy'
+ |    - 'X-Another-Header: care not!' 
 
 **NO_ARCHIVE_GROUPS**
  Les newsgroups, où les entêtes « Archive: no » et « X-No-Archive: yes »
@@ -238,9 +244,8 @@ variables définis dans ce fichier peuvent être classées en deux catégories :
  PAR DÉFAUT : Vide
 
  | EXEMPLE ( 1 groupe, 1 hiérarchie ) : 
- | - "alt.test"
- | - "^news.*"
-
+ |     - "alt.test"
+ |     - "^news.*"
 
 **DEBUG_LOG**
  Le nom d'un fichier, qui va servir comme protocol. Si le nom d'un fichier
@@ -248,8 +253,8 @@ variables définis dans ce fichier peuvent être classées en deux catégories :
  protocol.
 
  | CONTENU : Le nom d'un fichier dont les droits permettent l'écriture.
- |     Il sera créé s'il n'existe pas encore et remplacé à chaque exécution 
- |     du logiciel.
+ |    Il sera créé s'il n'existe pas encore et remplacé à chaque exécution 
+ |    du logiciel.
 
  PAR DÉFAUT : Vide
 
@@ -259,7 +264,7 @@ variables définis dans ce fichier peuvent être classées en deux catégories :
  Un de debug, fatal, error, info, warn
 
  | EXEMPLE : 
- |     LOG_LEVEL: 'debug'
+ |    LOG_LEVEL: 'debug'
 
 **REFERENCES_SEPARATOR**
  Un symbole ou une séquence de symboles qui marquent la fin du corps du message
@@ -301,10 +306,10 @@ variables définis dans ce fichier peuvent être classées en deux catégories :
 
  EXEMPLE : "(%s)" -> devient (1) ... (2) ... (3)
 
-**VFY_URLS**  
+**VFY_URLS**
  Une constante booléen. Elle détermine si le programme doit essayer de corriger
  des URLs. Même si les URLs sont identifiables, seulement quelques manipulations
- sont temptées :
+ sont tentées :
 
  * '<' et '>' sont ajoutés, si manquants
  * Des slashes sont insérés, s'ils manquent après "http(s):"
@@ -314,7 +319,7 @@ variables définis dans ce fichier peuvent être classées en deux catégories :
 
  Si la variable n'est pas défini, la valeur 'yes' est présumée.
 
- CONTENU: Un de YES, yes, NO, no, et autres tels variations 
+ CONTENU: Un de YES, yes, NO, no, et autres telles variations 
 
  PAR DÉFAUT: yes
 
@@ -339,6 +344,7 @@ variables définis dans ce fichier peuvent être classées en deux catégories :
 Autres Informations
 ===================
 
+------
 Tester
 ------
 L'effet qu'aura l'exécution du programme peut être vérifié de deux manières :
@@ -350,7 +356,7 @@ L'effet qu'aura l'exécution du programme peut être vérifié de deux manières
    Ceci va vous présenter la nouvelle version de l'article sur l'écran, mais 
    vous pouvez aussi diriger le résultat dans un autre fichier. C'est une 
    excellente technique pour tester un logiciel pendant le développement ou
-   votre configuration avant que vous vous en servez.
+   votre configuration avant que vous vous en serviez.
 
 2. En envoyant un message directement dans un groupe de test ( comme alt.test,
    fr.test ou similaires ). 
@@ -383,4 +389,3 @@ Auteur
 | Michael Uplawski <michael.uplawski@uplawski.eu>
 
 Ω
-==