mirror of
https://github.com/moodle/moodle.git
synced 2025-01-27 02:28:23 +01:00
159 lines
9.4 KiB
HTML
159 lines
9.4 KiB
HTML
<html>
|
||
<head>
|
||
<title>Documentation Moodle : Comment utiliser CVS ?</title>
|
||
<link rel="stylesheet" href="docstyles.css" type="TEXT/CSS">
|
||
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
|
||
</head>
|
||
<body bgcolor="#ffffff">
|
||
<h1>Utiliser CVS pour accéder au code de Moodle et le modifier</h1>
|
||
<blockquote>
|
||
<p>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 <a target="_top" href="http://www.sf.net/">Sourceforge</a>).</p>
|
||
<p>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 <a target="_top" href="http://moodle.org/download">Téléchargement
|
||
de Moodle</a>.</p>
|
||
<p>Pour utiliser l'<a target="_top"
|
||
href="http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/moodle/moodle/">archive CVS
|
||
de Moodle</a> (en tant que <a target="_top"
|
||
href="http://sourceforge.net/project/memberlist.php?group_id=30935">développeur
|
||
avec accès en écriture</a>), il vous faut avant tout un
|
||
<a href="http://sourceforge.net/account/register.php">compte sur
|
||
Sourceforge</a>. Dans les exemples de ce fichier, nous admettrons que votre
|
||
nom d'utilisateur est <strong><font color="#990000">myusername</font></strong>
|
||
et que votre mot de passe est <strong><font color="#990000">mypassword</font></strong>.
|
||
Lisez attentivement les instructions de Sourceforge (en anglais) <a target="_top"
|
||
href="http://sourceforge.net/docman/display_doc.php?docid=768&group_id=1#develhomedir">create
|
||
your CVS home directory</a> - 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.</p>
|
||
<p>Dès que vous avez un compte Sourceforge actif, contactez
|
||
<a target="_top" href="http://moodle.org/user/view.php?id=1&course=1">Martin Dougiamas</a>
|
||
pour qu'il puisse vous donner les droits en écriture sur certains dossiers
|
||
de Moodle.</p>
|
||
<p>Pour éviter de devoir taper <strong><font color="#990000">mypassword</font></strong>
|
||
chaque fois que vous lancez une commande CVS, suivez les
|
||
<a target="_top" href="http://sourceforge.net/account/editsshkeys.php">instructions de
|
||
Sourceforge pour l'utilisation de clefs d'autorisation</a> (en anglais).
|
||
Cette étape n'est pas obligatoire, mais elle rend votre travail avec CVS bien
|
||
plus agréable et productive.</p>
|
||
<p>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.</p>
|
||
<h2>1. Utilisation de CVS sur Unix</h2>
|
||
<blockquote>
|
||
<p>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 » :</p>
|
||
<blockquote>
|
||
<pre><strong>setenv CVS_RSH ssh</strong> (pour csh, tcsh, etc.)</pre>
|
||
<pre><strong>export CVS_RSH=ssh</strong> (pour sh, bash, etc.)</pre>
|
||
</blockquote>
|
||
<p>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) :</p>
|
||
<blockquote>
|
||
<pre><strong>cvs -z3 -d:ext:myusername@cvs.moodle.sourceforge.net:/cvsroot/moodle co moodle</strong></pre>
|
||
</blockquote>
|
||
<p>Ne tentez pas de lancer cette premi<6D>re commande CVS depuis un dossier de Moodle
|
||
pr<70>existant. Commencez avec un nouveau dossier vide.</p>
|
||
<p>Vous devrez taper <strong><font color="#990000">mypassword</font></strong>
|
||
pour chaque commande, à moins que vous ne mettiez en place des <a target="_top"
|
||
href="http://sourceforge.net/account/editsshkeys.php">clefs autorisées</a>.</p>
|
||
<p>À 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 :</p>
|
||
<blockquote>
|
||
<pre><strong>cd moodle</strong></pre>
|
||
</blockquote>
|
||
<p>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 :</p>
|
||
<blockquote>
|
||
<pre><strong>cvs diff -c config-dist.php
|
||
cvs diff -c lang</strong></pre>
|
||
</blockquote>
|
||
<p>Pour récupérer les dernières mises à jour de Moodle, tapez :</p>
|
||
<blockquote>
|
||
<pre><strong>cvs update -dP</strong> </pre>
|
||
</blockquote>
|
||
<p>Pour transférer vos nouveaux fichiers sur le serveur, vous devrez taper
|
||
quelque chose comme :</p>
|
||
<blockquote>
|
||
<pre><strong>cd lang/fr
|
||
cvs commit</strong> </pre>
|
||
</blockquote>
|
||
<p>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 !</p>
|
||
<p>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 :</p>
|
||
<blockquote>
|
||
<pre><strong>diff -c
|
||
update -dP</strong> </pre>
|
||
</blockquote>
|
||
<p>Taper « cvs help » pour plus de détails ... </p>
|
||
<p> </p>
|
||
</blockquote>
|
||
<h2>2. Utilisation de CVS sous Windows</h2>
|
||
<blockquote>
|
||
<p>Pour commencer, il vous faut télécharger une copie complète de Moodle avec
|
||
votre compte développeur.</p>
|
||
<blockquote>
|
||
<p>1. Téléchargez TortoiseCVS depuis le site
|
||
<a target="_top" href="http://www.tortoisecvs.org/">tortoisecvs.org</a>
|
||
et installez-le, puis redémarrez votre machine.<br /><br />
|
||
2. Trouvez ou créez un nouveau dossier dans lequel vous allez télécharger
|
||
Moodle.<br /><br />
|
||
3. Cliquez avec le bouton droit de la souris et sélectionnez dans le menu l'option
|
||
« <strong>CVS Checkout</strong> ». Une boîte de dialogue s'affiche
|
||
alors.<br /><br />
|
||
4. Copiez le texte ci-dessous dans le champ CVSROOT (en y plaçant votre
|
||
nom d'utilisateur !) :</p>
|
||
<blockquote>
|
||
<pre>:ext:<font color="#990000">myusername</font>@cvs.moodle.sourceforge.net:/cvsroot/moodle</pre>
|
||
</blockquote>
|
||
<p>
|
||
5. Cliquez sur le bouton « <strong>Fetch list...</strong> ».<br /><br />
|
||
6. Une liste de modules est affichée à droite du bouton : sélectionnez-y
|
||
« <strong>moodle</strong> ».<br /><br />
|
||
7. Cliquez sur le bouton « <strong>OK</strong> » tout sera alors
|
||
téléchargé.</p>
|
||
</blockquote>
|
||
<p>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 :</p>
|
||
<blockquote>
|
||
<p>1. Cliquez avec le bouton droit de la souris sur votre dossier Moodle (ou
|
||
sur n'importe quel fichier) et sélectionnez « <strong>CVS Update</strong> ».</p>
|
||
</blockquote>
|
||
<p>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 :</p>
|
||
<blockquote>
|
||
<p>1. Cliquez avec le bouton droit de la souris sur votre dossier Moodle (ou
|
||
sur n'importe quel fichier) et sélectionnez « <strong>CVS
|
||
Commit...</strong> ».<br /><br />
|
||
2. Dans la boîte de dialogue, taper une description claire des changements
|
||
que vous avez effectués.<br /><br />
|
||
3. Cliquez « OK ». Vos modifications sont alors envoyées vers
|
||
le serveur CVS.</p>
|
||
</blockquote>
|
||
</blockquote>
|
||
<p> </p>
|
||
<p align="center">Bonne chance !</p>
|
||
<p> </p>
|
||
</blockquote>
|
||
<p align="CENTER"><font size="1"><a href="." target="_top">Documentation Moodle</a></font></p>
|
||
<p align="CENTER"><font size="1">Version: $Id$</font></p>
|
||
</body>
|
||
</html>
|