diff --git a/lang/fr/docs/cvs.html b/lang/fr/docs/cvs.html new file mode 100644 index 00000000000..916ce8827c9 --- /dev/null +++ b/lang/fr/docs/cvs.html @@ -0,0 +1,160 @@ + +
+++ +CVS signifie 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.moodle.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
+++First, you need to download a completely fresh copy of Moodle using your + developer account.
+++1. Get TortoiseCVS from tortoisecvs.org + and install it, then reboot.
+
+
+ 2. Find or create a new folder somewhere where you want Moodle to be downloaded + to.
+
+ 3. Right-mouse-click that folder and choose "CVS Checkout" + from the menu. You should see a dialog box.
+
+ 4. Copy this text into the CVSROOT field (using your own username!):++:ext:myusername@cvs.moodle.sourceforge.net:/cvsroot/moodle++
+ 5. Press the button: "Fetch list...".
+
+ 6. To the right of the button you should see a list of modules: choose + "moodle" from that list.
+
+ 7. Press the button: "OK" and everything should + be downloaded.
+A dialog box should show all the files being downloaded, and after a while + you should have a complete copy of Moodle. After this first checkout, you + can fetch the latest updated files from the CVS server:
+++1. Right-mouse-click on your Moodle folder (or any file) and select + "CVS Update".
+
+After modifying files (you will note they change from green top red!), + you can commit them back to the CVS server like this:
+++1. Right-mouse-click on your Moodle folder (or any file) and select + "CVS Commit...".
+
+
+ 2. In the dialog box, type a clear description of the changes you are + committing.
+
+ 3. Click "OK". Your changes will be sent to the server.
++
Good luck!
++
Version: $Id$
+ +