Le Projet de documentation Debian conserve ses pages web et la plupart des manuels sur le serveur CVS Debian à l'adresse cvs.debian.org.
Seuls les membres du Projet de documentation Debian peuvent mettre à jour les fichiers sur le serveur CVS. Les autres personnes ne peuvent que les télécharger.
Vous pouvez vous servir de CVSWeb pour accéder aux fichiers individuellement et voir les changements qui les affectent.
Pour télécharger un manuel complet, un accès direct au serveur CVS est une meilleure option. Vous aurez besoin du paquet cvs sur votre propre machine.
Pour vous connecter, entrez cette commande :
cvs -d :pserver:anonymous@cvs.debian.org:/cvs/debian-doc login
et pressez la touche [entrée] quand il vous est demandé un mot de passe.
Vous pouvez dès lors utiliser les commandes CVS usuelles (se référer aux pages info de CVS) pour sortir des fichiers, mais vous ne pouvez ni les changer ni les consigner.
Pour télécharger les fichiers la première fois, placez-vous dans le répertoire que vous aurez préalablement créé pour les récupérer. Deux nouveaux répertoires nommés CVS et ddp seront créés dans ce répertoire.
Utilisez cette commande pour télécharger tous les fichiers :
cvs -d :pserver:anonymous@cvs.debian.org:/cvs/debian-doc -z3 checkout ddp/manuals.sgml
Cela créera récursivement les répertoires et les remplira.
Pour actualiser votre copie locale avec les changements effectués par d'autres personnes, entrez dans le répertoire ddp/manuals.sgml et lancez la commande :
cvs -z3 update -d -P
Quand vous avez fini une session distante CVS, utilisez cette commande pour vous déconnecter du serveur :
cvs logout
Avant d'accéder au serveur CVS en utilisant cette méthode, vous devez avoir un accès en écriture. Lisez d'abord comment demander les permissions de mise à jour.
Pour vous connecter, entrez cette commande :
cvs -d :pserver:userid@cvs.debian.org:/cvs/debian-doc login
puis entrez le mot de passe que vous avez négocié avec le coordinateur de la documentation. Dans la commande ci-dessus, remplacez userid avec votre propre nom d'utilisateur sur le serveur de mot de passe CVS. Ce n'est pas nécessairement le même que votre nom de connexion sur cvs.debian.org, si vous en avez un.
Vous pouvez dès lors utiliser les commandes habituelles de CVS (voir les pages info de CVS) pour sortir des fichiers.
Pour télécharger les fichiers la première fois, placez-vous dans le répertoire que vous aurez préalablement créé pour les récupérer. Deux nouveaux répertoires nommés CVS et ddp seront créés dans ce répertoire.
Utilisez cette commande pour télécharger tous les fichiers :
cvs -d :pserver:userid@cvs.debian.org:/cvs/debian-doc -z3 checkout ddp/manuals.sgml
Cela créera récursivement les répertoires et les remplira.
Pour actualiser votre copie locale avec les changements effectués par d'autres personnes, entrez dans le répertoire ddp/manuals.sgml et lancez la commande :
cvs -z3 update -d -P
Quand vous avez fini une session distante CVS, utilisez cette commande pour vous déconnecter du serveur :
cvs logout
Cette méthode est disponible uniquement pour les développeurs Debian enregistrés et on la préférera à la méthode précédente. Si vous vous êtes récemment enregistrés comme développeur Debian, il faut demander au coordinateur de la documentation de supprimer votre compte pserver.
Une connexion utilisant ssh doit être signalée à CVS avec :
export CVS_RSH=ssh
Puis placez-vous dans un répertoire créé pour tout récupérer et entrez cette commande :
cvs -d :ext:userid@cvs.debian.org:/cvs/debian-doc -z3 checkout
module
Dans la commande ci-dessus, remplacez userid avec votre propre nom d'utilisateur sur le serveur CVS. C'est le même que votre nom de connexion sur cvs.debian.org, si vous en avez un. Remplacez module avec le nom du module que vous souhaitez sortir : c'est généralement ddp/manuals.sgml. On va alors vous demander votre mot de passe sur le serveur CVS. Ne le confondez pas avec celui de votre propre machine.
Deux répertoires, CVS et ddp, seront créés dans ce répertoire. CVS va récursivement créer les modules (c'est-à-dire les répertoires) que vous avez demandés et va les remplir avec les fichiers.
Vous pouvez dès lors utiliser les commandes habituelles de CVS (voir les pages info de CVS) pour sortir des fichiers et les consigner.
Pour actualiser votre copie locale avec les changements effectués par d'autres personnes, entrez dans le répertoire ddp/manuals.sgml et lancez la commande :
cvs -z3 update -d -P
Les privilèges de mise à jour sont disponibles à quiconque souhaitant participer à la rédaction de manuels.
Pour obtenir des privilèges de mise à jour, envoyez une demande au coordinateur de la documentation, en indiquant le nom d'utilisateur que vous voulez utiliser sur le pserver et en fournissant un mot de passe crypté, produit par
makepasswd --crypt --clear=your_password
(makepasswd est un paquet Debian).
Si vous ne fournissez pas de mot de passe, on peut vous en créer un, mais il sera moins facile à retenir. Pour changer de mot de passe, envoyez un nouveau courrier au coordinateur, en fournissant le nouveau mot de passe crypté.
Ce schéma montre la structure de l'arborescence CVS :
Veuillez noter que le site web du DDP est placé dans le module webwml du référentiel CVS Debian, pour être intégré avec le reste des pages web Debian.
Les pages publiées sur le web sont produites par une tâche cron lancée quotidiennement sur www.debian.org à 7:00, 15:00 et 23:00 (temps Pacifique).
Le script lance cvs update -d -P, puis make -C manuals.sgml
clean publish, toutes deux dans le répertoire ddp.
Le makefile est configuré pour reconstruire chaque sous-répertoire (qui
contient la documentation maintenue), et pour installer les fichiers de chaque
sous-répertoire dans le sous-répertoire doc/manuals/ du site web.
Les makefiles des sous-répertoires sont dérivés du
ddp/manuals.sgml/standard.makefile.