tuteurs.ens.fr/internet/forum/flrn.tml
Blaise Li ab7ebdfa7a Ajout d'un tutoriel tout-en-un en pdf pour forum.
Le tutoriel est en pdf dans docs/, il explique non seulement les bases de la
lecture de forum avec flrn mais aussi comment se connecter et se déconnecter de
clipper.
2010-11-23 11:58:49 +01:00

400 lines
13 KiB
XML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//ENS/Tuteurs//DTD TML 1//EN"
"tuteurs://DTD/tml.dtd">
<html>
<head>
<title>Flrn</title>
</head>
<body>
<h1>Forum avec Flrn</h1>
<p>
Flrn (<i lang="en">Forum Like Newsreader</i>) est un lecteur de news
écrit par deux archicubes, Damien Massé et Joël-Yann Fourré,
spécialement pour la lecture de <a href="../">forum</a>, les news
internes de l'ENS. Il peut bien évidemment être également utilisé pour
lire les news extérieures, comme Usenet.
</p>
<p>
Pour aller plus loin que ce tutorial pour débutants, vous pouvez lire
la <a href="&url.tuteurs;faq/flrn.html">FAQ des tuteurs sur flrn</a>.
Si au contraire vous êtes tellement débutant(e) que vous bloquez dès la
première instruction du tutoriel ci-dessous, vous pouvez essayer le
tutoriel tout-en-un dont le pdf est téléchargeable
<a href="&url.tuteurs;docs/Forum_pour_les_nuls.pdf">ici</a>.
</p>
<p> Si vous êtes complètement perdu et/ou que vous devez poster un
message de manière urgente, lisez directement le <a href="#bref">En
Bref</a>. Mais ne vous laissez pas impressionner par le tutorial, il
est très simple...
</p>
<h2>Lancer forum</h2>
<p>
Pour l'utiliser, c'est très simple. Dans un <a
href="&url.jargon;#xterm">terminal</a>, tapez simplement :
</p>
<pre>
<span class="prompt">clipper ~ $ </span> forum
</pre>
<p>
Vous pouvez également cliquer sur l'icône « Forum ».
</p>
<p>
Apparaîtra alors un écran de ce type (bien sûr, les couleurs choisies
dépendent de votre configuration) :
</p>
<div class="illustration"><img src="snap_aide.png" alt="[forum dans un
xterm]"/></div>
<p>
En haut à gauche, on trouve le nom du groupe (en l'espèce,
<code>aide</code>, le groupe consacré à l'aide sur l'utilisation de
forum et de flrn). À droite, le numéro du message où vous vous
trouvez, ainsi que le numéro du dernier message du groupe. Ici, nous
sommes au message n°1 (qui contient traditionnellement une
mini-charte), et on voit que, lorsque cette capture d'écran a été
faite, il y avait 1596 messages en tout dans ce groupe. En-dessous se
trouve le message, divisé en deux parties :
</p>
<ul>
<li> en haut les <em>entêtes</em> (ou <em>headers</em> en anglais) du
message, donnant son auteur, la date où il a été posté et d'autres
renseignements. À droite de ces entêtes se trouve une description
schématique de la discussion en cours (l'<a
href="../news.html#thread">enfilade</a> ou <em>thread</em> en jargon
des news). Sa compréhension n'est pas immédiatement nécessaire et
demande un certain entraînement.</li>
<li> en dessous, le <em>corps</em> du message.</li>
</ul>
<p>
Pour quitter forum, appuyez (au besoin plusieurs fois) sur la touche
<code>q</code>.
</p>
<div class="attention">
<p>
&icone.attention; Ne quittez pas forum en détruisant la fenêtre dans
laquelle le programme est lancé : les messages que vous avez lus ne seront
pas marqués comme tels, et vous devrez les relire plusieurs fois.
</p>
</div>
<h2><a name="lecture">Lecture de forum</a></h2>
<p>
Pour lire forum, c'est très simple. Pour faire défiler le message puis
pour passer au message suivant, appuyez sur la barre d'espace.
</p>
<p>
La lecture se fait dans l'ordre des discussions. Lorsque tous les
messages du groupe ont été lu, un autre appui sur la barre d'espace
permet d'aller au prochain groupe (auquel vous êtes abonné) où se
trouvent des messages non lus. Enfin, lorsqu'il n'y a plus rien à
lire, il suffit de taper <code>q</code> pour quitter.
</p>
<h2><a name="poster">Poster dans forum</a></h2>
<p>
Poster dans forum est très facile. Il est néanmoins conseillé de faire
ses premiers essais dans le groupe <code>essais</code> prévu pour ça.
</p>
<h3>Commencer une nouvelle discussion</h3>
<p>
Si vous voulez commencer une nouvelle discussion, utilisez la touche
<code>m</code> dans le groupe où vous désirez poster.
</p>
<p>Flrn vous demandera alors le sujet de votre message. Finissez la
ligne du sujet en appuyant sur <code>Enter</code>. Vous arriverez
alors dans votre éditeur favori. Par défaut, pour la config
conscrits, c'est <code>pico</code>.
</p>
<p>
En haut se trouveront deux lignes d'entêtes de titre <em>Groupes</em>
et <em>Sujet</em>. Vous pouvez modifier le sujet de votre message si à
la réflexion il ne vous convient pas.
</p>
<div class="illustration"><img src="snap_post.png" alt="[message de
forum dans pico]" /></div>
<p>
&icone.attention; Laissez toujours une ligne vide entre la fin de vos
entêtes et le corps de votre message, faute de quoi forum pourra faire
des erreurs et inclure comme entête ce qui ne l'est pas.
</p>
<p>
Une fois votre message écrit, sauvez-le et quittez l'éditeur (dans
pico, <code>Ctrl-O</code> puis <code>Ctrl-X</code>). Flrn vous laisse
alors une seconde chance :
</p>
<pre>
(P)oster, (E)diter, (A)nnuler ?
</pre>
<p class="continue">
Vous pouz donc taper <code>p</code> pour poster, <code>e</code> pour
revenir à l'édition du message avec votre éditeur habituel, ou
<code>a</code> pour annuler votre message si vous penez qu'en fait ça
n'est pas utile.
</p>
<h3>Répondre à un message existant</h3>
<p>
Vous devez utiliser la touche <code>R</code> (comme <em>Reply</em>)
pour répondre au message courant. Ce message doit être dans le groupe
que vous lisez actuellement pour que vous puissiez y répondre. La
démarche est la même qu'au-dessus, mais cette fois forum ne vous
demandera pas de sujet. Bien sûr, vous pourrez toujours modifier le
titre vous-même une fois que votre éditeur sera lancé.
</p>
<div class="encadre">
<p>
Certains messages, placés dans un groupe, ont une mention qui indique que
les réponses doivent être postés dans un autre groupe (il s'agit de l'entête
<em>Followup-To</em>). Dans ce cas, forum vous demandera si vous désirez
suivre cette indication. En règle générale, dites « oui ».
</p>
<p>
Il peut arriver aussi que cette mention demande que la réponse au
message soit faite par courrier électronique. forum vous demandera
alors si vous désirez répondre au message par courrier
électronique. La démarche est identique.
</p>
</div>
<div class="attention">
<p>
&icone.attention; Quand vous répondez à un message, <code>flrn</code>
ajoute en lançant l'éditeur l'ensemble du message auquel vous répondez
sous forme « quotée » (chaque ligne commence par un
<code>&gt;</code>). Ne gardez de ces « citations » que la partie
nécessaire à la compréhension de votre message, en effaçant les lignes
inutiles, par exemple dans <code>pico</code> par <code>Ctrl-K</code>.
</p>
<p>
Une réponse à un long message qui le reprend dans son intégralité et
rajoute simplement une ligne est inutile et particulièrement mal vue,
sur forum comme sur Usenet (où on vous accusera, selon l'expression
consacrée, de « quoter comme un goret »). D'autre part, la convention
veut que la réponse se place <strong>après</strong> le message cité et
non avant, pour des questions de lisibilité. Toutes les explications
sont fournies dans l'excellente FAQ « <a
href="http://www.usenet-fr.net/fur/usenet/repondre-sur-usenet.html">L'art
et la manière de répondre sur Usenet</a> ». Sa lecture est quasiment
indispensable.
</p>
</div>
<h2><a name="abon">Gérer les groupes</a></h2>
<p>
Être abonné à un groupe signifie que vous demandez à forum de lire les
messages de ce groupe. La touche <code>l</code> permet d'avoir la
liste des groupes auxquels vous êtes abonnés. Cette liste montre un
menu. Vous pouvez vous déplacer dans ce menu avec les flèches et
quitter ce menu avec la touche <code>q</code>. Pour chaque groupe,
vous pouvez demander à vous désabonner au groupe en tapant
<code>D</code>.
</p>
<p>
La touche <code>L</code> donne la liste de tous les groupes. Elle
présente successivement deux menus. Dans le premier (groupes auquels
vous êtes abonnés, ou dont vous avez déjà lus certains messages), vous
pouvez vous abonner ou vous désabonner à un groupe avec les touches
respectives <code>A</code> et <code>D</code>. Dans le second groupe,
vous ne pouvez que vous abonner à un groupe avec la touche
<code>A</code> (vous êtes par défaut désabonné à tous les groupes).
</p>
<p>
Vous pouvez restreindre la liste des groupes en donnant une
sous-chaîne du nom du groupe au moment où vous tapez la commande. Par
exemple, taper <code>L</code> suivi de <code>lettres</code> donnera
juste la liste des groupes dont le nom groupeent 'lettres'.
</p>
<p> Taper <code>A</code> ou <code>D</code> suivi d'<em>Enter</em> dans
un groupe vous <strong>abonne/désabonne</strong> au groupe courant. Y
ajouter un argument (par exemple <code>biologie</code>) permet de vous
abonner/désabonner au groupe dont le nom contient cet argument. S'il y
a ambiguité, forum vous proposera un menu, il vous suffira de choisir
le groupe par la touche <em>Enter</em>. </p>
<h2><a name="divers">Commandes utiles</a></h2>
<table class="tableau">
<tr>
<td> </td>
<td><code>?</code> ou <code>h</code></td>
<td>afficher un menu d'aide</td>
</tr>
<tr>
<th rowspan="3">Déplacement dans une discussion</th>
<td>Flèche gauche</td>
<td>Va au « père » du message</td>
</tr>
<tr>
<td>Flèche droite</td>
<td>Va sur un des « fils » du message (cf. arbre de la discussion)</td>
</tr>
<tr>
<td>Flèche haut/bas</td>
<td> Va sur un des « frères/cousins » du message (cf. arbre de la
discussion)</td>
</tr>
<tr>
<th rowspan="4">Déplacement dans un groupe</th>
<td><em>Enter</em></td>
<td>Va au message de numéro suivant</td>
</tr>
<tr>
<td><code>p</code></td>
<td>Va au message de numéro précédent</td>
</tr>
<tr>
<td>Un numéro <em>n</em></td>
<td>Va au message de numéro <em>n</em></td>
</tr>
<tr>
<td><code>r</code></td>
<td>Montre sous forme d'un menu les messages autour du message courant </td>
</tr>
<tr>
<th rowspan="3">Déplacement dans les<br/>derniers messages regardés</th>
<td><code>B</code></td>
<td>Va au précédent message regardé (recule dans l'historique)</td>
</tr>
<tr>
<td><code>F</code></td>
<td>Revient d'une touche <code>B</code> (avance dans l'historique)</td>
</tr>
<tr>
<td><code>H</code></td>
<td>Montre l'historique sous forme de menu</td>
</tr>
<tr>
<td align="center"><strong>Divers</strong></td>
<td><code>e</code></td>
<td>Efface le message courant (s'il est de vous)</td>
</tr>
</table>
<p>
La commande <code>r</code> peut prendre divers arguments. En
particulier :
</p>
<ul>
<li><code>r-</code> donne un menu de tous les messages du groupe.</li>
<li><code>r&lt;&gt;</code> donne un menu comportant les messages de
la discussion courante (mais il est préférable de taper, pour un
résultat mieux présenté, <code>\summ-thread</code>).</li>
</ul>
<p>
On peut se réferer à l'aide de <code>flrn</code> pour avoir une description
complète des commandes et de la façon des les utiliser.
</p>
<h2><a name="bref">En bref : mon premier post</a></h2>
<div class="attention">
Attention, ces instructions ne s'appliquent à vous que si vous
utilisez une config conscrit raisonnablement récente (en gros,
postérieure à 1998), qui utilise l'éditeur <code>pico</code>. Si votre
configuration est plus vieille, vous vous retrouverez face à l'éditeur
intégré de <code>flrn</code>...
</div>
<p>
Si vous êtes perdu et/ou pressé, suivez pas à pas ces instructions qui
vous permettront de poster très rapidement. Mais n'oubliez pas de lire
le reste du tutorial ensuite. Si vous êtes arrivé dans cette École, ce
n'est pas en suivant bêtement des instructions sans comprendre...
</p>
<p> Pour l'exemple, admettons que vous vouliez annoncer dans
<code>petites-annonces</code> la perte de votre écharpe à la
K-fêt.</p>
<ol>
<li> <strong>lancer forum</strong> (<code>forum</code> dans
une fenêtre)</li>
<li> <strong>aller dans le bon groupe</strong> : tapez
<code>G</code>. Vous voyez apparaître en bas de l'écran <code>(GOTO)
:</code>, tapez alors <code>petites-annonces</code>. Vous vous
retrouvez ensuite dans ce groupe.</li>
<li> <strong>poster</strong>. Appuyez sur <code>m</code> puis
<code>Enter</code>. Vous voyez apparaître deux lignes, l'une commence
par « Groupe » et l'autre par « Sujet ». Votre
curseur est après « Sujet ». Tapez le sujet de votre
message. Vous voyez apparaître des lignes comme
« Followup-To: », ou encore « X-Trace », ce sont des
« champs ». N'y touchez pas. Faites descendre votre curseur au
maximum (soit 1 ligne après le dernier champ). Écrivez votre
message. Quand vous avez fini, tapez <code>Ctrl-X</code>
puis <code>Y</code> et
<code>Enter</code>.</li>
<li> <strong>confirmer l'envoi du message</strong>. Vous vous trouvez
face à une ligne qui dit <code>(P)oster, (E)diter, (A)nnuler
?</code>. Tapez <code>P</code> pour « poster ».</li>
</ol>
<p>
Voilà, vous venez d'envoyer votre premier post sur
forum. N'oubliez pas que normalement, vous êtes censé faire vous
entraîner dans le groupe <code>essais</code> avant de poster dans des
groupes sérieux...
</p>
<h2><a name="configurer">Configurer flrn</a></h2>
<p>
La configuration de <code>flrn</code> est dans le fichier
<code>.flrnrc</code> sur votre compte. Les modifications pas trop
difficiles à faire sont mises en commentaire.
</p>
<p>
Un second fichier, le fichier <code>.flrnkill.forum</code>, est le
<em>kill-file</em> de <code>flrn</code>. Il peut être modifié pour
indiquer par exemple que vous ne pouvez plus lire les messages de
quelqu'un. On pourra lire l'aide de <code>flrn</code> pour de plus
amples renseignements.
</p>
<div class="metainformation">Auteurs : Damien Massé, Émilia
Robin, Nicolas George, Marie-Lan Nguyen. <date value="from git" /></div>
</body>
</html>