Comment mettre à jour le site Web de Gulliver en quelques étapes

Le site Web de Gulliver est intégralement stocké dans CVS, un système
de gestion de version, voir
http://www.commentcamarche.net/cvs-dev/cvs-intro.php3 pour une
Introduction et http://www.cvshome.org pour la documentation complète.

Avant de commencer, s'inscrire à la liste de diffusion gulliver@ (gulliver-subscribe@listes.gulliver.eu.org)

Une autre documentation sur le site est disponible à http://gulliver.eu.org/docs/gulweb/gulweb_intro.html

Les étapes à ne faire qu'une seule et unique fois

1. Demander un compte sur linux-france.org à Gilles Lamiral
   <gilles.lamiral@free.fr>

1. Essayer de se connecter en utilisant ssh, avec le mot de passe
   donné par Gilles :

1. Générer une paire clé publique / clé privée ssh :

1. Envoyer la clé publique ~/.ssh/id_dsa.pub (surtout pas
   ~/.ssh/id_dsa qui est la clé privée) à Gilles pour qu'il l'ajoute
   à l'utilisateur cvs sur linux-france.org.

1. Récupérer une copie initiale du site Web :

1. Le site est stocké dans le répertoire
   www.linux-france.org/lug/gulliver/ créé dans le répertoire
   courant.

Pour modifier le site

1. Éditer le fichier machin.wml souhaité (et surtout pas
   machin.html), et y effectuer les modifications, avec un éditeur de
   texte brut :

1. Générer le fichier HTML à partir du fichier WML (le paquet Debian
   wml est nécessaire) :

1. Vérifier dans un navigateur Web que le résultat est satisfaisant :

1. Envoyer les modifications sur le serveur :

Les modifications ne sont pas appliquées automatiquement sur le site
Web officiel, mais seulement toutes les heures, à 0h20, 1h20, 2h20,
etc. Si vous souhaitez qu'elles soient appliquées immédiatemment,
connectez-vous avec votre compte sur linux-france.org, puis éxécutez
la commande ~lf/bin/authsync_demand :

Mettre à jour sa copie du site

Plusieurs personnes pouvant éditer le site, il est nécessaire de
mettre votre copie du site à jour de temps en temps. En particulier,
il faut le faire *avant* d'effectuer une modification sur le site,
pour éviter d'entrer en conflit avec une autre modification effectuée
parallèlement. Si lors de l'envoi sur le serveur (commit) vous avez un
message du site "up-to-date check failed", c'est que vous n'avez pas
mis à jour.

Ajouter/supprimer un fichier/répertoire

Attention, à manipuler avec précaution. CVS est assez mal fichu, et il
est très délicat de renommer un fichier ou un répertoire après sa
création, et il est très difficile de supprimer réellement un
répertoire.

---