normalize code a bit, delete unused comments for options, since it slowdown parse.
[platal.git] / templates / docs / doc_nntp.tpl
1 {**************************************************************************}
2 {*                                                                        *}
3 {*  Copyright (C) 2003-2004 Polytechnique.org                             *}
4 {*  http://opensource.polytechnique.org/                                  *}
5 {*                                                                        *}
6 {*  This program is free software; you can redistribute it and/or modify  *}
7 {*  it under the terms of the GNU General Public License as published by  *}
8 {*  the Free Software Foundation; either version 2 of the License, or     *}
9 {*  (at your option) any later version.                                   *}
10 {*                                                                        *}
11 {*  This program is distributed in the hope that it will be useful,       *}
12 {*  but WITHOUT ANY WARRANTY; without even the implied warranty of        *}
13 {*  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *}
14 {*  GNU General Public License for more details.                          *}
15 {*                                                                        *}
16 {*  You should have received a copy of the GNU General Public License     *}
17 {*  along with this program; if not, write to the Free Software           *}
18 {*  Foundation, Inc.,                                                     *}
19 {*  59 Temple Place, Suite 330, Boston, MA  02111-1307  USA               *}
20 {*                                                                        *}
21 {**************************************************************************}
22
23
24 <h1>Les forums de Polytechnique.org</h1>
25 <p>
26   Polytechnique.org propose un serveur de news (forums de discussion)
27   sécurisé <strong>ouvert à tous les inscrits</strong> qui ont
28   <strong><a href="{"acces_smtp.php"|url}">activé leur compte SMTP/NNTP</a></strong>.
29 </p>
30
31 <h2>A quoi sert le serveur de forums ?</h2>
32 <p>
33   Le serveur de forums te permet de consulter les forums de discussion de
34   Polytechnique.org depuis ton logiciel de courrier électronique (Outlook
35   Express, Netscape...).
36 </p>
37
38 <h2>Quel logiciel utiliser ?</h2>
39 <p>
40   Nous avons testé les logiciels capables de lire les forums de discussion les plus courants.  La colonne <strong>O</strong> indique les logiciels qui fonctionnent, la colonne <strong>N</strong> ceux qui ne fonctionnent pas.
41 </p>
42 <p>
43 <em>
44   <span class="smaller">
45     La colonne <strong>S</strong> s'adresse aux utilisateurs aguerris et indique la possibilité de
46     faire fonctionner le logiciel de news avec stunnel. La <a href="#stunnel">procédure</a> est
47     décrite plus bas.
48   </span>
49 </em>
50 </p>
51
52 <table class="bicol" summary="liste des clients" cellpadding="4">
53 <tr>
54   <th>Logiciel</th>
55   <th>O</th>
56   <th>N</th>
57   <th>S</th>
58 </tr>
59 <tr class="impair">
60   <td>Gnus</td><td>x</td><td>&nbsp;</td><td>&nbsp;</td>
61 </tr>
62 <tr class="pair">
63   <td>Gravity / SuperGravity</td><td>&nbsp;</td><td>&nbsp;</td><td>x</td>
64 </tr>
65 <tr class="impair">
66   <td>KNode</td><td>&nbsp;</td><td>&nbsp;</td><td>x</td>
67 </tr>
68 <tr class="pair">
69   <td>Lotus Notes 5/6</td><td>x</td><td>&nbsp;</td><td>&nbsp;</td>
70 </tr>
71 <tr class="impair">
72   <td>Microsoft Outlook Express 4.x/5.x/6.x</td><td>x</td><td>&nbsp;</td><td>&nbsp;</td>
73 </tr>
74 <tr class="pair">
75   <td>Mozilla 1.x</td><td>x</td><td>&nbsp;</td><td>&nbsp;</td>
76 </tr>
77 <tr class="impair">
78   <td>Netscape Communicator 4.x</td><td>x</td><td>&nbsp;</td><td>&nbsp;</td>
79 </tr>
80 <tr class="pair">
81   <td>Netscape 6.x/7.x</td><td>x</td><td>&nbsp;</td><td>&nbsp;</td>
82 </tr>
83 <tr class="impair">
84   <td>Opera 6.x</td><td>x</td><td>&nbsp;</td><td>&nbsp;</td>
85 </tr>
86 <tr class="pair">
87   <td>Pan</td><td>&nbsp;</td><td>&nbsp;</td><td>x</td>
88 </tr>
89 <tr class="impair">
90   <td>slrn</td><td>x</td><td>&nbsp;</td><td>x</td>
91 </tr>
92 <tr class="pair">
93   <td>sylpheed / sylpheed-claws</td><td>x</td><td>&nbsp;</td><td>&nbsp;</td>
94 </tr>
95 <tr class="impair">
96   <td>Xnews</td><td>&nbsp;</td><td>&nbsp;</td><td>x</td>
97 </tr>
98 </table>
99
100 <br />
101 <h2>Comment me connecter ?</h2>
102 <p>
103   Avant de configurer ton lecteur, il faut avoir accepté le certificat SSL de
104   Polytechnique.org. <em><a href="{"docs/doc_ssl.php"|url}">Comment faire ?</a></em>.
105 </p>
106 <p>
107   Pour te connecter, tu as besoin des param&egrave;tres suivants:
108 </p>
109 <ul>
110   <li><strong>Serveur</strong> : <code>ssl.polytechnique.org</code></li>
111   <li>Utiliser une connexion <strong>s&eacute;curis&eacute;e</strong> (SSL, port 563)</li>
112   <li>
113     Ce serveur demande &agrave; ce que tu t'identifies : utilise ton identifiant (prenom.nom) et le mot de passe que tu as choisi pour le service SMTP/NNTP.
114   </li>
115 </ul>
116 <p>
117   La configuration pas à pas, images à l'appui :
118 </p>
119 <ul>
120   <li><a href="{"docs/doc_oe.php?doc=nntp"|url}">Outlook Express</a></li>
121   <li><a href="{"docs/doc_nn.php?doc=nntp"|url}">Netscape</a></li>
122 </ul>
123
124 <h2><a id="stunnel">Utiliser stunnel</a></h2>
125 <p>
126   Certains logiciels de news sont capables de s'authentifier mais ne reconnaisent pas les connexions sécurisées de type SSL.  Il est possible de faire fonctionner ces logiciels à l'aide de <a href="http://www.stunnel.org/">stunnel</a> qui gère la couche sécurisée.
127 </p>
128 <table class="bicol" summary="conf stunnel">
129 <tr>
130   <th>
131     Pour les versions 3.x
132   </th>
133 </tr>
134 <tr>
135   <td>
136   <p>Tu peux <a href="http://www.stunnel.org/">télécharger</a>
137   stunnel et une fois celui-ci installé, taper la commande :<br />
138   <code>stunnel -c -d localhost:119 -r ssl.polytechnique.org:563</code></p>
139   </td>
140 </tr>
141 <tr>
142   <th>
143     Pour les versions 4.0x (GNU/linux)
144   </th>
145 </tr>
146 <tr>
147   <td>
148     Il suffit d'éditer stunnel.conf et d'y ajouter les lignes suivantes :
149 <pre>    # location of pid file
150     pid = /var/run/stunnel.pid
151     # user to run as
152     setuid = root
153     setgid = root
154     
155     # Use it for client mode
156     client = yes
157     
158     [nntps]
159     accept  = localhost:119
160     connect = ssl.polytechnique.org:563
161     TIMEOUTclose = 0</pre>
162     Ensuite, il suffit d'exécuter en tant que <em>root</em> la commande : <code>stunnel&nbsp;/etc/stunnel.conf</code>
163     <br /><br />
164     Il faut noter que la plupart des distributions utilisent stunnel, et ont créé un script de lancement
165     automatique de stunnel par : <code>/etc/init.d/stunnel&nbsp;start</code>
166   </td>
167 </tr>
168 <tr>
169   <th>
170     Pour les versions 4.0x (Windows)
171   </th>
172 </tr>
173 <tr>
174   <td>
175     Il suffit d'éditer stunnel.conf et d'y ajouter les lignes suivantes :
176     <pre>    # Use it for client mode
177     client = yes
178     
179     [nntps]
180     accept  = localhost:119
181     connect = ssl.polytechnique.org:563
182     TIMEOUTclose = 0</pre>
183     <br />
184     Si tu le souhaites, tu peux placer stunnel dans le groupe démarrage, 
185     il sera lancé automatiquement.
186   </td>
187 </tr>
188 </table>
189 <p>
190 Ceci met en place un "tunnel" entre ton port local 119 et le port de NNTP sécurisé de Polytechnique.org.
191 Il ne te reste alors plus qu'à indiquer à ton logiciel de forums que le serveur est "localhost" sur le port 119.
192 </p>
193
194 <h2>slrn (GNU/linux)</h2>
195 <p>
196   Le cas de slrn est particulier. Il est par défaut compilé sans le support du ssl, et on peut utiliser la méthode indiquée ci-dessus.
197 </p>
198 <p>
199         Mais il est aussi possible de compiler slrn avec le support du ssl, auquel
200         cas il suffit d'indiquer à slrn : <code>snews://ssl.polytechnique.org/</code> comme
201         serveur. Tout ceci est expliqué sur
202   <a href="http://slrn.sourceforge.net/docs/README.SSL">la documentation officielle</a> (en anglais).
203 </p>
204
205 <h2>Attention !</h2>
206 <p>
207   Les forums de discussion ne sont pas considérés comme un service prioritaire (contrairement aux adresses à vie) et donc pourra être interrompu pour de courtes périodes si nous ne pouvons pas faire autrement.
208 </p>
209
210 {* vim:set et sw=2 sts=2 sws=2: *}