#include  "$(ROOT)/wmlinc/template.inc" section="docs-tech subselected" SECTION_NAME="Participation au site de Gulliver"
 
 
 
<stitle>
    Comment participer à l'édition du site de Gulliver.
</stitle>

<sstitle>
    Principe de fonctionnement du site.
</sstitle>

<p>
Le site fait partie de <A href="http://www.linux-france.org/">linux-france.org</A> (lfo), un site de documentations
 francophones touchant aux Logiciels Libres. http://gulliver.eu.org est un alias vers http://www.linux-france.org/lug/gulliver.
</p>
<p>
Le site est statique (html, sauf 2-3 pages), les pages <em>html</em> sont générées 
grâce à <A href="http://thewml.org">WML</A> à partir
de squelettes (templates) et du contenu de la page.
</p>
<p>
Le site est géré sous <em>cvs</em> sur <em>linux-france.org (lfo)</em>. 
Toutes les heures et 20 minutes,
le serveur de <em>linux-france (lfo)</em>
met à jour la partie publique en fonction du contenu du dépôt <em>cvs</em>.<br>
<!--
Voir <A href="http://www.linux-france.org/maint/authsync.log.html"> ici </A> pour la distribution actuelle des droits (Gulliver est
en fin de liste, et commence par lug/gulliver )<br>
Je le précise, il ne s'agit que d'un simple <em>rsync</em>. Pour la partie qui concerne le site de Gulliver,
 les fichiers <em>html</em> ne sont pas généré durant cette mise à jour, ils doivent être généré localement par chacun
 des participant au site.
<br>
-->
<br>
Pour de plus amples informations sur le fonctionnent de Linux-france.org il est conseillé de consulter ces pages :
<ul>
  <li><A href="http://www.linux-france.org/prj/lfoyer/doc/htm/premiers_pas.fr.htm">
  Premiers pas sur lfo</A>  </li>
  <li><A href="http://www.linux-france.org/prj/lfoyer/doc/htm/qui_fait_quoi.fr.htm">
  Qui fait quoi sur lfo</A>  </li>
  <li><A href="http://www.linux-france.org/prj/lfoyer/">
  Maintenance et évolution de www.linux-france.org </A>  </li>
  <li><A href="http://www.linux-france.org/prj/lfoyer/doc/htm/ssh.fr.htm">
  SSH sur lfo</A>  </li>
  <li><A href="http://www.linux-france.org/prj/lfoyer/doc/htm/cvs.fr.htm">
  Utiliser CVS sur lfo</A></li>
</ul>
</p>

<!--
<p>
pour les gens pressés voir directement le <a href="#resume">résumé</a>
</p>

<sstitle>
	Pré-requis.
</sstitle>

<ul>
	<li>
		Logiciels nécessaires:
		<ul>
		<li> ssh </li>
		<li> rsync </li>
		<li> WML (sur Debian: apt-get install wml. Voyez pour votre distribution ou
		 <A href="http://thewml.org">WML</A>) </li>
		<li> CVS</li>
		</ul>
	</li>
	<br>
	<li>
		Pour faire partie des mainteneurs du site de Gulliver, il faut avoir un compte sur <em>lfo</em>. 
		Vous pouvez en faire la demande
		à <A href="mailto:gulliver-ca@listes.gulliver.eu.org">gulliver-ca@listes.gulliver.eu.org</A>.
		<br>Il est aussi conseillé de s'abonner à cette liste, elle se rapporte au site de Gulliver. 
		<br>Après la création de votre compte sur lfo, il est conseillé de mettre en place un système 
	    de clés public/privée
		pour vous faciliter la tâche, vous pouvez le faire en suivant
		 <A href="http://www.linux-france.org/prj/lfoyer/doc/htm/ssh.fr.htm">ce document</A>.
	</li>
	<br>
	<li>
		Il vous faut aussi récupérer les squelettes <em>wml</em> du site:<br>
		
		<pre class="sh">
		cd votre/répertoire/de/travail
                wget http://gulliver.eu.org/style.css
		wget http://gulliver.eu.org/.wmlrc
		wget http://gulliver.eu.org/.wmkrc
		wget http://gulliver.eu.org/renaming
		chmod a+x renaming
		rsync -azH rsync.linux-france.org::wlfc/lug/gulliver/wmlinc .</pre>
		
		Si vous souhaitez plutôt récupérer la totalité du site faite :
		<pre class="sh">
		cd votre/répertoire/de/travail
		rsync -azH rsync.linux-france.org::wlfc/lug/gulliver .
		chmod a+x renaming</pre>
	</li>
	<br>
	<li>
		Pour ce qui est des droits d'écriture :
		<ul>
		  <li> Si vous souhaitez éditer les parties sous CVS, suivez les instructions
		  <A href="http://www.linux-france.org/prj/lfoyer/doc/htm/cvs.fr.htm"> ici</A>.
		  </li>
		  <br>
		  <li> Si vous souhaitez créer un nouveau répertoire à la racine du site (dans /lug/gulliver sur lfo ;),
		  Vous pouvez en discuter sur 
		  <A href="mailto:gulliver@listes.gulliver.eu.org">gulliver@listes.gulliver.eu.org</A> et 
		  <A href="mailto:gulliver-ca@listes.gulliver.eu.org">gulliver-ca@listes.gulliver.eu.org</A>.
		  </li>
		  <br>
		  <li>
		  Vous pouvez aussi discuter avec le mainteneur d'un répertoire existant, pour voir s'il est
		  d'accord pour céder sa place.
		  </li>
		</ul>
	</li>
</ul>

-->

<a id="resume"></a>
<stitle>Résumé</stitle>
<p>
Note:
pour éditer le site de Gulliver vous aurez besoin des outils suivant : 
ssh, cvs, wml (sur Debian faites : <em>apt-get install ssh cvs wml</em>)
</p>
<p>
Voci la liste des étapes à effectuer :
<ul>

<!--
 <li> 
je fais connaître mon intérêt pour le site en m'inscrivant à la  
<a href="mailto:gulliver-editorial-subscribe@listes.gulliver.eu.org">
liste du comité éditorial</a> de Gulliver.
 </li>
-->

 <li>
je 
<a href="mailto:glamiral@linux-france.org?subject='demande de compte lfo pour site de gulliver'&cc='gulliver-ca@listes.gulliver.eu.org'">demande un compte</a>
sur linux-france.org (lfo)
 </li>

 <li>
j'initialise mon compte ssh en faisant (sur ma machine) : 
<pre class="sh">
export compte="le nom du compte lfo qu'on m'a attribué" ;
cd ;
ls .ssh/id_dsa || ssh-keygen -t dsa ;
scp .ssh/id_dsa.pub $compte@linux-france.org:~/ ;
ssh $compte@linux-france.org 'cat ~/id_dsa.pub >> ~/.ssh/authorized_keys2' ;
ssh $compte@linux-france.org 'chmod -R g-w ~/' ;
</pre>
(pour plus d'information voir la 
<a href="http://www.linux-france.org/prj/lfoyer/doc/htm/ssh.fr.htm">documentation ssh</a> 
de lfo)
 </li>

 <li>
je 
<a href="mailto:glamiral@linux-france.org?subject='demande d'accès au CVS lfo pour site de Gulliver'">demande
un accès au compte CVS</a> en précisant l'emplacement de mon fichier id_dsa.pub sur lfo 
(cf. <a href="http://www.linux-france.org/prj/lfoyer/doc/htm/cvs.fr.htm#s3">documentation cvs de lfo</a>)
 </li>

 <li>
je récupère la partie du site qui m'intéresse 
(cf. <a href="http://www.linux-france.org/prj/lfoyer/doc/htm/cvs.fr.htm#s4">documentation cvs de lfo</a>):
<pre class="sh">
export $rep_gul="~/mon/repertoire/de/travail/pour/le/site/de/gulliver" ;
cd $rep_gul ;
export CVSROOT=:ext:cvs@linux-france.org:/home4/lf/cvs/ ;
export CVS_RSH=ssh ;
cvs checkout www.linux-france.org/lug/gulliver/ 
</pre>
 </li>

 <li>
je modifie les fichiers <em>.wml</em> que je veux modifier et je régénère le html.
par ex ;
<pre class="sh">
vi fichier_a_modifier.wml ;
#je modifie mon fichier et je tape ':wq' pour finir
wml -o fichier_a_modifier.html fichier_a_modifier.wml ;
</pre>
</li>

 <li>
Je publie mes modifications sur le site.
<pre class="sh">
cvs commit fichier_modifie ;
</pre>
la commande CVS me demandera de rédiger un <i>message de log</i>&nbsp;: 
je donne un rapide résumé de mes modifications et j'indique l'auteur 
des modifications.
 </li>

 <li>
Au bout de 1h maximum, le site est remis à jour avec mes modifications, je vérifie mes changements.
 </li>

</ul>
<p>
ce résumé est très incomplet, il manque l'essentiel à savoir comment se structure le site et 
comment on utilise wml. Néanmoins, il donne les bases pour l'accès au serveur web de Gulliver.
</p><p>
Pour les gens qui voudraient participer et qui ne comprennent rien à ce charabia, vous pouvez vous 
inscrire sur la liste gulliver@listes.gulliver.eu.org pour demander ce que vous pouvez faire.
</p>


<sstitle>
Ok, j'ai fait tout ça, et WML comment ça marche ?
</sstitle>

<p>
Les pages sources <em>wml</em> sont composées d'un include en tête de page, celui-ci s'occupera du menu et du reste, suivi
du contenu effectif de votre page en <em>html</em>.<br>
Vous pouvez aussi vous aider des macros définie par WML, pour les connaître, taper wmd dans un terminal.<br><br>

Voici le format de l'include :<br>
<pre class="sh">
<protect>#include "$(ROOT)/wmlinc/template.inc" section=links SECTION_NAME="Liens"</protect>
</pre>

Ceci est l'include de cette page.<br>
La variable SECTION_NAME correspond au titre de la page.<br>
La variable section est là pour la gestion du menu, elle indique à WML le nom de l'item de menu à utiliser pour cette page.<br>
Le nom d'item est suivi de " subselected"  lorsque l'item en question n'est pas à la racine du menu.<br>
Attention de ne pas confondre l'arborescence du menu et celle des fichiers, elles sont différentes.<br>
Pour comprendre le fonctionnement des menu, voir la documentation de WML (wmd(1)), ainsi que les sources <em>wml</em> du menu situé
dans wmlinc/.<br>
<br>
Pour générer les pages:
<pre class="sh">
wml -o foo.html foo.wml
</pre>
ou, pour régénérer tout le site:
<pre class="sh">
cd repertoire/travail/racine
wmk -a
</pre>
Une fois vos pages régénérées, il ne vous reste plus qu'à envoyer vos pages ainsi que les sources sur votre compte lfo.

exemple:
<pre class="sh">
rsync -avz rencontrer scripts foo@linux-france.org:~/html/lug/gulliver/
</pre>


</p>
<br><br>

<sstitle>
PHP, c'est possible ?
</sstitle>

<p>
Il est possible d'utiliser PHP dans vos pages, mais c'est à utiliser avec parcimonie. Pour que vos pages générées
soient renommées en .php automatiquement, nommez le source en .pwml .

</p>



<sstitle>
Des questions ?
</sstitle>

Vous pouvez toujours demander de l'aide sur 

<A href="mailto:gulliver@listes.gulliver.eu.org">gulliver@listes.gulliver.eu.org</A>, nous sommes
là pour ça.