[RFR] wml://doc/cvs.wml
Bonjour,
cette page vient d’être modifiée.
Voici une proposition de traduction.
Le fichier en anglais est téléchargeable ici :
https://salsa.debian.org/webmaster-team/webwml/raw/master/english/doc/cvs.wml
Le fichier en français est téléchargeable ici :
https://salsa.debian.org/webmaster-team/webwml/raw/master/french/doc/cvs.wml
Merci d’avance pour vos relectures.
Amicalement.
--
Jean-Paul
commit 6fb6b036dd209b63e98e309c29803afec40f7048
Author: Guillem Jover <guillem@debian.org>
Date: Wed Jul 11 15:40:15 2018 +0200
doc: Update for salsa migration
Remove CVS and SVN references, old image and commented out text.
diff --git a/english/doc/cvs.wml b/english/doc/cvs.wml
index 112d0f137f1..195f684f9c6 100644
--- a/english/doc/cvs.wml
+++ b/english/doc/cvs.wml
@@ -1,124 +1,82 @@
-#use wml::debian::ddp title="Debian Documentation Project SVN"
+#use wml::debian::ddp title="Debian Documentation Project VCS"
#use wml::debian::toc
<p>The Debian Documentation Project stores its web pages and much of the
-manual text on the Debian Subversion server at <strong>svn.debian.org</strong>
-and the Debian Git server at <strong>git.debian.org</strong>.
-svn.debian.org and git.debian.org are part of the Gforge installation on alioth.debian.org.
-Please read the <a href="https://wiki.debian.org/Alioth";>Alioth documentation</a>
+manual text on the Debian Salsa service at
+<strong>salsa.debian.org</strong>, which is Debian's GitLab instance.
+Please read the <a href="https://wiki.debian.org/Salsa";>Salsa documentation</a>
for more information about how this service works.
</p>
-<p>Everybody can download the sources from the SVN/Git server. Only members of
+<p>Everybody can download the sources from the Salsa service. Only members of
the Debian Documentation Project can update files.</p>
<toc-display />
-<toc-add-entry name="access">Accessing the sources in SVN</toc-add-entry>
+<toc-add-entry name="access">Accessing the sources in git</toc-add-entry>
<p>You can use a web interface to access the files individually and
-see changes to them at <url "https://anonscm.debian.org/viewvc/ddp/manuals/trunk/"; /></p>
+see changes on each project at
+<url "https://salsa.debian.org/ddp-team/"; /></p>
-<p>For downloading an entire manual, direct access to the SVN server
+<p>For downloading an entire manual, direct access to the git server
is often a better option. You need the
-<tt><a href="https://packages.debian.org/subversion";>subversion</a></tt> package on your
+<tt><a href="https://packages.debian.org/git";>git</a></tt> package on your
own machine.</p>
-<h3>Connecting anonymously (read-only) to the SVN server</h3>
+<h3>Cloning a git repository anonymously (read-only)</h3>
-<p>Use this command to download all the files:</p>
+<p>Use this command to download all the files for one project:</p>
<p style="margin-left: 2em">
- <code>svn co svn://svn.debian.org/svn/ddp/manuals/trunk manuals</code>
+ <code>git clone https://salsa.debian.org/ddp-team/release-notes.git</code>
</p>
-<p>This will recursively create the directories and populate them.</p>
+<p>Do the same for every project you want to clone locally.</p>
-<p>To update your local copy with any changes made by other people, enter
-the <strong>manuals</strong> directory and run the command:</p>
-
-<p style="margin-left: 2em">
- <code>svn export --force svn://svn.debian.org/svn/ddp/manuals</code>
-</p>
-
-<h3>Connecting to the SVN server, with update privileges (svn)</h3>
+<h3>Cloning a git repository with push privileges (read-write)</h3>
-<p>Before accessing the SVN server using this method you have to be
+<p>Before accessing the git server using this method you have to be
granted write access to it first. Please read how to <a
-href="#obtaining">request</a> update permission first.</p>
+href="#obtaining">request</a> push permission first.</p>
-<p>Use this command to download all the files:</p>
+<p>Use this command to download all the files for one project:</p>
<p style="margin-left: 2em">
- <code>svn co svn+ssh://svn.debian.org/svn/ddp/manuals/trunk manuals</code>
+ <code>git clone git@salsa.debian.org:ddp-team/release-notes.git</code>
</p>
-<p>This will recursively create the directories and populate them.</p>
+<p>Do the same for every project you want to clone locally.</p>
-<p>To update your local copy with any changes made by other people, enter
-the <strong>manuals</strong> directory and run the command:</p>
-
-<p style="margin-left: 2em">
- <code>svn update</code>
-</p>
-
-<h3>Connecting to the SVN server, with update privileges (git-svn)</h3>
-
-<p>Before accessing the SVN server using this method you have to be
-granted write access to it first. Please read how to <a
-href="#obtaining">request</a> update permission first.</p>
-
-<p>Use this command to download all the files:</p>
-
-<p style="margin-left: 2em">
- <code>git svn clone -s -rHEAD svn+ssh://svn.debian.org/svn/ddp/manuals manuals</code>
-</p>
-
-<p>This will recursively create the directories and populate them and also create
-a local git repository without older history which can track alioth SVN server.</p>
+<h3>Fetching changes from the remote git repository</h3>
<p>To update your local copy with any changes made by other people, enter
the <strong>manuals</strong> directory and run the command:</p>
<p style="margin-left: 2em">
- <code>git svn rebase</code>
+ <code>git pull</code>
</p>
-<toc-add-entry name="obtaining">Obtaining update privileges</toc-add-entry>
+<toc-add-entry name="obtaining">Obtaining push privileges</toc-add-entry>
-<p>Update privileges are available to anyone who wishes to participate in
+<p>Push privileges are available to anyone who wishes to participate in
writing the manuals. We generally request that you have submitted
a couple of useful patches first.</p>
-<p>After creating your account on <a href="https://alioth.debian.org";>Alioth</a>,
-please request update privileges by clicking <q>Request to join</q> at the
-right-bottom of the <url "https://alioth.debian.org/projects/ddp"; /> page.
-Please make sure to fill in the comment box with the explicit rationale of why
-you need access. Please follow it up with an email to
-debian-doc@lists.debian.org explaining the track record of your work on
-Debian.</p>
+<p>After creating your account on <a href="https://salsa.debian.org/";>Salsa</a>,
+please request push privileges by clicking <q>Request to join</q> on the
+group or any of the specific projects under
+<url "https://salsa.debian.org/ddp-team/"; />.
+Please follow it up with an email to debian-doc@lists.debian.org explaining
+the track record of your work on Debian.</p>
-<p>Once your request is approved, you'll be part of the <a
-href="https://alioth.debian.org/projects/ddp";><q>ddp</q> project</a> (and
-Unix group) on Alioth.</p>
+<p>Once your request is approved, you'll be part of either the <a
+href="https://salsa.debian.org/ddp-team/";><q>ddp-team</q> group</a> or
+one of its projects.
+</p>
<hr />
-# Disabled (obsolete)
-# <toc-add-entry name="organization">Organization of files</toc-add-entry>
-#
-# <p>This figure shows the structure of the CVS directory tree:
-# </p>
-# <div class="center">
-# <img src="dirtree.jpg" alt="DDP CVS directory tree" />
-# </div>
-#
-# <p>Please note that the DDP web site is located in the webwml module of the
-# Debian CVS repository, to be integrated with the rest of the Debian web
-# pages.</p>
-#
-# <hr />
-
<toc-add-entry name="updates">Automatic update mechanism</toc-add-entry>
<p>The published web pages of the manual text are generated on
--- orig_cvs.wml 2018-07-17 10:17:53.551637726 +0200
+++ cvs.wml 2018-07-17 11:59:47.563529551 +0200
@@ -1,163 +1,112 @@
-#use wml::debian::ddp title="Le dépôt Subversion du projet de documentation Debian"
+#use wml::debian::ddp title="Le dépôt VCS du projet de documentation Debian"
#use wml::debian::toc
-#use wml::debian::translation-check translation="01b1789e9ebd40d1c24729fcfe79a6b1f4baf15b" maintainer="David Prévot"
+#use wml::debian::translation-check translation="6fb6b036dd209b63e98e309c29803afec40f7048" maintainer="Jean-Paul Guillonneau"
# Translator:
# Mickael Simon, 2001-2003
# Frédéric Bothamy, 2005, 2007.
# Simon Paillard, 2008, 2009.
# David Prévot, 2010.
-
-<p>Les pages web et la plupart des manuels du Projet de documentation
-Debian sont disponibles sur le serveur Subversion Debian à l'adresse
-<strong>svn.debian.org</strong>
-et sur le serveur Git à l'adresse <strong>git.debian.org</strong>.
-svn.debian.org et git.debian.org font partie de l'installation Gforge sur alioth.debian.org.
-Pour plus d'informations sur le fonctionnement de ce service, veuillez lire la
-<a href="https://wiki.debian.org/Alioth";>documentation Alioth</a>.
+# Jean-Paul Guillonneau, 2018.
+<p>Les pages web et la plupart des manuels du Projet de documentation Debian
+sont disponibles sur le serveur Salsa de Debian à l'adresse
+<strong>salsa.debian.org</strong> qui est lâ??instance GitLab de Debian.
+Veuillez lire la <a href="https://wiki.debian.org/Salsa";>documentation sur
+Salsa</a> pour davantage dâ??informations sur le fonctionnement de ce service.
</p>
-<p>Tout le monde peut télécharger les sources à partir du serveur Subversion ou Git.
-Seuls les membres du projet de documentation Debian peuvent les mettre Ã
-jour.
+<p>Tout le monde peut télécharger les sources à partir du service Salsa. Seuls
+les membres du projet de documentation Debian peuvent les mettre à jour.
<toc-display />
-<toc-add-entry name="access">Accéder aux sources sur le dépôt Subversion</toc-add-entry>
+<toc-add-entry name="access">Accéder aux sources sur le dépôt Git</toc-add-entry>
+
+<p>Vous pouvez utiliser l'interface web pour accéder aux différents fichiers et
+voir les modifications dans chaque projet sur
+<url "https://salsa.debian.org/ddp-team/"; />.</p>
-<p>Vous pouvez utiliser l'interface web pour accéder aux différents
-fichiers et visualiser leurs modifications Ã
-<url "https://anonscm.debian.org/viewvc/ddp/manuals/trunk/"; />.</p>
-<p>Pour télécharger un manuel complet, un accès direct au serveur Subversion
+<p>Pour télécharger un manuel complet, un accès direct au serveur Git
est souvent la meilleure solution. Vous aurez besoin du paquet <tt><a
-href="https://packages.debian.org/subversion";>subversion</a></tt> sur votre propre
+href="https://packages.debian.org/git";>git</a></tt> sur votre propre
machine.</p>
-<h3>Se connecter anonymement (en mode lecture seule) sur le serveur Subversion</h3>
+<h3>Se connecter anonymement (mode lecture seule) sur le serveur Git</h3>
-<p>Utilisez cette commande pour télécharger tous les fichiers :</p>
+<p>Utilisez cette commande pour télécharger tous les fichiers dâ??un seul projet :</p>
<p style="margin-left: 2em">
- <code>svn co svn://svn.debian.org/svn/ddp/manuals/trunk manuals</code>
+ <code>git clone https://salsa.debian.org/ddp-team/release-notes.git</code>
</p>
-<p>Cela créera toute l'arborescence de la documentation.</p>
+<p>Faites de même pour chaque projet que vous voulez cloner localement.</p>
-<p>Pour actualiser votre copie locale avec les modifications effectuées par
-d'autres personnes, entrez dans le répertoire
-<strong>manuals</strong> et lancez la commande :</p>
+<h3>Cloner un dépôt Git avec les privilèges de mise à jour (mode lecture et écriture)</h3>
-<p style="margin-left: 2em">
- <code>svn export --force svn://svn.debian.org/svn/ddp/manuals</code>
-</p>
+<p>Avant dâ??accéder au serveur Git en utilisant cette méthode, les droits
+dâ??écriture doivent dâ??abord vous être accordés. Veuillez lire en premier comment
+<a href="#obtaining">solliciter</a> la permission de mise à jour.</p>
-
-<h3>Se connecter au serveur Subversion avec des privilèges de mise à jour (svn)</h3>
-
-<p>Avant d'accéder au serveur Subversion en utilisant cette méthode, vous devez
-avoir le droit d'écriture. Lisez d'abord comment <a
-href="#obtaining">demander</a> les permissions de mise à jour.</p>
-
-<p>Utilisez cette commande pour télécharger tous les fichiers :</p>
+<p>Utilisez cette commande pour télécharger tous les fichiers dâ??un projet
+particulier :</p>
<p style="margin-left: 2em">
- <code>svn co svn+ssh://svn.debian.org/svn/ddp/manuals/trunk manuals</code>
+ <code>git clone git@salsa.debian.org:ddp-team/release-notes.git</code>
</p>
-<p>Cela créera toute l'arborescence de la documentation.</p>
+<p>Faites de même pour chaque projet que vous voulez cloner localement.</p>
+
+<h3>Récupérer les modifications du dépôt distant de Git</h3>
<p>Pour actualiser votre copie locale avec les modifications effectuées par
d'autres personnes, entrez dans le répertoire
<strong>manuals</strong> et lancez la commande :</p>
<p style="margin-left: 2em">
- <code>svn update</code>
+ <code>git pull</code>
</p>
+<toc-add-entry name="obtaining">Obtenir les privilèges de mise à jour</toc-add-entry>
-<h3>Se connecter au serveur Subversion avec des privilèges de mise à jour (git-svn)</h3>
-
-<p>Avant d'accéder au serveur Subversion en utilisant cette méthode, vous devez
-avoir le droit d'écriture. Lisez d'abord comment <a
-href="#obtaining">demander</a> les permissions de mise à jour.</p>
-
-<p>Utilisez cette commande pour télécharger tous les fichiers :</p>
+<p>Les privilèges de mise à jour (push) sont accordés à tous ceux désirant
+participer à lâ??écriture des manuels. Nous demandons habituellement que vous
+ayez dâ??abord présenté quelques correctifs utiles.</p>
-<p style="margin-left: 2em">
- <code>git svn clone -s -rHEAD svn+ssh://svn.debian.org/svn/ddp/manuals manuals</code>
-</p>
+<p>Après la création de votre compte pour <a href="https://salsa.debian.org/";>Salsa</a>,
+demandez les privilèges de mise à jour en cliquant sur <q>Request to join</q>
+pour le groupe ou nâ??importe quel projet particulier dans
+<url "https://salsa.debian.org/ddp-team/"; />.
+Veuillez ensuite envoyer un courriel à debian-doc@lists.debian.org expliquant
+les antécédents de votre travail dans Debian.</p>
-<p>
-Cela créera toute l'arborescence de la documentation
-ainsi qu'un dépôt Git local sans les anciens historiques
-qui peuvent suivre le serveur Subversion d'alioth.
+<p>Une fois votre requête acceptée, vous serez membre du groupe <a
+href="https://salsa.debian.org/ddp-team/";><q>ddp-team</q> </a> ou dâ??un de ses
+projets.
</p>
-<p>Pour actualiser votre copie locale avec les modifications effectuées par
-d'autres personnes, entrez dans le répertoire
-<strong>manuals</strong> et lancez la commande :</p>
-
-<p style="margin-left: 2em">
- <code>git svn rebase</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 accessibles à quiconque souhaite
-participer à la rédaction de manuel. Mais en général, vous ne les
-obtenez qu'après avoir soumis une ou deux corrections utiles.</p>
-
-<p>Après avoir créé un compte sur <a href="https://alioth.debian.org";>Alioth</a>,
-vous pouvez demander des privilèges de mises à jour en cliquant sur le lien
-<q>Demander à rejoindre le projet</q>
-en bas à droite de la page <url "https://alioth.debian.org/projects/ddp"; />.
-Assurez-vous de remplir la case commentaire avec une explication claire
-de vos besoins. Veuillez ensuite envoyer un courriel Ã
-debian-doc@lists.debian.org qui décrit votre travail dans Debian.</p>
-
-<p>Une fois votre demande approuvée, vous ferez partie du <a
-href="https://alioth.debian.org/projects/ddp";>projet <q>ddp</q></a>
-(et du groupe Unix) sur Alioth.</p>
-
-<hr />
-
-# Disabled (obsolete)
-# <toc-add-entry name="organization">Organisation des fichiers</toc-add-entry>
-#
-# <p>Ce schéma montre la structure de l'arborescence CVS :
-# </p>
-# <div class="center">
-# <img src="dirtree.jpg" alt="arborescence CVS du DDP" />
-# </div>
-#
-# <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.</p>
-#
-# <hr />
-
+<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 toutes les 4 heures lors de
-la reconstruction périodique du site www-master.debian.org.</p>
-
-<p>Le script lance <kbd>svn update</kbd>, puis <kbd>make -C manuals
-clean publish</kbd>.</p>
+<p>Les pages web publiées de texte de manuel sont générées sur
+www-master.debian.org dans le cadre du processus de reconstruction qui se
+déroule tous les quatre heures.</p>
+
+<p>Le script exécute un <kbd>svn export --force svn://svn.debian.org/svn/ddp/manuals</kbd>,
+et puis <kbd>make -C trunk publish</kbd>.</p>
+
+<p>Le makefile est réglé pour reconstruire chaque sous-répertoire (qui
+contient la documentation à jour) et pour installer les fichiers de
+chaque sous-répertoire dans le sous-répertoire <code>doc/manuals/</code> du
+site web. Les makefile des sous-répertoires sont dérivés de
+<code>manuals/standard.makefile</code>.</p>
-<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/standard.makefile</code>.</p>
-
-<p>Les fichiers de documentation produits par le script de mise à jour
-sont disponibles sur <a
-href="manuals/">https://www.debian.org/doc/manuals/</a>.</p>
+<p>Les fichiers de la documentation générés par le script de mise à jour
+peuvent être trouvés sur <a href="manuals/">https://www.debian.org/doc/manuals/</a>.</p>
-<p>Les fichiers-journaux produits par le script de mise à jour sont disponibles sur
-<url "https://www-master.debian.org/build-logs/ddp/"; />.</p>
+<p>Les fichiers de journaux générés par le script de mise à jour peuvent être
+trouvés sur <url "https://www-master.debian.org/build-logs/ddp/"; />.</p>
<p>Notez que ce processus régénère le répertoire <code>/doc/manuals/</code>.
Le contenu du répertoire <code>/doc/</code> est généré soit depuis
Reply to: