--- /dev/null
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<title>Guide de traduction de Moodle</title>
+<link rel="stylesheet" href="docstyles.css" type="TEXT/CSS">
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+</head>
+
+<body style="background-color: #ffffff;">
+
+<h1>Guide de traduction de Moodle</h1>
+
+<p>La traduction de Moodle n'est pas si difficile. Avant de commencer, il est cependant sage de connaître certaines choses.</p>
+
+<h2>Structure des fichiers de langue de Moodle</h2>
+
+<p style="margin-left: 40px;">Les différentes traductions sont situées dans le dossier <strong>lang</strong>, chaque langue dans un dossier unique dont le nom est le même que celui de l'abbréviation de la langue : fr, fr_CA, en, de, it, es, ...</p>
+
+<p style="margin-left: 40px;">Les fichiers principaux sont situés directement dans ce dossier, et se terminent tous l'extension « .php », par exemple moodle.php, resource.php, etc. Ces fichiers contiennent des expressions plus ou moins courtes, appelées le plus souvent « <em>chaînes de caractères</em> » ou tout simplement « <em>chaînes</em> ».</p>
+
+<p style="margin-left: 40px;">Certains dossiers contiennent des fichiers avec l'extension « .html » (des pages web) : </p>
+
+<ul style="margin-left: 40px;">
+
+<li><strong>help</strong> : contient les fichiers d'aide contextuelle qui s'ouvrent lorsque l'on clique sur les icônes d'aide de Moodle ;</li>
+
+<li><strong>docs</strong> : contient les fichiers de la documentation de base (comme celui-ci !)</li>
+
+</ul>
+
+<h2>Création d'une toute nouvelle langue pour Moodle</h2>
+
+<p style="margin-left: 40px;">Si votre langue n'est pas encore supportée par Moodle, ou si vous voulez juste apporter quelques personnalisations à l'interface de votre site, vous pouvez commencer une nouvelle traduction.</p>
+
+<p style="margin-left: 40px;">Pour ce faire, commencez par créer un nouveau dossier dans le dossier <strong>lang</strong> en utilisant pour son nom le code à 2 lettres de votre langue. Ces codes standard sont décrits dans le fichier <strong>lib/languages.php</strong>. Si vous faites simplement une adaptation locale d'une autre langue, utilisez comme nom le code de cette langue, suivi d'un caractère souligné et d'une extension significative de 2 lettres. Par exemple la langue française est désignée par <em>fr</em>, et le canadien-français par <em>fr_ca</em>. Si vous faites une version Unicode d'une traduction, ajoutez <em>_utf8</em> à la fin (par exemple <em>fr_utf8</em>).</p>
+
+<p style="margin-left: 40px;">Ensuite, copiez le fichier <strong>moodle.php</strong> d'une autre langue dans votre nouveau dossier. Celui du dossier <strong>en</strong> est le plus actuel, mais peu importe puisque vous allez de toute façon le réécrire.</p>
+
+<p style="margin-left: 40px;">Vous êtes maintenant prêt à insérer les chaînes de caractères de votre langue ! Pour plus de détails voyez ci-dessous.</p>
+
+<p style="margin-left: 40px;">Si vous créez une toute nouvelle langue, la première chaîne à modifier est celle dénommée <strong>thischarset</strong> dans le fichier <strong>moodle.php</strong>. Cette chaîne doit contenir un jeu de caractères web valide pour votre langue. Après avoir modifié cette chaîne, enregistrer le fichier <strong>moodle.php</strong>, puis rechargez la page. Vous pouvez alors continuer à modifier les autres chaînes de caractères. </p>
+
+<h2>Modification d'une langue existante</h2>
+
+<h3 style="margin-left: 40px;">Effectuer de petits changements</h3>
+
+<p style="margin-left: 80px;">Si vous voulez juste effectuer quelques petits aménagements dans l'interface pour mieux l'adapter à votre site, <strong>ne modifiez pas les fichiers de langue standard</strong> ! Si vous le faites, toutes vos modifications seront effacées lors de la prochaine mise à jour de Moodle que vous effectuerez.</p>
+
+<p style="margin-left: 80px;">Utilisez plutôt les instructions ci-dessus pour créer un tout nouveau dossier de langue, et donnez pour valeur à la chaîne <strong>parentlanguage</strong> du fichier <strong>moodle.php</strong> le code de la langue la plus proche de la vôtre (la langue « mère »). Par exemple, une bonne dénomination pour une version française locale seraît « <em>fr_local</em> », et la chaîne <strong>parentlanguage</strong> auraît pour valeur <em>fr</em> ou <em>fr_ca</em>.</p>
+
+<p style="margin-left: 80px;">Pour que chacun puisse profiter sur votre site des modifications, vous devrez sélectionner cette nouvelle langue comme langue du site par défaut et restreindre les langues disponibles dans la page <strong>Administration -> Configuration -> Paramètres techniques</strong>.</p>
+
+<h3 style="margin-left: 40px;">Traduire les fichiers de langue de Moodle (les fichiers de chaînes)</h3>
+
+<ol>
+
+<ol>
+
+<li>Connectez-vous sur votre serveur Moodle en tant qu'administrateur.</li>
+
+<li>Allez dans <strong>Administration -> Configuration -> Langue</strong>, qui est la page d'administration des langues. </li>
+
+<li>Sur cette page, choisissez votre langue, puis cliquez sur « Comparer et modifier la langue active ».</li>
+
+<li>Vous devriez maintenant voir un formulaire où vous pouvez modifer les chaînes du fichier <strong>moodle.php</strong>. Si ce n'est pas le cas, vous devrez vous assurez que les fichiers de langue peuvent être modifiés. vous aurez peut-être à changer les droits de lecture et d'écriture sur ces fichiers.</li>
+
+<li>Le formulaire comprend trois colonnes. La première est le nom de chaque chaîne, la deuxième la chaîne en anglais et la dernière sa traduction dans la langue actuelle.</li>
+
+<li>Modifiez les chaînes manquantes, surlignées en couleur. N'oubliez pas de cliquer sur le bouton « Enregistrer: moodle.php » lorsque vous aurez terminé. Répétez ce processus pour les autres fichiers, que vous pouvez modifier en cliquant sur leur nom au sommet de la page.</li>
+
+<li>Vous pouvez laisser des chaînes vides. Moodle utilisera dans ce cas la chaîne de la langue mère (parentlanguage). si vous n'avez pas défini la langue mère dans le fichier <strong>moodle.php</strong>, l'anglais sera utilisé par défaut.</li>
+
+<li>Une façon rapide de voir toutes les chaînes manquantes est de cliquer sur « Vérifier les textes manquant ».</li>
+
+</ol>
+
+</ol>
+
+<h3 style="margin-left: 40px;">Traduire les fichiers d'aide et la documentation</h3>
+
+<p style="margin-left: 80px;">Il n'y a pas encore d'éditeur intégré dans Moodle pour traduire les fichiers d'aide et la documentation, mais ce n'est pas vraiment difficile. Il est important d'utiliser la langue <strong>en</strong> comme langue de référence. Copiez un fichier d'aide de ce dossier au même endroit dans votre propre dossier de langue. Utilisez ensuite un éditeur de texte pour modifier le fichier, en vous assurant de ne pas modifier le code qu'il contient (en général des balises HTML). N'UTILISEZ PAS UN TRAITEMENT DE TEXTE pour modifier ou écrire ces fichiers. Ces programmes les font grossir inutilement !</p>
+
+<p style="margin-left: 80px;">Si vous cliquez sur « Vérifier les textes manquant » dans la page d'administration des langues, une liste des fichiers manquant sera également affichée. En lieu et place des fichiers manquant, Moodle utilisera les fichiers de la langue mère (parentlanguage). Il n'est donc pas nécessaire de conserver des copies non traduites des fichiers d'aide dans votre dossier de langue.</p>
+
+<h2>Offrir votre dossier de langue au projet Moodle</h2>
+
+<p style="margin-left: 40px;">En offrant votre traduction au projet Moodle, vous aiderez les autres personnes parlant votre langue. Votre langue sera en outre distribuée avec toutes les versions futures de Moodle.</p>
+
+<p style="margin-left: 40px;">Compressez simplement votre dossier de langue complet en un fichier <strong>zip</strong> et envoyez-le à translation@moodle.org.</p>
+
+<p style="margin-left: 40px;">Nous vous communiquerons alors tous les détails nécessaires.</p>
+
+<h2>Maintenance de fichiers de langue standard</h2>
+
+<p style="margin-left: 40px;">Si vous vous êtes engagé dans la maintenance d'une langue dans Moodle, vous aurez intérêt à utiliser le <a href="?file=cvs.html">CVS de Moodle</a> afin d'avoir à disposition une version de Moodle toujours à jour et de pouvoir déposer vos modifications directement dans le projet Moodle.</p>
+
+<p style="margin-left: 40px;">Pour être au courant des changements dans le projet, il est des plus judicieux de s'abonner à la <a href="http://sourceforge.net/mail/?group_id=30935" target="_top">liste de distribution CVS</a>. Cela vous aidera à garder votre traduction aussi proche du texte anglais que possible.</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>
projects / moodle.git / commitdiff