RubyGems - flnews_post_proc - Versions diffs - 1.7 - Mend

flnews_post_proc 1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (28) hide show

checksums.yaml +7 -0
data/README.md +381 -0
data/bin/flnews_post_proc +128 -0
data/doc/fr/html/flnews_post_proc.html +704 -0
data/doc/fr/man/flnews_post_proc.1.gz +0 -0
data/doc/fr/pdf/flnews_post_proc.pdf +0 -0
data/doc/fr/rst/flnews_post_proc.rst +380 -0
data/doc/html/flnews_post_proc.html +342 -0
data/doc/license.txt +13 -0
data/doc/man/flnews_post_proc.1.gz +0 -0
data/doc/pdf/flnews_post_proc.pdf +0 -0
data/doc/rst/flnews_post_proc.rst +336 -0
data/lib/_quoting_style_regexp +2 -0
data/lib/basic_logging.rb +202 -0
data/lib/body.rb +364 -0
data/lib/color_output.rb +65 -0
data/lib/configuration.rb +143 -0
data/lib/flnews_post_proc.conf +173 -0
data/lib/flnews_post_proc.rb +72 -0
data/lib/headers.rb +172 -0
data/lib/newsgroups.rb +152 -0
data/lib/override.rb +199 -0
data/lib/ruby_dlg +139 -0
data/lib/version.rb +22 -0
data/lib/whiptail_dlg +84 -0
data/lib/yad_dlg +53 -0
data/lib/zenity_dlg +60 -0
metadata +109 -0

data/doc/fr/html/flnews_post_proc.html ADDED Viewed

@@ -0,0 +1,704 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta name="generator" content="Docutils 0.20.1: https://docutils.sourceforge.io/" />
+<title>Flnews_post_proc</title>
+<style type="text/css">
+/*
+:Author: David Goodger (goodger@python.org)
+:Id: $Id: html4css1.css 8954 2022-01-20 10:10:25Z milde $
+:Copyright: This stylesheet has been placed in the public domain.
+Default cascading style sheet for the HTML output of Docutils.
+See https://docutils.sourceforge.io/docs/howto/html-stylesheets.html for how to
+customize this style sheet.
+*/
+/* used to remove borders from tables and images */
+.borderless, table.borderless td, table.borderless th {
+  border: 0 }
+table.borderless td, table.borderless th {
+  /* Override padding for "table.docutils td" with "! important".
+     The right padding separates the table cells. */
+  padding: 0 0.5em 0 0 ! important }
+.first {
+  /* Override more specific margin styles with "! important". */
+  margin-top: 0 ! important }
+.last, .with-subtitle {
+  margin-bottom: 0 ! important }
+.hidden {
+  display: none }
+.subscript {
+  vertical-align: sub;
+  font-size: smaller }
+.superscript {
+  vertical-align: super;
+  font-size: smaller }
+a.toc-backref {
+  text-decoration: none ;
+  color: black }
+blockquote.epigraph {
+  margin: 2em 5em ; }
+dl.docutils dd {
+  margin-bottom: 0.5em }
+object[type="image/svg+xml"], object[type="application/x-shockwave-flash"] {
+  overflow: hidden;
+}
+/* Uncomment (and remove this text!) to get bold-faced definition list terms
+dl.docutils dt {
+  font-weight: bold }
+*/
+div.abstract {
+  margin: 2em 5em }
+div.abstract p.topic-title {
+  font-weight: bold ;
+  text-align: center }
+div.admonition, div.attention, div.caution, div.danger, div.error,
+div.hint, div.important, div.note, div.tip, div.warning {
+  margin: 2em ;
+  border: medium outset ;
+  padding: 1em }
+div.admonition p.admonition-title, div.hint p.admonition-title,
+div.important p.admonition-title, div.note p.admonition-title,
+div.tip p.admonition-title {
+  font-weight: bold ;
+  font-family: sans-serif }
+div.attention p.admonition-title, div.caution p.admonition-title,
+div.danger p.admonition-title, div.error p.admonition-title,
+div.warning p.admonition-title, .code .error {
+  color: red ;
+  font-weight: bold ;
+  font-family: sans-serif }
+/* Uncomment (and remove this text!) to get reduced vertical space in
+   compound paragraphs.
+div.compound .compound-first, div.compound .compound-middle {
+  margin-bottom: 0.5em }
+div.compound .compound-last, div.compound .compound-middle {
+  margin-top: 0.5em }
+*/
+div.dedication {
+  margin: 2em 5em ;
+  text-align: center ;
+  font-style: italic }
+div.dedication p.topic-title {
+  font-weight: bold ;
+  font-style: normal }
+div.figure {
+  margin-left: 2em ;
+  margin-right: 2em }
+div.footer, div.header {
+  clear: both;
+  font-size: smaller }
+div.line-block {
+  display: block ;
+  margin-top: 1em ;
+  margin-bottom: 1em }
+div.line-block div.line-block {
+  margin-top: 0 ;
+  margin-bottom: 0 ;
+  margin-left: 1.5em }
+div.sidebar {
+  margin: 0 0 0.5em 1em ;
+  border: medium outset ;
+  padding: 1em ;
+  background-color: #ffffee ;
+  width: 40% ;
+  float: right ;
+  clear: right }
+div.sidebar p.rubric {
+  font-family: sans-serif ;
+  font-size: medium }
+div.system-messages {
+  margin: 5em }
+div.system-messages h1 {
+  color: red }
+div.system-message {
+  border: medium outset ;
+  padding: 1em }
+div.system-message p.system-message-title {
+  color: red ;
+  font-weight: bold }
+div.topic {
+  margin: 2em }
+h1.section-subtitle, h2.section-subtitle, h3.section-subtitle,
+h4.section-subtitle, h5.section-subtitle, h6.section-subtitle {
+  margin-top: 0.4em }
+h1.title {
+  text-align: center }
+h2.subtitle {
+  text-align: center }
+hr.docutils {
+  width: 75% }
+img.align-left, .figure.align-left, object.align-left, table.align-left {
+  clear: left ;
+  float: left ;
+  margin-right: 1em }
+img.align-right, .figure.align-right, object.align-right, table.align-right {
+  clear: right ;
+  float: right ;
+  margin-left: 1em }
+img.align-center, .figure.align-center, object.align-center {
+  display: block;
+  margin-left: auto;
+  margin-right: auto;
+}
+table.align-center {
+  margin-left: auto;
+  margin-right: auto;
+}
+.align-left {
+  text-align: left }
+.align-center {
+  clear: both ;
+  text-align: center }
+.align-right {
+  text-align: right }
+/* reset inner alignment in figures */
+div.align-right {
+  text-align: inherit }
+/* div.align-center * { */
+/*   text-align: left } */
+.align-top    {
+  vertical-align: top }
+.align-middle {
+  vertical-align: middle }
+.align-bottom {
+  vertical-align: bottom }
+ol.simple, ul.simple {
+  margin-bottom: 1em }
+ol.arabic {
+  list-style: decimal }
+ol.loweralpha {
+  list-style: lower-alpha }
+ol.upperalpha {
+  list-style: upper-alpha }
+ol.lowerroman {
+  list-style: lower-roman }
+ol.upperroman {
+  list-style: upper-roman }
+p.attribution {
+  text-align: right ;
+  margin-left: 50% }
+p.caption {
+  font-style: italic }
+p.credits {
+  font-style: italic ;
+  font-size: smaller }
+p.label {
+  white-space: nowrap }
+p.rubric {
+  font-weight: bold ;
+  font-size: larger ;
+  color: maroon ;
+  text-align: center }
+p.sidebar-title {
+  font-family: sans-serif ;
+  font-weight: bold ;
+  font-size: larger }
+p.sidebar-subtitle {
+  font-family: sans-serif ;
+  font-weight: bold }
+p.topic-title {
+  font-weight: bold }
+pre.address {
+  margin-bottom: 0 ;
+  margin-top: 0 ;
+  font: inherit }
+pre.literal-block, pre.doctest-block, pre.math, pre.code {
+  margin-left: 2em ;
+  margin-right: 2em }
+pre.code .ln { color: grey; } /* line numbers */
+pre.code, code { background-color: #eeeeee }
+pre.code .comment, code .comment { color: #5C6576 }
+pre.code .keyword, code .keyword { color: #3B0D06; font-weight: bold }
+pre.code .literal.string, code .literal.string { color: #0C5404 }
+pre.code .name.builtin, code .name.builtin { color: #352B84 }
+pre.code .deleted, code .deleted { background-color: #DEB0A1}
+pre.code .inserted, code .inserted { background-color: #A3D289}
+span.classifier {
+  font-family: sans-serif ;
+  font-style: oblique }
+span.classifier-delimiter {
+  font-family: sans-serif ;
+  font-weight: bold }
+span.interpreted {
+  font-family: sans-serif }
+span.option {
+  white-space: nowrap }
+span.pre {
+  white-space: pre }
+span.problematic {
+  color: red }
+span.section-subtitle {
+  /* font-size relative to parent (h1..h6 element) */
+  font-size: 80% }
+table.citation {
+  border-left: solid 1px gray;
+  margin-left: 1px }
+table.docinfo {
+  margin: 2em 4em }
+table.docutils {
+  margin-top: 0.5em ;
+  margin-bottom: 0.5em }
+table.footnote {
+  border-left: solid 1px black;
+  margin-left: 1px }
+table.docutils td, table.docutils th,
+table.docinfo td, table.docinfo th {
+  padding-left: 0.5em ;
+  padding-right: 0.5em ;
+  vertical-align: top }
+table.docutils th.field-name, table.docinfo th.docinfo-name {
+  font-weight: bold ;
+  text-align: left ;
+  white-space: nowrap ;
+  padding-left: 0 }
+/* "booktabs" style (no vertical lines) */
+table.docutils.booktabs {
+  border: 0px;
+  border-top: 2px solid;
+  border-bottom: 2px solid;
+  border-collapse: collapse;
+}
+table.docutils.booktabs * {
+  border: 0px;
+}
+table.docutils.booktabs th {
+  border-bottom: thin solid;
+  text-align: left;
+}
+h1 tt.docutils, h2 tt.docutils, h3 tt.docutils,
+h4 tt.docutils, h5 tt.docutils, h6 tt.docutils {
+  font-size: 100% }
+ul.auto-toc {
+  list-style-type: none }
+</style>
+</head>
+<body>
+<div class="document" id="flnews-post-proc">
+<h1 class="title">flnews_post_proc</h1>
+<h2 class="subtitle" id="post-traitement-pour-flnews">Post-Traitement pour flnews</h2>
+<div class="section" id="synopsis">
+<h1>SYNOPSIS</h1>
+<p>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 <em>flnews_post_proc</em>.</p>
+<p>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 :</p>
+<blockquote>
+<strong>flnews_post_proc &lt; article.txt</strong></blockquote>
+<p>ou si vous préférez l'équivalent :</p>
+<blockquote>
+<strong>cat article.txt | flnews_post_proc</strong></blockquote>
+</div>
+<div class="section" id="description">
+<h1>DESCRIPTION</h1>
+<p>Le lecteur de news <strong>flnews</strong> 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.</p>
+<p>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.</p>
+<p>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
+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.</p>
+<div class="section" id="les-limites-d-un-lecteur-basique-de-news-ce-qui-peut-faire-flnews-post-proc">
+<h2>Les limites d'un lecteur basique de news – ce qui peut faire flnews_post_proc</h2>
+<p>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 :</p>
+<ul>
+<li><p class="first">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.
+La conséquence peut être une introduction en Anglais quand vous postez dans
+un groupe français.</p>
+<p>Avec mon logiciel de post-traitement vous pouvez imposer des introductions
+spécifiques, à chaque fois pour une ou plusieurs newsgroups.</p>
+</li>
+<li><p class="first">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
+de poster.</p>
+<p>flnews_post_proc peut faire exactement ça, quand vous avez configuré quel
+signature doit apparaître dans quel newsgroup ou liste de newsgroups.</p>
+</li>
+<li><p class="first">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.</p>
+<p>Ces entêtes, – Custom-Headers – peuvent être définis dans la configuration
+du logiciel et vont être utilisées dans chaque article sortant.</p>
+</li>
+<li><p class="first">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
+les groupes de test, par exemple, ne valent probablement pas qu'on les trouve
+parmi les résultats des recherches.</p>
+<p>Avec flnews_post_proc vous pouvez décider et imposer que vos articles dans
+certains newsgroups contiendront d'office les deux entêtes <strong>Archive: no</strong> et
+<strong>X-No-Archive: Yes</strong>.</p>
+<p><strong>ATTENTION</strong>: Dès 2024, l'entête « X-No-Archive » a perdu beaucoup de son
+utilité. Les opérateurs des serveurs peuvent décider s'ils veulent le prendre
+en considération ou non.</p>
+</li>
+<li><p class="first">Certains messages mentionnent d'autres articles ou des URLs de pages Web.
+S'ils sont nombreux, ces références peuvent déranger la lecture à cause de
+leur syntaxe spécifique.</p>
+<p>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
+pouvez imaginer ça comme le fonctionnement de la balise &lt;ref/&gt; de Wikipedia,
+mais vous pouvez définir votre propre séparateur pour marquer les fragments
+de text dans le fichier de configuration.</p>
+<p>Exemple ( avec séparateur <strong>%=</strong> ) :
+« Ceci est un objet %=et ceci devient la note en bas de page, qui décrit
+l'objet plus précisement=% »</p>
+</li>
+</ul>
+</div>
+<div class="section" id="dialogue-pour-desactiver-des-options">
+<h2>Dialogue pour désactiver des options</h2>
+<p>Juste avant d'entrer en action, flnews_post_proc peut afficher un dialogue, qui
+vous laisse <strong>désactiver</strong> 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 <strong>ne pouvez pas</strong> activer
+des options, qui ne l'ont pas été auparavant :</p>
+<ul class="simple">
+<li>Signatures, comme définis dans la configuration <strong>peuvent être ignorées</strong>.
+Soit une signature par défaut sera appliquée, si prévue, ou aucune.</li>
+<li>Entêtes supplémentaires, si définis, peuvent rester absentes de l'article.</li>
+<li>Les entêtes Archive et X-No-Archive, si prévus pour le newsgroup choisi,
+peuvent être ignorés.</li>
+<li>L'auto correction de URLs et références à d'autres articles peut être
+désactivé.</li>
+<li>L'écriture d'un protocole peut être arrêtée.</li>
+</ul>
+<p>En tapant Esc ou en poussant le bouton « Annuler » du dialogue, vous pouvez
+interrompre le processus, flnews ne vas pas envoyer l'article.</p>
+<p>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 ).</p>
+</div>
+</div>
+<div class="section" id="configuration">
+<h1>CONFIGURATION</h1>
+<p>La première fois que vous exécutez le logiciel, une copie de la configuration
+par défaut sera écrit dans <em>/home/[utilisateur]/.flnews_post_proc.conf</em> C'est
+ce fichier qui sera désormais utilisé. Si vous l'effacez, il sera recréé à la
+prochaine occasion, mais vos modifications seront perdues.</p>
+<p>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 :</p>
+<ul class="simple">
+<li>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 ».</li>
+<li>Variables qui définissent du nouveau contenu ou des changements dans le
+contenu.</li>
+</ul>
+<dl class="docutils">
+<dt><strong>FUP_NAME</strong></dt>
+<dd><p class="first">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 <em>GROUP_INTRO</em> ( à 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
+« capture group » '()' sert à extraire le nom du résultat de la comparaison.</p>
+<p>Laissez ce champs vide afin de maintenir le comportement configuré pour flnews.</p>
+<p>CONTENU    : L'équivalent d'une regular expression en chaîne de caractères.</p>
+<p>PAR DÉFAUT : Vide</p>
+<p>EXEMPLE 1  : &quot;On \\d+.\\d+.\\d{2,4} at \\d+:\\d+ <strong>(.*)</strong> wrote:&quot;</p>
+<p class="last">EXEMPLE 2  : &quot;<strong>(.*)</strong> wrote:&quot;</p>
+</dd>
+<dt><strong>FUP_GROUP</strong></dt>
+<dd><p class="first">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 ».</p>
+<p>Laissez ce champs vide afin d'ignorer le groupe précis.</p>
+<p>CONTENU    : l'équivalent d'une regular expression en chaîne de caractères.</p>
+<p>PAR DÉFAUT : Vide</p>
+<p class="last">EXEMPLE    : &quot;wrote in <strong>(.*)</strong>:&quot;</p>
+</dd>
+<dt><strong>GROUP_INTROS</strong></dt>
+<dd><p class="first">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.</p>
+<p>Jusqu'à prochaine ordre, seulement %fup_name% est %fup_group% sont reproduit
+dans l'introduction resultant.</p>
+<div class="line-block">
+<div class="line">CONTENU    : Un newsgroup ou regexp par ligne, suivi de deux points, un espace et</div>
+<div class="line-block">
+<div class="line">une chaîne de caractères.</div>
+</div>
+</div>
+<p>PAR DÉFAUT : Comme configuré dans flnews.</p>
+<div class="last line-block">
+<div class="line">EXEMPLE ( un groupe et une hiérarchie )   :</div>
+<div class="line-block">
+<div class="line">alt.test: &quot;Thus spoke %fup_name% in %fup_group%&quot;</div>
+<div class="line">fr\.*: &quot;C'était dans %fup_group%, que %fup_name% c'est exprimé ainsi&quot;</div>
+</div>
+</div>
+</dd>
+<dt><strong>GROUP_SIGS</strong></dt>
+<dd><p class="first">Une signature par newsgroup ou expression.
+ATTN! Vous devez noter \r\n pour les sautes de lignes, si une signature
+s'étend sur plusieurs lignes.</p>
+<p>CONTENU : un newsgroup ou expression par ligne, suivi de deux poins, un espace
+et une chaîne de caractères.</p>
+<p>PAR DÉFAUT : Comme configuré dans flnews.</p>
+<p class="last">EXEMPLE : fr.test: &quot;Signature pour alt.test\r\nseconde ligne&quot;</p>
+</dd>
+<dt><strong>CUSTOM_HEADERS</strong></dt>
+<dd><p class="first">Entêtes supplémentaires pour l'article sortant.</p>
+<p>CONTENU : 1 ligne par entête : un trait d'union, un espace, puis une chaîne de
+caractères comprenant le nom de l'entête, puis deux points et la valeur de
+l'entête.</p>
+<p>PAR DÉFAUT : Vide ( pas défini )</p>
+<div class="last line-block">
+<div class="line">EXEMPLE ( 2 entêtes ) :</div>
+<div class="line">- 'X-My-Header: nothing fancy'</div>
+<div class="line">- 'X-Another-Header: care not!'</div>
+</div>
+</dd>
+<dt><strong>NO_ARCHIVE_GROUPS</strong></dt>
+<dd><p class="first">Les newsgroups, où les entêtes « Archive: no » et « X-No-Archive: yes »
+doivent être présents.</p>
+<p>CONTENU : Un trait d'union et un espace, puis une chaîne de caractères,
+contenant le nom du groupe ou une expression.</p>
+<p>PAR DÉFAUT : Vide</p>
+<div class="last line-block">
+<div class="line">EXEMPLE ( 1 groupe, 1 hiérarchie ) :</div>
+<div class="line">- &quot;alt.test&quot;</div>
+<div class="line">- &quot;^news.*&quot;</div>
+</div>
+</dd>
+<dt><strong>DEBUG_LOG</strong></dt>
+<dd><p class="first">Le nom d'un fichier, qui va servir comme protocol. Si le nom d'un fichier
+valide est donné, le protocol est activé. Laissez vide pour désactiver le
+protocol.</p>
+<div class="line-block">
+<div class="line">CONTENU : Le nom d'un fichier dont les droits permettent l'écriture.</div>
+<div class="line-block">
+<div class="line">Il sera créé s'il n'existe pas encore et remplacé à chaque exécution</div>
+<div class="line">du logiciel.</div>
+</div>
+</div>
+<p>PAR DÉFAUT : Vide</p>
+<p class="last">EXEMPLE : '/tmp/a_log-file.txt'</p>
+</dd>
+<dt><strong>LOG LEVEL</strong></dt>
+<dd><p class="first">Un de debug, fatal, error, info, warn</p>
+<div class="last line-block">
+<div class="line">EXEMPLE :</div>
+<div class="line-block">
+<div class="line">LOG_LEVEL: 'debug'</div>
+</div>
+</div>
+</dd>
+<dt><strong>REFERENCES_SEPARATOR</strong></dt>
+<dd><p class="first">Un symbole ou une séquence de symboles qui marquent la fin du corps du message
+et le début d'une liste de « références » ou « notes de pied de page ». Il
+apparaîtra seulement, si  le message contient du text marqué pour servir comme
+note de pied de page.  À voir <em>REFERENCES_DELIMITER</em> ci-dessous.</p>
+<p>Si l'option n'est pas défini ou vide, la liste suit à la dernière ligne du
+corps du message, sans séparation supplémentaire.</p>
+<p>CONTENU    : Un symbol ou séquence de symboles entre guillemets &quot; &quot; ou ' '.</p>
+<p>PAR DÉFAUT : Vide</p>
+<p class="last">EXEMPLE    : '---------'</p>
+</dd>
+<dt><strong>REFERENCES_DELIMITER</strong></dt>
+<dd><p class="first">Une séquence d'au moins deux symboles qui marque le début  d'un text qui sera
+transformé en note de pied de page ( ou référence ). La <strong>séquence inversée</strong>
+doit marquer la fin du même fragment de text. La présence de cette séquence
+dans le message d'origine, a comme conséquence que le text marqué sera déplacé
+vers la fin, au-dessous du corps du message.
+Si <em>REFERENCES_SEPARATOR</em> ( option ci-dessus ) est défini, il va séparer le message
+de la liste des notes du pied de page.</p>
+<p>Laissez ce champs vide pour éviter la création des noted du pied de page.</p>
+<p>CONTENU : Une séquence de symboles entre guillemets ( '' )</p>
+<p>PAR DÉFAUT : Vide</p>
+<p class="last">EXEMPLE: '%?'</p>
+</dd>
+<dt><strong>REFERENCE_FORMAT</strong></dt>
+<dd><p class="first">Une chaîne de formatage, contenant %s pour représenter une nombre, qui
+remplace le texte d'une future note du pied de page dans le corps du message.</p>
+<p>PAR DÉFAUT : &quot; %s)&quot; -&gt; devient 1) ... 2) ... 3)</p>
+<p class="last">EXEMPLE : &quot;(%s)&quot; -&gt; devient (1) ... (2) ... (3)</p>
+</dd>
+<dt><strong>VFY_URLS</strong></dt>
+<dd><p class="first">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 :</p>
+<ul class="simple">
+<li>'&lt;' et '&gt;' sont ajoutés, si manquants</li>
+<li>Des slashes sont insérés, s'ils manquent après &quot;http(s):&quot;</li>
+</ul>
+<p>ATTN! Le programme ne peut pas différencier entre &quot;mailto:&quot; et &quot;news:&quot;. Si ni l'un
+ni l'autre est donné, mais '&#64;' est présent, &quot;news:&quot; est ajouté automatiquement.</p>
+<p>Si la variable n'est pas défini, la valeur 'yes' est présumée.</p>
+<p>CONTENU: Un de YES, yes, NO, no, et autres tels variations</p>
+<p>PAR DÉFAUT: yes</p>
+<p class="last">EXEMPLE: No</p>
+</dd>
+<dt><strong>OVERRIDE_CONFIG</strong></dt>
+<dd><p class="first">Une constante booléenne. Vous pouvez décider d'ignorer les options suivantes
+avant qu'un article est posté : GROUP_SIGS, XNAY_GROUPS, CUSTOM_HEADERS,
+VFY_URLS et DEBUG_LOG.  Un dialogue peut être affiché, qui permet la
+désactivation de chacune de ces options. Les valeurs par défaut, définis pour
+flnews, vont donc prévaloir.</p>
+<p>ATTN ! En poussant Esc ou le bouton « Annuler » du dialogue, vous interrompez
+le programme et flnews ne va rien envoyer.</p>
+<p>Notez la valeur 'no', 'NO' ou pareil pour désactiver le dialogue.</p>
+<p>PAR DÉFAUT : yes</p>
+<p class="last">EXEMPLE: No</p>
+</dd>
+</dl>
+</div>
+<div class="section" id="autres-informations">
+<h1>Autres Informations</h1>
+<div class="section" id="tester">
+<h2>Tester</h2>
+<p>L'effet qu'aura l'exécution du programme peut être vérifié de deux manières :</p>
+<ol class="arabic">
+<li><p class="first">En fournissant un article, sauvegardé auparavant dans un fichier :</p>
+<p><strong>:~$ /usr/local/bin/[post-processor] &lt; [test-article]</strong></p>
+<p>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.</p>
+</li>
+<li><p class="first">En envoyant un message directement dans un groupe de test ( comme alt.test,
+fr.test ou similaires ).
+Ceci est obligatoire avant que vous postez dans des groupes thématiques et
+si les réglages du post-traitement vont modifier l'article.</p>
+</li>
+</ol>
+</div>
+<div class="section" id="code-source">
+<h2>Code source</h2>
+<p>Le  fichier flnews_post_proc.gem, que vous recevez à l'aide de l'outil <em>gem</em> ou
+directement du site <em>rubygems.org</em>, contient tout le code source du logiciel et
+de la documentation ( cette page notamment ). Pour lire le code du logiciel,
+vous devez</p>
+<ol class="arabic simple">
+<li>utiliser <em>tar -xf flnews_post_proc-[version].gem</em></li>
+<li>décomprimer l'archive data.gz : <em>gunzip data.gz</em></li>
+<li>Extraire le contenu du fichier résultant « data.tar » :
+<em>tar -xf data.tar</em></li>
+</ol>
+<p>À la fin les répertoires bin, doc et lib seront créés.</p>
+</div>
+<div class="section" id="license">
+<h2>License</h2>
+<p>flnews_post_proc est distribué sous les conditions de la WTFPL-2.0 ou plus
+récent ( À voir <a class="reference external" href="http://www.wtfpl.net/txt/copying/">http://www.wtfpl.net/txt/copying/</a> ou license-text dans le
+répertoire « doc » de la gem ).</p>
+</div>
+<div class="section" id="auteur">
+<h2>Auteur</h2>
+<div class="line-block">
+<div class="line">flnews_post_proc a été développé par</div>
+<div class="line">Michael Uplawski &lt;<a class="reference external" href="mailto:michael.uplawski&#64;uplawski.eu">michael.uplawski&#64;uplawski.eu</a>&gt;</div>
+</div>
+</div>
+</div>
+<div class="section" id="section-1">
+<h1>Ω</h1>
+</div>
+</div>
+</body>
+</html>