Mais LA zone n’est réellement accessible qu’en SVN (Subversion). SVN qui vous semble complexe, obscure, hermétique. Ou, plus simplement, plus généralement, vous n’avez pas le temps de vous plonger dans les HOW-TO, les TO-DO, les MAN et autres READ-ME, LISEZ-MOI, FAQ, INFO, ...
Publication SVN par l’exemple
Voici donc en quelques lignes l’illustration des commandes nécessaires à la publication sur la zone.
L’exemple est donné ici pour le plugin imaginaire mange_moi, outil croqué par notre ami Lewis (qui s’appelait en réalité Charles) au pays des merveilles.
Qu’importe ce que fait l’outil mange_moi ! Ce billet veut juste illustrer les quelques commandes employées pour
:
- créer un répertoire d’accueil sur le dépôt (le dépôt, c’est le serveur SVN qui conserve respectueusement toutes les versions des fichiers) ;
- créer un répertoire de travail. Le répertoire de travail est local, c’est-à-dire qu’il est présent sur votre disque dur ;
- ajouter un fichier à votre répertoire de travail ;
- publier ce fichier dans le répertoire de dépôt, et donc le rendre accessible à tous ;
- supprimer ce fichier ;
- supprimer le répertoire du projet sur le répertoire de dépôt.
Ce n’est donc qu’un simple exercice ! À vos claviers...
Pour des raisons pratiques, les liens SVN sont donnés sur le serveur de test.
Créez le répertoire du plugin sur le dépôt :
svn mkdir svn://trac.rezo.net/test/mange_moi
Le système demande le mot de passe :
Domaine d'authentification : <svn://trac.rezo.net:3690> 99a980e4-0c26-0410-a405-ef9ab5f6b07a
Mot de passe pour 'moi@foo.bar' :
Dans cet exemple, moi@foo.bar sera remplacé par votre adresse mail.
Entrez le mot de passe qui vous a été confié suite à votre demande/proposition de participation [1]. L’éditeur texte prend le relais (en général vi). Entrez un commentaire concernant l’action que vous venez d’effectuer puis quittez l’éditeur en sauvegardant.
Le système confirme la mise à jour :
Révision 341 propagée.
Créez le répertoire local, celui de votre projet :
mkdir mange_moi
Entrez dans votre répertoire de travail :
cd mange_moi
Faire une première mise à jour afin de créer les ressources locales à votre projet - les dossiers/fichiers .svn (notez le point à la fin de la ligne pour préciser que l’update doit être placé dans le répertoire courant) :
svn checkout svn://trac.rezo.net/test/mange_moi .
Le système confirme la mise à jour du répertoire local :
Révision 341 extraite.
Le répertoire est vide ? Normal ! Vous n’y avez encore rien déposé.
Vous souhaitez ajouter le fichier plugin.xml sur le répertoire de dépôt. Il faut d’abord demander à svn de le marquer comme fichier à envoyer, puis ensuite confirmer votre commande pour le dépôt.
Créez ou recopiez votre fichier plugin.xml dans le répertoire courant, puis marquez-le « à envoyer » :
svn add plugin.xml
Vérifiez le ou les fichiers ajoutés en attente de confirmation :
svn status
Le système répond dans cet exemple :
A plugin.xml
Le ’A’ veut dire ’add’ (ajouter). Le fichier plugin.xml est en attente d’envoi.
Confirmez l’ajout et envoyez ce fichier :
svn commit -m "ajout du fichier plugin.xml"
L’option -m indique que ce qui suit est le texte de commentaire pour l’action demandée.
Le système répond quelque chose du genre :
Révision 342 propagée.
Vous souhaitez maintenant supprimer ce dernier fichier. Il faut d’abord demander à svn de le marquer comme fichier à supprimer, puis ensuite confirmer votre commande pour le dépôt.
Marquez le fichier « à supprimer » :
svn delete plugin.xml
Le système répond :
D plugin.xml
Le ’D’ veut dire ’delete’ (supprimer). La suppression est en attente de confirmation.
Confirmez :
svn commit -m "suppression du fichier xml pour la démo"
Le système répond quelque chose du genre :
Révision 343 propagée.
Il ne reste plus qu’à supprimer le répertoire de test sur le dépôt :
svn delete svn://trac.rezo.net/test/mange_moi -m "supprimer ce bout de projet"
Le système répond quelque chose du genre :
Révision 344 propagée.
En quelques mots
Pas toujours souhaitable (lenteur du serveur, taille du projet très importante, hésitation sur le chemin de publication, etc.) il est parfois préférable d’utiliser la méthode « pas-à-pas » illustrée ci-dessus.
Par contre, si votre projet est composé de quelques fichiers, ou si vous êtes sûr de vous, il est possible d’importer directement l’ensemble du projet en une seule ligne de commande.
Placez-vous dans le répertoire de votre disque dur contenant le projet à recopier sur le dépôt, puis lancez :
svn import mange_moi svn://trac.rezo.net/test/mange_moi -m 'description du biscuit mange_moi'
Le premier mange_moi est le nom du répertoire présent dans votre répertoire courant. Le second, en fin d’URL, est celui de destination, créé automatiquement pour l’occasion.
Les adresses de dépôt
Dans les exemples ci-dessus, c’est le serveur de test svn ://trac.rezo.net/test qui est utilisé.
Cette adresse est à remplacer par :
- Pour les plugins :
svn://zone.spip.org/spip-zone/_plugins_
- Pour les squelettes :
svn://zone.spip.org/spip-zone/_squelettes_
et ainsi de suite (voir le browser de la zone pour en déduire les autres secteurs).
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 : |