Pré-requis

Vous devez avoir un compte Google. Créer un compte Google ou s'enregistrer.

Vous devez être membre du groupe dcplugins, pour cela envoyez un email à dcplugins chez googlegroups.com depuis votre compte Google ou depuis une autre adresse en précisant l'adresse email de votre compte Google.

Dans les commandes suivantes, MON_LOGIN désigne votre nom d'utilisateur Google. Lorsqu'on vous demande un mot de passe, entrez celui donné sur cette page.

Installer Subversion

Subversion est le logiciel qui permet de communiquer avec ce dépôt. Vous pouvez télécharger le logiciel adapté à votre système d'exploiration :

• Windows : TortoiseSVN
• Mac : ?
• Linux : installez svn

Déposer un nouveau plugin

Il faut importer tous les plugins (voir ci-dessous), créer le répertoire d'un plugin ou déplacer un répertoire existant puis envoyer les modifications (voir ci-dessous). Ensuite vous pouvez :

• modifier ce nouveau plugin dans son répertoire. Vous devrez vous placer dans le répertoire dcplugins pour utiliser svn
• importer seulement ce plugin (voir ci-dessous) dans un autre répertoire (par exemple dans le répertoire des plugins de votre installation Dotclear). Vous devrez vous placer dans le répertoire de ce nouveau plugin pour utiliser svn

En utilisant la deuxième méthode, vous pouvez modifier et tester un plugin à la fois.

Les commandes pour utiliser le dépôt

Importer les fichiers sur votre installation

Vous pouvez choisir d'importer tous les plugins ou seulement des plugins de votre choix. Ceci téléchargera le(s) plugin(s) dans le répertoire courant; par commodité, choisissez un répertoire qui restera accessible dans le temps.

Importer tous les plugins

svn checkout https://dcplugins.googlecode.com/svn/ dcplugins --username MON_LOGIN

Cela créera un répertoire dcplugins, contenant tous les plugins du dépôt.

Importer un plugin dans le répertoire courant

svn checkout https://dcplugins.googlecode.com/svn/PLUGIN --username MON_LOGIN

Ceci créera un répertoire PLUGIN, contenant le code du plugin PLUGIN. Il faudra alors se placer dans ce répertoire pour pouvoir utiliser svn.

Exemple :

svn checkout https://dcplugins.googlecode.com/svn/moreTpl --username MON_LOGIN

Modifier le plugin

Ajouter un nouveau fichier ou un nouveau répertoire à Subversion

svn add CHEMIN

Vous pouvez ajouter tous les fichier d'un coup :

svn add *

Exemple :

svn add monFichier.php

Déplacer un fichier ou un répertoire avec Subversion

svn mv ANCIEN_CHEMIN NOUVEAU_CHEMIN

Exemple :

svn mv monFichier.php monNouveauFichier.php

Effacer un nouveau fichier ou un nouveau répertoire de Subversion

svn remove CHEMIN

Exemple :

svn remove monFichier.php

Voir les changements

Voir les fichiers modifiés :

svn status

Voir les différences entre les versions des fichiers :

svn diff

Envoyer les modifications au dépôt

Avec un message tenant sur une ligne :

svn commit -m "un message expliquant les modifications"

Avec un message tenant sur plusieurs lignes :

svn commit

Ceci ouvrira l'éditeur de texte.

Bonus

Comparer 2 révision d'un plugin

Pour comparer la révision 177 (version 1.0.1) à la révision 228 (version 1.1) de Subscribe to comments :

svn diff -r 177:228 http://dcplugins.googlecode.com/svn/subscribeToComments