Le Projet de documentation Debian conserve ses pages web et la plupart des manuels sur le serveur CVS Debian à l'adresse cvs.debian.org.
Tous le monde peut télécharger les sources à partir du serveur CVS. Seuls
les membres du Projet de documentation Debian peuvent mettre à jour ces
fichiers.
Vous pouvez utiliser une interface web 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 souvent 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 et consigner 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. Il est identique à votre nom de connexion sur toutes les machines Debian. 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é. Vous pouvez vous en créer un avec
mkpasswd, un utilitaire issu du paquet whois.
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-master.debian.org, après 15:39 (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.
Les fichiers de documentation produits par le script de mise à jour sont disponibles sur http://www.debian.org/doc/manuals/
Les fichiers journaux produits par le script de mise à jour sont disponibles sur