Comment participer à l'édition du site de Gulliver.

Principe de fonctionnement du site.

Le site fait partie de linux-france.org (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.

Le site est statique (html, sauf 2-3 pages), les pages html sont générées grâce à WML à partir de squelettes (templates) et du contenu de la page.

Le site est géré sous cvs sur linux-france.org (lfo). Toutes les heures et 20 minutes, le serveur de linux-france (lfo) met à jour la partie publique en fonction du contenu du dépôt cvs.

Pour de plus amples informations sur le fonctionnent de Linux-france.org il est conseillé de consulter ces pages :

• Premiers pas sur lfo
• Qui fait quoi sur lfo
• Maintenance et évolution de www.linux-france.org
• SSH sur lfo
• Utiliser CVS sur lfo

Résumé

Note: pour éditer le site de Gulliver vous aurez besoin des outils suivant : ssh, cvs, wml (sur Debian faites : apt-get install ssh cvs wml)

Voci la liste des étapes à effectuer :

• je demande un compte sur linux-france.org (lfo)
• j'initialise mon compte ssh en faisant (sur ma machine) :

  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 ~/' ;
  

  (pour plus d'information voir la documentation ssh de lfo)
• je demande un accès au compte CVS en précisant l'emplacement de mon fichier id_dsa.pub sur lfo (cf. documentation cvs de lfo)
• je récupère la partie du site qui m'intéresse (cf. documentation cvs de lfo):

  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/
  

• je modifie les fichiers .wml que je veux modifier et je régénère le html. par ex ;

  vi fichier_a_modifier.wml ;
  wml -o fichier_a_modifier.html fichier_a_modifier.wml ;
  

• Je publie mes modifications sur le site.

  cvs commit fichier_modifie ;
  

  la commande CVS me demandera de rédiger un message de log : je donne un rapide résumé de mes modifications et j'indique l'auteur des modifications.
• Au bout de 1h maximum, le site est remis à jour avec mes modifications, je vérifie mes changements.

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.

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.

Ok, j'ai fait tout ça, et WML comment ça marche ?

Les pages sources wml 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 html.
Vous pouvez aussi vous aider des macros définie par WML, pour les connaître, taper wmd dans un terminal.

Voici le format de l'include :

#include "$(ROOT)/wmlinc/template.inc" section=links SECTION_NAME="Liens"

wml -o foo.html foo.wml

cd repertoire/travail/racine
wmk -a

rsync -avz rencontrer scripts foo@linux-france.org:~/html/lug/gulliver/

PHP, c'est possible ?

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 .

Des questions ?