[ddr] webwml://french/doc/cvs.wml docpolicy.wml
Bonjour,
voici la mise à jour des fichiers suivants :
doc/cvs.wml
doc/docpolicy.wml
Merci aux relecteurs.
Mickaël.
--
#use wml::debian::ddp title="La politique de documentation DDP"
#use wml::debian::translation-check translation="1.8" maintainer="Mickael Simon"
<p>Ce document obsolète est en cours de réélaboration sur
<email debian-doc@lists.debian.org>.
<p>Voici les décisions prises sur notre liste de diffusion et approuvées par
l'administrateur de la documentation, Susan G. Kleinmann.
<br>
<ul>
<li>Tous les manuels du projet de documentation Debian (DDP) sortiront
sous licences conformes aux DFSG, très probablement GPL.
<br>
<li>Nous utiliserons la structure de répertoire suivante :
<p>Système de fichiers :
<pre>
/usr/share/doc/manuals/<var>somemanual</var>/index.html
/usr/share/doc/manuals/<var>somemanual</var>.ps.gz (optional)
</pre>
<p>Serveur WWW :
<pre>
http://www.debian.org/doc/manuals/<var>somemanual</var>/
</pre>
<p>Serveurs FTP :
<pre>
ftp://ftp.debian.org/debian/doc/manuals/<var>somemanual</var>.html.tar.gz
ftp://ftp.debian.org/debian/doc/manuals/<var>somemanual</var>.text.gz
ftp://ftp.debian.org/debian/doc/manuals/<var>somemanual</var>.dvi.gz
ftp://ftp.debian.org/debian/doc/manuals/<var>somemanual</var>.ps.gz
ftp://ftp.debian.org/debian/doc/manuals/<var>somemanual</var>.sgml.tar.gz
</pre>
<p>Ce point de la charte n'étant pas encore universellement accepté, ces URI
peuvent ne pas marcher. Les emplacements exacts des documents peuvent varier
pour des raisons de compatibilité ascendante.
<br>
<li>Nous utiliserons le SGML comme format source.
<p>Cela ne signifie pas que les utilisateurs doivent apprendre le SGML pour
soumettre des changements à nos documents. Nous acceptons aussi bien
d'autres formats. Quoi qu'il en soit, ils seront traduits en SGML par une
des personnes de Debian-Doc.
<p><small>Les autres options sont : LaTeX, HTML, Texinfo, et plusieurs
autres formats mineurs.</small>
<br>
<li>Nous utiliserons <strong>debiandoc-sgml</strong> pour nos documents.
<p><small>Les autres options étaient linuxdoc-sgml ou DocBook mais Linuxdoc
n'est plus maintenu et DocBook est jugé trop gros, trop complexe et trop
difficile à personnaliser.</small>
<br>
<li>Chaque document Debian n'aura qu'un seul <em>responsable</em> et pourra
avoir éventuellement d'autres personnes considérées comme
<em>coresponsables</em>.
</ul>
#use wml::debian::ddp title="Le CVS du Projet de documentation Debian"
#use wml::debian::toc
#use wml::debian::translation-check translation="1.15" maintainer="Mickael Simon"
<p>Le Projet de documentation Debian conserve ses pages web et la plupart des
manuels sur le serveur CVS Debian à l'adresse <b>cvs.debian.org</b>.
<p>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.
<toc-display/>
<toc-add-entry name="access">Accéder aux sources du CVS</toc-add-entry>
<p>Vous pouvez utiliser une <a
href="http://cvs.debian.org/ddp/manuals.sgml/?cvsroot=debian-doc";>interface
web</a> pour accéder aux fichiers individuellement et voir les changements qui
les affectent.
<p>Pour télécharger un manuel complet, un accès direct au serveur CVS est
souvent une meilleure option. Vous aurez besoin du paquet <tt><a
href="http://packages.debian.org/cvs";>cvs</a></tt> sur votre propre machine.
<h3>Se connecter anonymement (en lecture seule) sur le serveur CVS</h3>
<p>Pour vous connecter, entrez cette commande :
<p style="margin-left: 2em">
<code>cvs -d :pserver:anonymous@cvs.debian.org:/cvs/debian-doc login</code>
</p>
<p>et pressez la touche [entrée] quand il vous est demandé un mot de passe.
<p>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.
<p>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 <strong>CVS</strong> et <strong>ddp</strong> seront créés
dans ce répertoire.
<p>Utilisez cette commande pour télécharger tous les fichiers :
<p style="margin-left: 2em">
<code>cvs -d :pserver:anonymous@cvs.debian.org:/cvs/debian-doc -z3 checkout ddp/manuals.sgml</code>
</p>
<p>Cela créera récursivement les répertoires et les remplira.
<p>Pour actualiser votre copie locale avec les changements effectués par
d'autres personnes, entrez dans le répertoire
<strong>ddp/manuals.sgml</strong> et lancez la commande :
<p style="margin-left: 2em">
<code>cvs -z3 update -d -P</code>
</p>
<p>Quand vous avez fini une session distante CVS, utilisez cette commande pour
vous déconnecter du serveur :
<p style="margin-left: 2em">
<code>cvs logout</code>
</p>
<h3>Se connecter au serveur CVS avec des privilèges de mise à jour</h3>
<p>Avant d'accéder au serveur CVS en utilisant cette méthode, vous devez
avoir un accès en écriture. Lisez d'abord comment <a
href="#obtaining">demander</a> les permissions de mise à jour.
<p>Pour vous connecter, entrez cette commande :
<p style="margin-left: 2em">
<code>cvs -d :pserver:<var>userid</var>@cvs.debian.org:/cvs/debian-doc login</code>
</p>
<p>puis entrez le mot de passe que vous avez négocié avec le coordinateur de
la documentation. Dans la commande ci-dessus, remplacez <var>userid</var> 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
<b>cvs.debian.org</b>, si vous en avez un.
<p>Vous pouvez dès lors utiliser les commandes habituelles de CVS (voir les
pages info de CVS) pour sortir et consigner des fichiers.
<p>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 <strong>CVS</strong> et <strong>ddp</strong> seront créés
dans ce répertoire.
<p>Utilisez cette commande pour télécharger tous les fichiers :
<p style="margin-left: 2em">
<code>cvs -d :pserver:userid@cvs.debian.org:/cvs/debian-doc -z3 checkout ddp/manuals.sgml</code>
</p>
<p>Cela créera récursivement les répertoires et les remplira.
<p>Pour actualiser votre copie locale avec les changements effectués par
d'autres personnes, entrez dans le répertoire
<strong>ddp/manuals.sgml</strong> et lancez la commande :
<p style="margin-left: 2em">
<code>cvs -z3 update -d -P</code>
</p>
<p>Quand vous avez fini une session distante CVS, utilisez cette commande pour
vous déconnecter du serveur :
<p style="margin-left: 2em">
<code>cvs logout</code>
</p>
<h3>Se connecter à travers SSH au serveur CVS avec des privilèges de mise à
jour </h3>
<p>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.
<p>Une connexion utilisant ssh doit être signalée à CVS avec :
<p style="margin-left: 2em">
<code>export CVS_RSH=ssh</code>
</p>
<p>Puis placez-vous dans un répertoire créé pour tout récupérer et entrez
cette commande :
<p style="margin-left: 2em">
<code>cvs -d :ext:<var>userid</var>@cvs.debian.org:/cvs/debian-doc -z3 checkout <var>module</var></code>
</p>
<p>Dans la commande ci-dessus, remplacez <var>userid</var> avec votre propre nom
d'utilisateur sur le serveur CVS. Il est identique à votre nom de connexion sur
toutes les machines Debian. Remplacez <var>module</var> avec le nom
du module que vous souhaitez sortir : c'est généralement
<tt>ddp/manuals.sgml</tt>. On va alors vous demander votre mot de passe sur le
serveur CVS. Ne le confondez pas avec celui de votre propre machine.
<p>Deux répertoires, <strong>CVS</strong> et <strong>ddp</strong>, 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.
<p>Vous pouvez dès lors utiliser les commandes habituelles de CVS (voir les
pages info de CVS) pour sortir des fichiers et les consigner.
<p>Pour actualiser votre copie locale avec les changements effectués par
d'autres personnes, entrez dans le répertoire
<strong>ddp/manuals.sgml</strong> et lancez la commande :
<p style="margin-left: 2em">
<code>cvs -z3 update -d -P</code>
</p>
<toc-add-entry name="obtaining"> Obtenir des privilèges de mise à jour</toc-add-entry>
<p>Les privilèges de mise à jour sont disponibles à quiconque souhaitant
participer à la rédaction de manuels.
<p>Pour obtenir des privilèges de mise à jour, envoyez une demande au <a
href="mailto:aph@debian.org";>coordinateur de la documentation</a>, 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
<code>mkpasswd</code>, un utilitaire issu du <a
href="http://packages.debian.org/whois";>paquet whois</a>.
<hr>
<toc-add-entry name="organization">Organisation des fichiers</toc-add-entry>
<p>Ce schéma montre la structure de l'arborescence CVS :
<p><img src="dirtree.jpg" align="middle" alt="arborescence CVS du DDP">
<p>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.
<hr>
<toc-add-entry name="updates">Mécanisme de mise à jour automatique</toc-add-entry>
<p>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).
<p>Le script lance <kbd>cvs update -d -P</kbd>, puis <kbd>make -C manuals.sgml
clean publish</kbd>, toutes deux dans le répertoire <code>ddp</code>.
<p>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 <code>doc/manuals/</code> du site web.
Les makefiles des sous-répertoires sont dérivés du
<code>ddp/manuals.sgml/standard.makefile</code>.
<p>Les fichiers de documentation produits par le script de mise à jour sont
disponibles sur <a href="manuals/">http://www.debian.org/doc/manuals/</a>
<p>Les fichiers journaux produits par le script de mise à jour sont disponibles sur
<url "http://www-master.debian.org/build-logs/ddp/";>
# <!-- Created: Mon Jul 6 19:58:09 BST 1998 -->
Reply to: