7. CVS

Le LDP est en train de mettre un place un accès CVS pour les auteurs. Il y a en effet de bonnes raisons d'utiliser CVS :

  1. CVS gère une sauvegarde des documents. Si vous passez un document à un autre auteur, ce dernier peut récupérer le document depuis CVS et continuer à travailler dessus. Si vous avez besoin de revenir à une ancienne version, vous pouvez également la récupérer.

  2. CVS est très appréciable si plusieurs auteurs travaillent sur le même document. Vous pouvez lui demander de vous indiquer quelles modifications ont été faites pendant que vous travailliez sur le document, et directement intégrer ces changements.

  3. CVS garde un historique des modifications du document. Cet historique peut être placé automatiquement dans le document si vous utilisez certaines balises qui seront exécutées avant l'interpréteur SGML.

  4. CVS peut permettre, grâce à un programme, la mise à jour automatique du site Web du LDP, et ce dès qu'un document est terminé et soumis à CVS. Cela n'est pas encore en place, mais est envisagé. Pour l'instant, les mises à jour par CVS signalent au coordinateur des HOWTO qu'une mise à jour du site Web est nécessaire. Si vous utilisez CVS, vous n'avez donc plus besoin d'envoyer votre document SGML par courrier électronique.

Si CVS est quelque chose de nouveau pour vous, voici quelques pages Web qui pourront vous aider :

7.1. Obtenir un compte CVS

D'abord, il vous faudra obtenir un compte dans le "repository" CVS du LDP (NdT : lieu de stockage et de dépôt des documents pour CVS). Il s'agit souvent du répertoire racine utilisé par CVS, où chaque projet (HOWTO, Mini-HOWTO, ...) dispose d'un sous-répertoire.

Vous devrez créer un mot de passe crypté et un identifiant d'utilisateur pour votre compte. Crypter votre mot de passe vous permet de l'envoyer au groupe CVS sans qu'on ait besoin de le voir en clair. Vous pouvez le faire par les commandes suivantes, depuis un shell bash (ou sh) :

bash$ echo your_password | perl -e "print crypt(<>,\ join
'',('.', '/', 0..9, 'A'..'Z', 'a'..'z')[rand 64, rand 64]),\"\n\""

Envoyez la sortie de cette commande avec l'identifiant d'utilisateur à . Votre propre répertoire CVSROOT sera créé et vous recevrez un e-mail avec une réponse. Quand vous aurez obtenu la réponse, connectez-vous sur votre CVSROOT et vérifiez que tout est configuré correctement :

bash$ export CVSROOT=:pserver:your_userid@cvs.linuxdoc.org:/cvsroot
bash$ cvs -d $CVSROOT login 

(Remplacez your_userid par ce qui vous a été indiqué dans la réponse.)

On vous demandera de saisir votre mot de passe, à la suite de quoi vous aurez accès au repository CVS en lecture-écriture. Après avoir utilisé cvs login une fois et obtenu l'accès au système, votre mot de passe sera stocké dans .cvsroot et vous n'aurez plus besoin d'utiliser cvs login. Positionnez CVSROOT correctement et c'est parti. Vous pouvez récupérer le repository linuxdoc en entier avec cette commande :

bash$ cvs get LDP 

Ou vous pouvez obtenir le fichier source SGML de votre propre document par :

bash$ cvs get howto/YOUR-HOWTO.sgml 
bash$ cvs get minihowto/YOURDOC.sgml 

7.2. Autres informations sur CVS

7.2.1. Accès CVS anonyme

Un accès CVS anonyme est disponible pour ceux qui n'ont pas besoin de compte (tels ceux désirant juste récupérer les documents du LDP). Ce repository est en lecture seule :

bash$ cvs -d \
:pserver:cvs@anoncvs.linuxdoc.org:/cvsroot login 

Utilisez "cvs" comme mot de passe. Vous pouvez alors accéder aux modules linuxdoc comme décrit ci-dessus. Notez que les changements apparaissent sur le CVS anonyme une demi-heure environ après le site principal.

7.2.2. Accès CVS par le Web

Vous pouvez accéder au repository CVS par le Web à l'adresse http://cvsweb.linuxdoc.org/index.cgi/linuxdoc.

7.2.3. Accès graphique à CVS

Il existe des interfaces graphiques pour CVS, et vous en trouverez une liste sur le site http://freshmeat.net/appindex. Lancez-y une recherche sur: "CVS".

7.3. CVS et la mise à jour des fichiers

CVS reconnaît une balise spéciale, $Id, que vous pouvez utiliser pour insérer automatiquement la date et le numéro de version dans votre document. Lors de la mise à jour, CVS remplace cette balise par quelque chose comme $Id: HOWTO-HOWTO.sgml,v 1.5 2000/06/12 21:45:51 gferg Exp $. En plaçant cette balise dans votre document, elle sera modifiée à chaque changement du document, permettant une incrémentation automatique du numéro de version.

Quand vous voulez copier votre fichier modifié sur le serveur CVS, utilisez la commande cvs ci -m "commentaires" VOTRE-HOWTO.sgml. Le paramètre -m "commentaires" n'est pas obligatoire, mais si vous ne le mettez pas, votre éditeur de texte sera lancé (en général vi, ou du moins l'éditeur indiqué par la variable d'environnement EDITOR) et vous pourrez taper un commentaire à propos des changements.

Vous pouvez suivre toutes les discussions à propos de CVS sur la liste ldp-discuss. Pour l'instant, les soumissions LDP doivent toujours être envoyées à .

Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 18:01:30