Si vous désirez simplement télécharger par CVS la version actuelle de Moodle pour lancer un site, vous n'avez pas besoin de cette page. Il vous suffit de suivre les instructions (plus simples) pour télécharger Moodle par CVS sur la page <a target="_top" href="http://moodle.org/download">Téléchargement de Moodle</a>.
</p>
- <h2><a name="1"></a>Thèmes de ce document</h2>
+ <h2>Thèmes de ce document</h2>
<ol>
<li>
- <a href="#1">Rejoindre le projet en tant que développeur</a>
+ <a href="#sec1">Rejoindre le projet en tant que développeur</a>
</li>
<li>
- <a href="#2">Modules CVS</a>
+ <a href="#sec2">Modules CVS</a>
</li>
<li>
- <a href="#3">Commandes CVS de base</a>
+ <a href="#sec3">Commandes CVS de base</a>
<br />
- 3.1. <a href="#3.1">CVS sur Unix ou Mac OS X</a>
+ 3.1. <a href="#sec3.1">CVS sur Unix ou Mac OS X</a>
<br />
- 3.2. <a href="#3.2">CVS sous Windows</a>
+ 3.2. <a href="#sec3.2">CVS sous Windows</a>
</li>
<li>
- <a href="#4">Travailler avec des branches</a>
+ <a href="#sec4">Travailler avec des branches</a>
<br />
- 4.1. <a href="#4.1">Développement du tronc</a>
+ 4.1. <a href="#sec4.1">Développement du tronc</a>
<br />
- 4.2. <a href="#4.2">Branches stables pour chaque version</a>
+ 4.2. <a href="#sec4.2">Branches stables pour chaque version</a>
<br />
- 4.3. <a href="#4.3">Branches particulières pour tout changement important</a>
+ 4.3. <a href="#sec4.3">Branches particulières pour tout changement important</a>
</li>
</ol>
<p>
</p>
- <h2><a name="1" id="1"></a>1. Rejoindre le projet en tant que développeur</h2>
+ <h2><a name="sec1" id="sec1"></a>1. Rejoindre le projet en tant que développeur</h2>
<blockquote>
<p>On vient de vous proposer un accès en écriture au CVS pour vous permettre de nous aider à développer et à maintenir Moodle ? <a href="http://sourceforge.net/project/memberlist.php?group_id=30935">Bienvenue au club</a> !</p>
<p>Pour avoir l'autorisation d'écrire dans l'<a target="_top" href="http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/moodle/moodle/">archive CVS de Moodle</a>, il vous faut avant tout un compte sur Sourceforge (<a href="http://sourceforge.net/account/register.php">l'enregistrement</a> est simple et gratuit). Nous admettrons pour les exemples de ce texte que votre nom d'utilisateur chez Sourceforge 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) pour <a target="_top" href="http://sourceforge.net/docman/display_doc.php?docid=768&group_id=1#develhomedir">créer votre dossier CVS initial</a> (home directory) — une procédure que vous devez faire pour chaque nouveau dossier en vue de l'utiliser avec le CVS. Il s'agit simplement de vous connecter à l'adresse cvs.sourceforge.net via le protocole SSH.
</p>
<p> </p>
</blockquote>
- <h2><a name="2" id="2"></a>2. Modules CVS</h2>
+ <h2><a name="sec2" id="sec2"></a>2. Modules CVS</h2>
<blockquote>
<p>
Dans le jargon de CVS, les « Module » sont des collections séparées de code. Moodle possède les modules suivants :
</p>
<p> </p>
</blockquote>
- <h2><a name="3" id="3"></a>3. Commandes CVS de base</h2>
+ <h2><a name="sec3" id="sec3"></a>3. Commandes CVS de base</h2>
<blockquote>
- <h3><a name="3.1" id="3.1"></a>3.1 CVS sur Unix ou Mac OS X</h3>
+ <h3><a name="sec3.1" id="sec3.1"></a>3.1 CVS sur Unix ou Mac OS X</h3>
<blockquote>
<p>
Le CVS de Sourceforge utilise SSH comme couche de transport pour la sécurité. Vous devrez donc configurer la variable d'environnement CVS_RSH dans votre « shell » comme ci-dessous. Le mieux est de placer cette commande dans votre .bashrc ou .cshrc afin que vous n'ayez pas à la retaper tout le temps :
</p>
<p> </p>
</blockquote>
- <h3><a name="3.2" id="3.2"></a>3.2 CVS sous Windows</h3>
+ <h3><a name="sec3.2" id="sec3.2"></a>3.2 CVS sous Windows</h3>
<blockquote>
<p>
Pour commencer, il vous faut télécharger une copie complète de Moodle avec votre compte développeur.
</ol>
<p> </p>
</blockquote>
- <h2><a name="4" id="4"></a>4. Travailler avec des branches</h2>
+ <h2><a name="sec4" id="sec4"></a>4. Travailler avec des branches</h2>
<blockquote>
<p>Le diagramme suivant montre comment le module principal <strong>moodle</strong> se ramifie en plusieurs versions (branches) au cours du temps.</p>
<p align="center"><img src="pix/cvstree.png" width="500" height="200" alt="cvstree" /></p>
<li>Il n'est pas autorisé de changer le nom des balises, car des développeurs comptent dessus ! Tapez-les donc correctement du premier coup.</li>
</ul>
<p> </p>
- <h3><a name="4.1" id="4.1"></a>4.1 Développement du tronc</h3>
+ <h3><a name="sec4.1" id="sec4.1"></a>4.1 Développement du tronc</h3>
<blockquote>
<p>Dans le jargon CVS, le <strong>tronc</strong> (trunk) est la version principale en développement de Moodle. Elle est aussi appelée <span class="style4">HEAD</span>, ou encore branche par défaut.</p>
<p>Les développeurs de Moodle font en sorte que le tronc reste aussi stable que possible, mais il contient d'habitude du nouveau code, avec des bogues et de petites instabilités.</p>
<p> </p>
- <h3><a name="4.2" id="4.2"></a>4.2 Branches stables pour chaque version</h3>
+ <h3><a name="sec4.2" id="sec4.2"></a>4.2 Branches stables pour chaque version</h3>
<blockquote>
<p>Dès que la branche stable <span class="style3">MOODLE_XX_STABLE</span> est créée, les efforts de développement se divisent temporairement en deux. Certains développeurs continuent à travailler sur de nouvelles fonctionnalités du tronc pour les prochaines versions, mais la plupart d'entre eux se concentrent sur la branche <span class="style1"><strong>STABLE</strong></span> actuelle et corrigent les bogues qui y sont découverts.</p>
<p>Vous pouvez faire en sorte que votre copie locale de Moodle soit en synchronisation avec la version STABLE en tapant la commande unix suivante depuis le dossier principal de Moodle :</p>
<p>Enfin, les valeurs des variables <strong>$version</strong> de tous les fichiers « version.php » de Moodle de la branche stable ne doivent pas être mis à jour si possible (à part le dernier chiffre si nécessaire). La raison en est que si quelqu'un fait une mise à jour d'une version très stable à la version très stable suivante, il pourrait sans cela manquer une mise à jour arrivée sur le tronc.</p>
</blockquote>
<p> </p>
- <h3><a name="4.3" id="4.3"></a>4.3 Branches particulières pour tout changement important</h3>
+ <h3><a name="sec4.3" id="sec4.3"></a>4.3 Branches particulières pour tout changement important</h3>
<blockquote>
<p>Occasionnellement, il est nécessaire d'incorporer une nouvelle fonctionnalité afin que plusieurs développeurs puissent y travailler ensemble, même si elle est encore trop instable pour être incorporée dans le tronc.</p>
<p>Dans ces cas, une branche temporaire est créée pour travailler sur la fonctionnalité, puis incorporée au tronc principal dès que possible. Un exemple de branche appelée <span class="style1"><strong>MOODLE_14_WIDGET</strong></span> peut être vu sur le diagramme ci-dessus.</p>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html>
+
<head>
- <title>Documentation Moodle : Mise à jour</title>
+ <title>Documentation Moodle : Mise à jour</title>
<link rel="stylesheet" href="docstyles.css" type="text/css" />
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
</head>
<body bgcolor="#ffffff">
-<h1>Mise à jour de Moodle</h1>
+
+<h1>Mise à jour de Moodle</h1>
+
+<blockquote>
+
+<p>Moodle est conçu pour être mis à jour sans difficulté de n'importe quelle version plus ancienne à une version ultérieure.</p>
+
+<p>Pour mettre à jour une installation de Moodle, veuillez suivre ces étapes :</p>
+
+<h3 class="sectionheading">1. Faites une copie de sauvegarde (backup) des données importantes</h3>
+
+<blockquote>
+
+<p>Bien que cela ne soit pas strictement nécessaire, c'est toujours une bonne idée de faire une copie de sauvegarde d'un système en production avant une mise à jour importante, au cas o_ vous auriez besoin de revenir à l'ancienne version. En fait, une meileure idée serait l'automatisation de la sauvegarde journalière de votre installation de Moodle sur votre serveur. Vous pourrez ainsi sauter cette étape.</p>
+
+<p>Trois zones nécessitent une copie de sauvegarde :</p>
+
+<blockquote>
+
+<p><strong>1. Le dossier contenant le logiciel Moodle</strong></p>
+
+<blockquote>
+
+<p>Faites une copie séparée de ces fichiers avant la mise à jour. Vous pourrez ainsi retrouver votre config.php et les modules que vous aurez ajoutés, comme les thèmes, les langues, etc.</p>
+
+</blockquote>
+
+<p><strong>2. Votre dossier de données</strong></p>
+
+<blockquote>
+
+<p>C'est là que sont placés les fichiers déposés (ressources de cours, devoirs d'étudiants, etc.). Il est donc très important d'avoir une copie de ces fichiers. Parfois, la mise à jour pourra déplacer ou renommer les dossiers à l'intérieur de votre dossier de données.</p>
+
+</blockquote>
+
+<p><strong>3. Votre base de données</strong></p>
+
+<blockquote>
+
+<p>La plupart des mises à jour de Moodle modifient les tables de la base de données, en y ajoutant ou changeant certains champs. Chaque gestionnaire de base de données possède plusieurs façons de faire des copies de sauvegarde. Avec MySQL, on peut par exemple faire un « dump » de la base de données dans un fichier SQL. L'exemple suivant montre les commandes Unix pour effecteur cette opération avec une base de données appelée « moodle » :</p>
+
+<p class="commandline">mysqldump moodle > moodle-backup-2002-10-26.sql</p>
+
+<p>Vous pouvez aussi utiliser la fonction « Exportation » de l'interface web optionnelle « Base de données » de Moodle, pour effectuer cela sur toutes les plateformes.</p>
+
+</blockquote>
+
+</blockquote>
+
+</blockquote>
+
+<h3 class="sectionheading">2. Installez la nouvelle version de Moodle</h3>
<blockquote>
- <p>Moodle est conçu pour être mis à jour sans difficulté de n'importe quelle
- version plus ancienne à une version ultérieure.</p>
- <p>Pour mettre à jour une installation de Moodle, veuillez suivre ces étapes :</p>
- <h3 class="sectionheading">1. Faites une copie de sauvegarde (backup) des données importantes</h3>
- <blockquote>
- <p>Bien que cela ne soit pas strictement nécessaire, c'est toujours une bonne idée
- de faire une copie de sauvegarde d'un système en production avant une mise à jour
- importante, au cas o_ vous auriez besoin de revenir à l'ancienne version. En fait,
- une meileure idée serait l'automatisation de la sauvegarde journalière de votre installation
- de Moodle sur votre serveur. Vous pourrez ainsi sauter cette étape.</p>
- <p>Trois zones nécessitent une copie de sauvegarde :</p>
- <blockquote>
- <p><strong>1. Le dossier contenant le logiciel Moodle</strong></p>
- <blockquote>
- <p>Faites une copie séparée de ces fichiers avant la mise à jour. Vous pourrez
- ainsi retrouver votre config.php et les modules que vous aurez ajoutés, comme
- les thèmes, les langues, etc.</p>
- </blockquote>
- <p><strong>2. Votre dossier de données</strong></p>
- <blockquote>
- <p>C'est là que sont placés les fichiers déposés (ressources de cours, devoirs
- d'étudiants, etc.). Il est donc très important d'avoir une copie de ces fichiers.
- Parfois, la mise à jour pourra déplacer ou renommer les dossiers à l'intérieur de
- votre dossier de données.</p>
- </blockquote>
- <p><strong>3. Votre base de données</strong></p>
- <blockquote>
- <p>La plupart des mises à jour de Moodle modifient les tables de la base de
- données, en y ajoutant ou changeant certains champs. Chaque gestionnaire de base
- de données possède plusieurs façons de faire des copies de sauvegarde. Avec MySQL,
- on peut par exemple faire un « dump » de la base de données dans un fichier
- SQL. L'exemple suivant montre les commandes Unix pour effecteur cette opération
- avec une base de données appelée « moodle » :</p>
- <blockquote>
- <p><font face="Courier New, Courier, mono">mysqldump moodle > moodle-backup-2002-10-26.sql</font></p>
- </blockquote>
- <p>Vous pouvez aussi utiliser la fonction « Exportation » de l'interface web
- optionnelle « Base de données » de Moodle, pour effectuer cela sur toutes
- les plateformes.</p>
- <p> </p>
- </blockquote>
- </blockquote>
- </blockquote>
- <h3 class="sectionheading">2. Installez la nouvelle version de Moodle</h3>
- <blockquote>
- <p><strong>Avec un fichier compressé téléchargé</strong></p>
- <blockquote>
- <p>N'écrasez pas une ancienne installation de Moodle, à moins de savoir ce que
- vous faites... D'anciens fichiers peuvent en effet poser problème dans une
- nouvelle installation. Le mieux est de renommer votre dossier Moodle actuel,
- puis de décompresser la nouvelle version de Moodle à la place de l'ancienne.</p>
- <blockquote>
- <p><font face="Courier New, Courier, mono">mv moodle moodle.backup<br />
- tar xvzf moodle-1.1.tgz</font></p>
- </blockquote>
- <p>Ensuite, copiez dans le nouveau dossier votre config.php et les autres
- extensions, tels que vos thèmes personnalisés :</p>
- <blockquote>
- <p><font face="Courier New, Courier, mono">cp moodle.backup/config.php moodle<br />
- cp -pr moodle.backup/theme/mytheme moodle/theme/mytheme</font></p>
- </blockquote>
- </blockquote>
- <p><strong>En utilisant CVS</strong></p>
- <blockquote>
- <p>Si vous utilisez CVS, placez-vous dans le dossier racine de Moodle et mettez à
- jour les anciens fichiers :</p>
- <blockquote>
- <p><font face="Courier New, Courier, mono">cvs update -dP</font></p>
- </blockquote>
- <p>Assurez-vous d'utiliser le paramètre « d » pour créer si nécessaire
- les nouveaux dossiers, ainsi que le paramètre « P » pour vous
- débarrasser des dossiers vides.</p>
- <p>Si vous avez modifié des fichiers de Moodle, observez très attentivement les
- messages retournés lors de la mise à jour, afin de détecter d'éventuels
- conflits. Tous vos thèmes personnalisés et ajouts non standard ne seront
- pas touchés.</p>
- </blockquote>
- <p> </p>
- </blockquote>
- <h3 class="sectionheading">3. Finalisez la mise à jour</h3>
- <blockquote>
- <p>La dernière étape consiste à déclencher le processus de mise à jour dans
- Moodle.</p>
- <p>Pour le faire, visitez simplement <a target="_top" href="../admin/index.php">la page
- d'administration de votre installation</a>.</p>
- <blockquote>
- <p><font face="Courier New, Courier, mono">http://example.com/moodle/admin</font></p>
- </blockquote>
- <p>Il n'est pas nécessaire que vous soyez connecté en tant qu'administrateur.</p>
- <p>Moodle détectera automatiquement la nouvelle version et effectuera toutes les mises
- à jour nécessaires sur la base de données et sur les fichiers. S'il est incapable
- d'effectuer une opération tout seul (très rarement), des messages s'afficheront qui
- vous indiqueront les opérations à effectuer.</p>
- </blockquote>
- <p> </p>
- <p>Si tout se passe sans problème (pas de message d'erreur), vous pouvez utiliser tout
- de suite votre nouvelle version de Moodle et ses nouvelles fonctionnalités !
- version of Moodle and enjoy the new features!</p>
- <p>En cas de problèmes avec la mise à jour, visitez le site <a target="_top"
- href="http://moodle.org/">moodle.org</a> et postez un message sur le forum
- <a target="_top" href="http://moodle.org/mod/forum/view.php?id=28">Installation
- Support Forum</a> du cours Using Moodle.</p>
+
+<p><strong>Avec un fichier compressé téléchargé</strong></p>
+
+<blockquote>
+
+<p>N'écrasez pas une ancienne installation de Moodle, à moins de savoir ce que vous faites... D'anciens fichiers peuvent en effet poser problème dans une nouvelle installation. Le mieux est de renommer votre dossier Moodle actuel, puis de décompresser la nouvelle version de Moodle à la place de l'ancienne.</p>
+
+<p class="commandline">mv moodle moodle.backup<br /> tar xvzf moodle-1.1.tgz</p>
+
+<p>Ensuite, copiez dans le nouveau dossier votre config.php et les autres extensions, tels que vos thèmes personnalisés :</p>
+
+<p class="commandline">cp moodle.backup/config.php moodle<br /> cp -pr moodle.backup/theme/mytheme moodle/theme/mytheme</p>
+
+</blockquote>
+
+<p><strong>En utilisant CVS</strong></p>
+
+<blockquote>
+
+<p>Si vous utilisez CVS, placez-vous dans le dossier racine de Moodle et mettez à jour les anciens fichiers :</p>
+
+<p class="commandline">cvs update -dP</p>
+
+<p>Assurez-vous d'utiliser le paramètre « d » pour créer si nécessaire les nouveaux dossiers, ainsi que le paramètre « P » pour vous débarrasser des dossiers vides.</p>
+
+<p>Si vous avez modifié des fichiers de Moodle, observez très attentivement les messages retournés lors de la mise à jour, afin de détecter d'éventuels conflits. Tous vos thèmes personnalisés et ajouts non standard ne seront pas touchés.</p>
+
</blockquote>
-<p> </p>
-<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>
+
+</blockquote>
+
+<h3 class="sectionheading">3. Finalisez la mise à jour</h3>
+
+<blockquote>
+
+<p>La dernière étape consiste à déclencher le processus de mise à jour dans
+Moodle.</p>
+
+<p>Pour le faire, visitez simplement <a target="_top" href="../admin/index.php">la page
+d'administration de votre installation</a>.</p>
+
+<p class="examplecode">http://example.com/moodle/admin</p>
+
+<p>Il n'est pas nécessaire que vous soyez connecté en tant qu'administrateur.</p>
+
+<p>Moodle détectera automatiquement la nouvelle version et effectuera toutes les mises
+à jour nécessaires sur la base de données et sur les fichiers. S'il est incapable
+d'effectuer une opération tout seul (très rarement), des messages s'afficheront qui
+vous indiqueront les opérations à effectuer.</p>
+
+</blockquote>
+
+<p> </p>
+
+<p>Si tout se passe sans problème (pas de message d'erreur), vous pouvez utiliser tout de suite votre nouvelle version de Moodle et ses nouvelles fonctionnalités ! version of Moodle and enjoy the new features!</p>
+
+<p>En cas de problèmes avec la mise à jour, visitez le site <a target="_top" href="http://moodle.org/">moodle.org</a> et postez un message sur le forum
+
+<a target="_top" href="http://moodle.org/mod/forum/view.php?id=28">Installation Support Forum</a> du cours Using Moodle.</p>
+
+</blockquote>
+
+<p> </p>
+
+<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>
\ No newline at end of file
projects / moodle.git / commitdiff