cbbe543fce
Remplacement de toutes les phrases du style « Dernière modification le ... [par ...] » par <date value="from git" />, qui produit une phrase du genre à partir de l'historique du dépôt. Le « from git » n'a pas d'importance, c'est juste parce que la DTD de TML (que je préfère ne pas changer) exige un attribut value. Last-change: ignore this commit
396 lines
13 KiB
XML
396 lines
13 KiB
XML
<?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>.
|
||
</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>></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<></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>
|