From 83900e0aed2cfc1668279d9af18fc3d9d51eb59a Mon Sep 17 00:00:00 2001 From: martignoni Date: Mon, 21 Feb 2005 13:03:57 +0000 Subject: [PATCH] Extended guidelines for xml-compliance --- lang/fr/docs/translation.html | 84 ++++++++++++++++++++++++++++------- 1 file changed, 69 insertions(+), 15 deletions(-) diff --git a/lang/fr/docs/translation.html b/lang/fr/docs/translation.html index e65600af32c..41c580b490b 100755 --- a/lang/fr/docs/translation.html +++ b/lang/fr/docs/translation.html @@ -1,15 +1,22 @@ + + + Documentation Moodle : Guide de traduction de Moodle + + + + @@ -40,7 +47,18 @@

Pour ce faire, commencez par créer un nouveau dossier dans le dossier lang en utilisant pour son nom le code à 2 lettres de votre langue. Ces codes standard sont décrits dans le fichier lib/languages.php. 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 fr, et le canadien-français par fr_ca. Si vous faites une version Unicode d'une traduction, ajoutez _utf8 à la fin (par exemple fr_utf8).

-

Ensuite, copiez le fichier moodle.php d'une autre langue dans votre nouveau dossier. Celui du dossier en est le plus actuel, mais peu importe puisque vous allez de toute façon le réécrire.

+

Ensuite, créez dans votre dossier un nouveau fichier "moodle.php" contenant les lignes suivantes :

+ + +<?php
+$string['thischarset'] = 'iso-8859-1';
+$string['thisdirection'] = 'ltr';
+$string['thislanguage'] = 'new language pack';
+?> + + +

+ou copiez le fichier moodle.php d'une autre langue dans votre nouveau dossier. Celui du dossier en est le plus actuel, mais peu importe puisque vous allez de toute façon le réécrire. Si vous choisissez de créer un nouveau fichier, vous aurez l'avantage de commencer avec des fichiers de langue complètement vides et propres.

Vous êtes maintenant prêt à insérer les chaînes de caractères de votre langue ! Pour plus de détails voyez ci-dessous.

@@ -74,31 +92,45 @@
  • 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 moodle.php, l'anglais sera utilisé par défaut.
    • -
  • Une façon rapide de voir toutes les chaînes manquantes est de cliquer sur « Vérifier les textes manquant ».
    • +
  • Une façon rapide de voir toutes les chaînes manquantes est de cliquer sur « Vérifier les textes manquants ». N'écrivez rien dans les chaînes qui n'ont pas (encore) de traduction, sans quoi cet outil si pratique ne fonctionnera plus à satisfaction.

    • Traduire les fichiers d'aide et la documentation

    -

    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 en 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 !

    +

    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 en 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 ! +
    +Ne laissez pas de chaînes non traduites dans vos fichiers de langue !

    Prenez la peine d'écrire des fichiers d'aide en conformité avec la norme XHTML. Ceci comprend notamment les points suivants :

    - + + +

    Aucun des fichiers du dossier « help » ne nécessite de description de document (doc type), ni des balises html, body, head (ouvrantes ou fermantes), car ces fichiers sont inclus à l'aide du fichier « help.php ». Le script se chargera de composer des pages formatées correctement. Cela signifie qu'il n'y a pas beaucoup d'opportunité de laisser libre cours à votre créativité ! Veuillez coller au plus près de l'exemple de la langue anglaise.

    Les fichiers du dossier « docs » doivent en revanche être en pleine conformité avec la norme XHTML, y compris la description de document (doc type), l'entête, etc.

    -

    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.

    +

    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 ne faut donc pas laisser des copies non traduites des fichiers d'aide dans votre dossier de langue, sinon cet outil si pratique ne fonctionnera plus à satisfaction.

    Offrir votre dossier de langue au projet Moodle

    @@ -108,6 +140,28 @@

    Nous vous communiquerons alors tous les détails nécessaires.

    +

    Voici une liste de vérification à utiliser avant de proposer vos fichiers de langue :

    + + +

    Maintenance de fichiers de langue standard

    Si vous vous êtes engagé dans la maintenance d'une langue dans Moodle, vous aurez intérêt à utiliser le CVS de Moodle afin d'avoir à disposition une version de Moodle toujours à jour et de pouvoir déposer vos modifications directement dans le projet Moodle.