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.
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 :
flnews_post_proc < article.txt
ou si vous préférez l'équivalent :
cat article.txt | flnews_post_proc
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.
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.
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 :
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.
Avec mon logiciel de post-traitement vous pouvez imposer des introductions spécifiques, à chaque fois pour une 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 de poster.
flnews_post_proc peut faire exactement ça, quand vous avez configuré quel signature doit apparaître dans quel newsgroup ou liste de newsgroups.
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.
Ces entêtes, – Custom-Headers – peuvent être définis dans la configuration du logiciel et vont être utilisées 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 les groupes de test, par exemple, ne valent probablement pas qu'on les trouve parmi les résultats des recherches.
Avec flnews_post_proc vous pouvez décider et imposer que vos articles dans certains newsgroups contiendront d'office les deux entêtes Archive: no et X-No-Archive: Yes.
ATTENTION: 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.
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.
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 <ref/> de Wikipedia, mais vous pouvez définir votre propre séparateur pour marquer les fragments de text dans le fichier de configuration.
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=% »
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 :
En tapant Esc ou en poussant le bouton « Annuler » du dialogue, vous pouvez interrompre le processus, flnews ne vas 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 ).
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 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 :
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 « capture group » '()' sert à extraire le nom du résultat de la comparaison.
Laissez ce champs vide afin de maintenir le comportement configuré pour flnews.
CONTENU : L'équivalent d'une regular expression en chaîne de caractères.
PAR DÉFAUT : Vide
EXEMPLE 1 : "On \\d+.\\d+.\\d{2,4} at \\d+:\\d+ (.*) wrote:"
EXEMPLE 2 : "(.*) wrote:"
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.
CONTENU : l'équivalent d'une regular expression en chaîne de caractères.
PAR DÉFAUT : Vide
EXEMPLE : "wrote in (.*):"
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.
Jusqu'à prochaine ordre, seulement %fup_name% est %fup_group% sont reproduit dans l'introduction resultant.
PAR DÉFAUT : Comme configuré dans flnews.
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.
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"
Entêtes supplémentaires pour l'article sortant.
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.
PAR DÉFAUT : Vide ( pas défini )
Les newsgroups, où les entêtes « Archive: no » et « X-No-Archive: yes » doivent être présents.
CONTENU : Un trait d'union et un espace, puis une chaîne de caractères, contenant le nom du groupe ou une expression.
PAR DÉFAUT : Vide
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.
PAR DÉFAUT : Vide
EXEMPLE : '/tmp/a_log-file.txt'
Un de debug, fatal, error, info, warn
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 REFERENCES_DELIMITER ci-dessous.
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.
CONTENU : Un symbol ou séquence de symboles entre guillemets " " ou ' '.
PAR DÉFAUT : Vide
EXEMPLE : '---------'
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 séquence inversée 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 REFERENCES_SEPARATOR ( option ci-dessus ) est défini, il va séparer le message de la liste des notes du pied de page.
Laissez ce champs vide pour éviter la création des noted du pied de page.
CONTENU : Une séquence de symboles entre guillemets ( '' )
PAR DÉFAUT : Vide
EXEMPLE: '%?'
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.
PAR DÉFAUT : " %s)" -> devient 1) ... 2) ... 3)
EXEMPLE : "(%s)" -> devient (1) ... (2) ... (3)
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 :
ATTN! Le programme ne peut pas différencier entre "mailto:" et "news:". Si ni l'un ni l'autre est donné, mais '@' est présent, "news:" est ajouté automatiquement.
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
PAR DÉFAUT: yes
EXEMPLE: No
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.
ATTN ! En poussant Esc ou le bouton « Annuler » du dialogue, vous interrompez le programme et flnews ne va rien envoyer.
Notez la valeur 'no', 'NO' ou pareil pour désactiver le dialogue.
PAR DÉFAUT : yes
EXEMPLE: No
L'effet qu'aura l'exécution du programme peut être vérifié de deux manières :
En fournissant un article, sauvegardé auparavant dans un fichier :
:~$ /usr/local/bin/[post-processor] < [test-article]
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.
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.
Le fichier flnews_post_proc.gem, que vous recevez à l'aide de l'outil gem ou directement du site rubygems.org, contient tout le code source du logiciel et de la documentation ( cette page notamment ). Pour lire le code du logiciel, vous devez
À la fin les répertoires bin, doc et lib seront créés.
flnews_post_proc est distribué sous les conditions de la WTFPL-2.0 ou plus récent ( À voir http://www.wtfpl.net/txt/copying/ ou license-text dans le répertoire « doc » de la gem ).