Objectif : mettre à jour l’index archivelist.txt
Environnement : commandes svn via terminal
Si vous désirez voir publié dans la zone [1] la version paquet de votre contribution, il faut ajouter la ligne nécessaire dans le fichier archivelist.txt.
Ce fichier se trouve à la racine de la zone. Vous pouvez consulter archivelist.txt via votre navigateur préféré sur https://zone.spip.org/trac/spip-zone/browser.
La mise à jour de ce fichier nécessite l’emploi de svn, soit en ligne de commande (terminal), soit via une interface graphique.
C’est la mise en ligne via le terminal qui est illustrée ici.
Récupérer archivelist.txt
Il n’est pas nécessaire de récupérer le dépôt entier de plug-ins sur la zone pour mettre à jour le fichier archivelist.txt. Bien au contraire ! Pour vous en convaincre : consultez ce billet sur spip-zone.
Créez d’abord un répertoire d’accueil (répertoire de travail) sur votre disque dur :
cd Temp
mkdir trac
Allez dans ce répertoire :
cd trac
Récupérez les fichiers mais pas les répertoires présents à la racine de la zone :
svn checkout -N svn://zone.spip.org/spip-zone/ .
Notez le point final pour indiquer le répertoire courant en tant que répertoire de travail. L’option -N ou —non-recursive permet de récupérer uniquement le contenu du répertoire cible et pas celui de ses sous-dossiers.
Lister le contenu de votre répertoire de travail :
ls -las
Il doit ressembler à ceci :
total 48
0 drwxr-xr-x 5 me staff 170 10 aoû 12:00 .
0 drwxr-xr-x 44 me staff 1496 10 aoû 12:01 ..
0 drwxr-xr-x 7 me staff 238 10 aoû 11:48 .svn
8 -rw-r--r-- 1 me staff 1423 10 aoû 11:48 _REGLES_DE_COMMIT
40 -rw-r--r-- 1 me staff 19417 10 aoû 12:00 archivelist.txt
Le répertoire .svn ne doit pas être modifié.
Consultez le fichier _REGLES_DE_COMMIT pour précision.
Éditez le fichier archivelist.txt et effectuez votre modification. La plupart du temps, ce sera pour ajouter une contribution en suivant le guide présent en commentaire en début du fichier archivelist.txt.
Vous noterez au passage que les contributions sont classées par ordre alphabétique.
Après modification et enregistrement, quittez votre éditeur de texte et vérifiez le tout par la commande :
svn st
Logiquement, le résultat est :
M archivelist.txt
Le M indique que le fichier archivelist.txt a été modifié.
Si vous doutez de la modification apportée, vous pouvez lancer un diff pour comparer la version précédente et votre version modifiée :
svn diff
donne par exemple :
Index: archivelist.txt
===============================
--- archivelist.txt (révision 30781)
+++ archivelist.txt (copie de travail)
@@ -154,6 +154,7 @@
_plugins_/exclure_secteur/;exclure_secteur;
_plugins_/exif/;exif
+_plugins_/export_auteurs;export_auteurs
_plugins_/export_csv;export_csv
_plugins_/export_odt;export_odt_200_dev
tags/export_odt_192
La ligne qui commence par un signe plus (’+’) précise ici que cette ligne a été ajoutée.
Comme il est précisé plus haut, les contributions sont classées par ordre alphabétique. Dans l’exemple ci-dessus, export_odt est immédiatement suivi de export_odt_192. Le premier est dans le répertoire _plugins_, le second dans tags. Le fait de classer ainsi les contributions permet d’éviter les doublons.
Pour valider la modification sur le serveur de dépôt, il faut maintenant lancer la publication par une commande svn du style :
svn commit -m "Ajout du plugin export_auteurs"
L’option -m permet de loger votre action. De la décrire. En règle générale, complétez toujours un commit d’une description de votre action.
Le résultat de ce dernier appel donne quelque chose du genre :
Envoi archivelist.txt
Transmission des données .
Révision 30783 propagée.
Pour en savoir sur la commande svn entrez sous terminal :
svn help
Voir si besoin le site officiel de subversion/svn : http://subversion.tigris.org/
Gestion des erreurs
Il arrive parfois que le serveur réponde par un message du style :
svn: Échec de la propagation (commit), détails :
svn: Impossible de se connecter à l'hôte 'zone.spip.org': Connection refused
Ne pas s’inquiéter. Ça arrive parfois. Le serveur n’est pas disponible pour le moment. Re-essayez plus tard.
P.S : sour tortoise-svn sous windows, choisir un répertoire vide puis choisir « only file children » comme le montre la capture d’écran ci dessous
Aucune discussion
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Suivre les commentaires : |