Bonjour,
Le 23/05/2022 à 11:33, Lucien Gentis a écrit :
Le 22/05/2022 à 23:50, Jean-Pierre Giraud a écrit :
Je ne joins pas le diff qui serait assez peu utile (il y a pas mal de
déplacements de tronçon de texte) mais plutôt l'ancienne version de
2020 (vcs_v0.wml). Merci d'avance pour vos relectures.
Bonjour,
Quelques détails et suggestions
Amicalement
Lucien
Je renvoie le fichier avec les modifications suggérées par bubu et
Lucien. Merci d'avance pour vos nouvelles relectures.
amicalement,
jipege
#use wml::debian::template title="Le dépôt VCS du projet de documentation Debian (système de contrôle de versions)"
#use wml::debian::translation-check translation="e6e987deba52309df5b062b1567c8f952d7bd476" maintainer="Jean-Pierre Giraud"
# Translator:
# Mickael Simon, 2001-2003
# Frédéric Bothamy, 2005, 2007.
# Simon Paillard, 2008, 2009.
# David Prévot, 2010.
# Jean-Paul Guillonneau, 2018-2021.
# Jean-Pierre Giraud, 2022
Accéder aux sources sur le dépôt Git
Obtenir les privilèges de mise à jour
Mécanisme de mise à jour automatique
Le
Projet de documentation Debian (DDP) stocke ses pages web et
la plupart des manuels sur https://salsa.debian.org;>Salsa, une
instance GitLab de Debian. Tout le monde peut télécharger les sources à partir
du service Salsa, mais seuls les membres du projet de documentation Debian y ont
accès en écriture et peuvent mettre à jour les fichiers.
Le Projet de documentation Debian stocke tous les contenus sur Salsa,
l'instance GitLab de Debian. Pour accéder aux différents fichiers, voir les
modifications récentes et l'activité du projet en général, veuillez visiter le
https://salsa.debian.org/ddp-team/;>dépôt du DDP.
Pour télécharger un manuel complet, un accès direct à Salsa est souvent la
meilleure solution. Les paragraphes suivants expliquent comment cloner un dépôt
Git (en lecture seule ou en lecture et écriture) sur votre machine et comment
mettre à jour votre copie locale. Avant de commencer, vous devez installer le
paquet https://packages.debian.org/git;>git sur votre
machine.
https://wiki.debian.org/Salsa;>Lire la documentation de Salsa
Cloner anonymement un dépôt Git (mode lecture seule)
Utilisez cette commande pour télécharger tous les fichiers d’un seul projet :
git clone https://salsa.debian.org/ddp-team/release-notes.git
Faites de même pour chaque projet que vous voulez cloner localement.
Astuce : Pour trouver l'URL correcte pour la commande
git clone, ouvrez le projet dans un navigateur web, cliquez sur le
bouton bleu Clone et copiez l'URL Clone with HTTPS dans votre
presse-papier.
Cloner un dépôt Git avec les privilèges de mise à jour (mode lecture et écriture)
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
solliciter la permission de mise à jour.
Avec un accès en écriture pour Salsa, vous pouvez utiliser cette commande pour
télécharger tous les fichiers d’un projet
particulier :
git clone g...@salsa.debian.org:ddp-team/release-notes.git
Faites de même pour chaque projet que vous voulez cloner localement.
Récupérer les modifications du dépôt distant de Git
Pour actualiser votre copie locale avec les modifications effectuées par
d'autres personnes, entrez dans les sous-répertoires respectifs du manuel et
lancez la commande :
git pull
Obtenir les privilèges de mise à jour
Les privilèges de mises à jour sont accordés à tous ceux qui désirent participer
à l’écriture des manuels, des FAQ, des guides pratiques, etc. Nous demandons
habituellement que vous ayez d’abord présenté quelques correctifs utiles. Après
cela, suivez ces étapes pour demander l'accès en écriture :
Créez un compte pour https://salsa.debian.org/;>Salsa si ce n'est pas déjà fait ;
Allez sur le https://salsa.debian.org/ddp-team/;>dépôt DDP et cliquez sur Request Access ;
Envoyez un courriel à la liste debian-...@lists.debian.org et dites-nous vos antécédents dans le projet Debian ;
Une fois votre requête acceptée, vous serez membre de l'équipe DDP.
Mécanisme de mise à jour automatique
Tous les manuels sont publiés comme des pages web générées automatiquement sur
www-master.debian.org dans le cadre du processus de reconstruction régulière du
site web qui se déroule toutes les quatre heures. Pendant ce processus, la
dernière version des paquets est téléchargée de l'archive, chaque manuel est
reconstruit et tous les fichiers sont transférés dans le sous-répertoire
doc/manuals/ du site web.
Les fichiers de la documentation générés par le script de mise à jour sont
disponibles sur https://www.debian.org/doc/manuals/.
Les fichiers des journaux générés par le processus de mise à jour sont
disponibles sur https://www-master.debian.org/build-logs/webwml/; />
(le script s’appelle 7doc et est exécuté dans le cadre d’une tâche
cron often).
# Notez que ce processus régénère le répertoire /doc/manuals/
# Le contenu du répertoire /doc/ est