Documentation Moodle : Comment utiliser CVS ?

# Utiliser CVS pour accéder au code de Moodle et le modifier

> CVS est un acronyme pour « Concurrent Versioning System ». C'est une façon pratique stoquer le code source, car elle permet de conserver les versions de tous les fichiers de sorte que rien n'est jamais perdu, et que les traces de l'utilisation par les différentes personnes sont conservées. Le système offre en outre la possibilité de fusionner le code si deux ou plusieurs personnes travaillent sur un même fichier. Tout le code et toutes les versions sont enregistrées sur un serveur central (dans le cas de Moodle, sur Sourceforge).

> Si vous désirez accéder à la version actuelle de Moodle par CVS avec un accès en lecture seule, vous n'avez pas besoin de cette page. Il vous suffit de suivre les instructions (plus simples) pour CVS sur la page Téléchargement de Moodle.

> Pour utiliser l'archive CVS de Moodle (en tant que développeur avec accès en écriture), il vous faut avant tout un compte sur Sourceforge. Dans les exemples de ce fichier, nous admettrons que votre nom d'utilisateur est myusername et que votre mot de passe est mypassword. Lisez attentivement les instructions de Sourceforge (en anglais) create your CVS home directory - une procédure que vous devez faire pour chaque nouveau compte pour l'activer en vue de CVS. Il s'agit en gros de vous connecter en ssh à l'adresse cvs.sourceforge.net.

> Dès que vous avez un compte Sourceforge actif, contactez Martin Dougiamas pour qu'il puisse vous donner les droits en écriture sur certains dossiers de Moodle.

> Pour éviter de devoir taper mypassword chaque fois que vous lancez une commande CVS, suivez les instructions de Sourceforge pour l'utilisation de clefs d'autorisation (en anglais). Cette étape n'est pas obligatoire, mais elle rend votre travail avec CVS bien plus agréable et productive.

> Une fois cela fait, vous devriez avoir toutes les autorisations nécessaires, et vous pouvez configurer votre machine et télécharger les sources actuelles poiur y travailler. Vous trouverez ci-dessous pour les systèmes Unix et Windows.

> ## 1. Utilisation de CVS sur Unix

> > Le CVS de Sourceforge utilise ssh comme couche de transport pour la sécurité. Vous devrez donc configurer ainsi la variable d'environnement CVS_RSH dans votre « shell » :

> > >     setenv CVS_RSH ssh (pour csh, tcsh, etc.)

> > >     export CVS_RSH=ssh (pour sh, bash, etc.)

> > Une possibilité est de placer cette commande dans votre .bashrc ou .cshrc afin que vous n'ayez pas à la retaper tout le temps. Ensuite, vous devrez effectuer un « check out » de Moodle avec la commande ci-dessous (sur une seule ligne) :

> > >     cvs -z3 -d:ext:myusername@cvs.sourceforge.net:/cvsroot/moodle co moodle

> > Ne tentez pas de lancer cette première commande CVS depuis un dossier de Moodle préexistant. Commencez avec un nouveau dossier vide.

> > Vous devrez taper mypassword pour chaque commande, à moins que vous ne mettiez en place des clefs autorisées.

> > À ce stade, vous devriez avoir un nouveau dossier « moodle ». Vous pouvez changer son nom et le déplacer, si vous le voulez. Placez-vous dans ce dossier :

> > >     cd moodle

> > Les toutes dernières versions des fichiers de Moodle devrait y être. Vous pouvez modifier les fichiers de votre copie. Pour comparer vos fichiers avec ceux du serveur CVS, utilisez cvs diff, par exemple :

> > >     cvs diff -c config-dist.php
> > >     cvs diff -c lang

> > Pour récupérer les dernières mises à jour de Moodle, tapez :

> > >     cvs update -dP

> > Pour transférer vos nouveaux fichiers sur le serveur, vous devrez taper quelque chose comme :

> > >     cd lang/fr
> > >     cvs commit

> > Vous devrez taper un commentaire. Votre éditeur de texte s'ouvrira. Écrivez quelque chose qui ait un sens et fermer l'éditeur de texte. Les fichiers seront envoyés chez Sourceforge et enregistrés. C'est tout !

> > Pour vous économiser du temps, vous pouvez placer les arguments par défaut dans un fichier appelé .cvsrc dans votre répertoire de départ. Par exemple, le mien contient :

> > >     diff -c
> > >     update -dP

> > Taper « cvs help » pour plus de détails ...

> ## 2. Utilisation de CVS sous Windows

> > Pour commencer, il vous faut télécharger une copie complète de Moodle avec votre compte développeur.

> > > 1. Téléchargez TortoiseCVS depuis le site tortoisecvs.org et installez-le, puis redémarrez votre machine.
> > > 2. Trouvez ou créez un nouveau dossier dans lequel vous allez télécharger Moodle.
> > > 3. Cliquez avec le bouton droit de la souris et sélectionnez dans le menu l'option « CVS Checkout ». Une boîte de dialogue s'affiche alors.
> > > 4. Copiez le texte ci-dessous dans le champ CVSROOT (en y plaçant votre nom d'utilisateur !) :

> > > >     :ext:myusername@cvs.sourceforge.net:/cvsroot/moodle

> > > 5. Cliquez sur le bouton « Fetch list... ».
> > > 6. Une liste de modules est affichée à droite du bouton : sélectionnez-y « moodle ».
> > > 7. Cliquez sur le bouton « OK » tout sera alors téléchargé.

> > Une boîte de dialogue affichera tous les fichiers en cours de téléchargement, et après quelques instants vous aurez votre copie complète de Moodle. Après ce premier « check out », vous pourrez récupérer les derniers fichiers modifiés sur le serveur CVS :

> > > 1. Cliquez avec le bouton droit de la souris sur votre dossier Moodle (ou sur n'importe quel fichier) et sélectionnez « CVS Update ».

> > Après une modification de fichier (vous remarquerez que la couleur change de vert à rouge), vous pouvez les déposer sur le serveur CVS de la façon suivante :

> > > 1. Cliquez avec le bouton droit de la souris sur votre dossier Moodle (ou sur n'importe quel fichier) et sélectionnez « CVS Commit... ».
> > > 2. Dans la boîte de dialogue, taper une description claire des changements que vous avez effectués.
> > > 3. Cliquez « OK ». Vos modifications sont alors envoyées vers le serveur CVS.

> Bonne chance !

Documentation Moodle

Version: $Id$