[RFR] wml://doc/vcs.wml
Bonjour,
Cette page a évoluée.
Les fichiers sont aussi disponibles ici :
https://salsa.debian.org/webmaster-team/webwml/raw/master/english/doc/vcs.wml
https://salsa.debian.org/webmaster-team/webwml/raw/master/french/doc/vcs.wml
Voici une proposition de traduction.
Merci d’avance pour vos relectures et commentaires.
Amicalement.
--
Jean-Paul
--- orig_vcs.wml 2020-04-18 15:54:32.693360724 +0200
+++ vcs.wml 2020-04-18 16:27:02.678934669 +0200
@@ -1,13 +1,13 @@
#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="63b253e9f683a3e51632a8be03911a02d53a936e" maintainer="Jean-Paul Guillonneau"
+#use wml::debian::translation-check translation="bf1a0486dfbf35e11a7ff98a29d9e2e4f2eda3f3" maintainer="Jean-Paul Guillonneau"
# Translator:
# Mickael Simon, 2001-2003
# Frédéric Bothamy, 2005, 2007.
# Simon Paillard, 2008, 2009.
# David Prévot, 2010.
-# Jean-Paul Guillonneau, 2018.
+# Jean-Paul Guillonneau, 2018-2020
<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.
@@ -32,7 +32,7 @@
href="https://packages.debian.org/git";>git</a></tt> sur votre propre
machine.</p>
-<h3>Se connecter anonymement (mode lecture seule) sur le serveur Git</h3>
+<h3>Cloner anonymement un dépôt de Git (mode lecture seule)</h3>
<p>Utilisez cette commande pour télécharger tous les fichiers dâ??un seul projet :</p>
@@ -93,24 +93,21 @@
www-master.debian.org dans le cadre du processus de reconstruction qui se
déroule toutes 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>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 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
-<a href="/devel/website/desc">webwml</a> soit depuis d'autres scripts,
-comme ceux qui extraient les manuels de certains paquets.</p>
+<p>Le processus est réglé pour télécharger les dernières versions des paquets de
+lâ??archive, reconstruire chaque manuel et installer les fichiers dans le
+sous-répertoire <code>doc/manuals/</code> du site web.</p>
+
+<p>Les fichiers de la documentation générés par le script de mise à jour sont
+disponibles sur <a href="manuals/">https://www.debian.org/doc/manuals/</a>.</p>
+
+<p>Les fichiers des journaux générés par le processus de mise à jour sont
+disponibles sur <url "https://www-master.debian.org/build-logs/webwml/"; />
+(le script sâ??appelle <code>7doc</code> et est exécuté dans le cadre dâ??une tâche
+cron <code>often</code>).</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
+#<a href="/devel/website/desc">webwml</a> soit depuis d'autres scripts,
+#comme ceux qui extraient les manuels de certains paquets.</p>
# <!-- Created: Mon Jul 6 19:58:09 BST 1998 -->
#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="bf1a0486dfbf35e11a7ff98a29d9e2e4f2eda3f3" maintainer="Jean-Paul Guillonneau"
# Translator:
# Mickael Simon, 2001-2003
# Frédéric Bothamy, 2005, 2007.
# Simon Paillard, 2008, 2009.
# David Prévot, 2010.
# Jean-Paul Guillonneau, 2018-2020
<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 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 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>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/git";>git</a></tt> sur votre propre
machine.</p>
<h3>Cloner anonymement un dépôt de Git (mode lecture seule)</h3>
<p>Utilisez cette commande pour télécharger tous les fichiers dâ??un seul projet :</p>
<p style="margin-left: 2em">
<code>git clone https://salsa.debian.org/ddp-team/release-notes.git</code>
</p>
<p>Faites de même pour chaque projet que vous voulez cloner localement.</p>
<h3>Cloner un dépôt Git avec les privilèges de mise à jour (mode lecture et écriture)</h3>
<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>
<p>Utilisez cette commande pour télécharger tous les fichiers dâ??un projet
particulier :</p>
<p style="margin-left: 2em">
<code>git clone git@salsa.debian.org:ddp-team/release-notes.git</code>
</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>git pull</code>
</p>
<toc-add-entry name="obtaining">Obtenir les privilèges de mise à jour</toc-add-entry>
<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>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>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>
<hr />
<toc-add-entry name="updates">Mécanisme de mise à jour automatique</toc-add-entry>
<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 toutes les quatre heures.</p>
<p>Le processus est réglé pour télécharger les dernières versions des paquets de
lâ??archive, reconstruire chaque manuel et installer les fichiers dans le
sous-répertoire <code>doc/manuals/</code> du site web.</p>
<p>Les fichiers de la documentation générés par le script de mise à jour sont
disponibles sur <a href="manuals/">https://www.debian.org/doc/manuals/</a>.</p>
<p>Les fichiers des journaux générés par le processus de mise à jour sont
disponibles sur <url "https://www-master.debian.org/build-logs/webwml/"; />
(le script sâ??appelle <code>7doc</code> et est exécuté dans le cadre dâ??une tâche
cron <code>often</code>).</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
#<a href="/devel/website/desc">webwml</a> soit depuis d'autres scripts,
#comme ceux qui extraient les manuels de certains paquets.</p>
# <!-- Created: Mon Jul 6 19:58:09 BST 1998 -->
commit bf1a0486dfbf35e11a7ff98a29d9e2e4f2eda3f3
Author: Holger Wansing <hwansing@mailbox.org>
Date: Fri Apr 17 09:42:49 2020 +0200
Updating info, how the /doc/manuals build process works
diff --git a/english/doc/vcs.wml b/english/doc/vcs.wml
index 0a313b05a24..452aab1fc88 100644
--- a/english/doc/vcs.wml
+++ b/english/doc/vcs.wml
@@ -83,21 +83,19 @@ one of its projects.
www-master.debian.org as part of the regular web site rebuilding process,
which happens every four hours.</p>
-<p>The script does a <kbd>svn export --force svn://svn.debian.org/svn/ddp/manuals</kbd>, and then
-<kbd>make -C trunk publish</kbd>.</p>
-
-<p>The makefile is set up to rebuild each subdirectory (that contains
-maintained documentation), and to install the files from each subdirectory
-in <code>doc/manuals/</code> subdirectory of the web site. The subdirectory
-makefiles are derived from <code>manuals/standard.makefile</code>.</p>
+<p>The process is set up to download the latest package versions from the
+archive, rebuild each manual, and install the files
+in <code>doc/manuals/</code> subdirectory of the web site.</p>
<p>The documentation files generated by the update script can be found at
<a href="manuals/">https://www.debian.org/doc/manuals/</a>.</p>
-<p>The log files generated by the update script can be found at
-<url "https://www-master.debian.org/build-logs/ddp/"; /></p>
+<p>The log files generated by the update process can be found at
+<url "https://www-master.debian.org/build-logs/webwml/"; />
+(the script is named <code>7doc</code> and is running as part of the
+<code>often</code> cron job).</p>
-<p>Note that this process regenerates the <code>/doc/manuals/</code>
-directory. The contents of the <code>/doc/</code> directory is generated
-either from <a href="/devel/website/desc">webwml</a> or from other scripts,
-such as those which extract certain manuals from their packages.</p>
+# <p>Note that this process regenerates the <code>/doc/manuals/</code>
+# directory. The contents of the <code>/doc/</code> directory is generated
+# either from <a href="/devel/website/desc">webwml</a> or from other scripts,
+# such as those which extract certain manuals from their packages.</p>
Reply to: