bloc DicoTrad

Qu'est-ce que DicoTrad ?

DicoTrad est un bloc Moodle d'outils linguistiques. Il permet d'effectuer les recherches suivantes (Dico: Dictionnaire - Trad: Traduction):

• Définitions; dictionnaires Littré et Trésor
• Synonymes; dictionnaire des synonymes
• Conjugaison; Le conjugueur
• Wikipedia; chercher et consulter
• Traduction; du français vers l'anglais, l'allemand, l'italien, l'espagnol, le portugais, le hollandais, le norvégien, le suédois et inversement. Et aussi français - grec, russe.

Versions disponibles

Versions françaises

• Pour Moodle version 1.6, dicotradfr16.zip :
• Pour Moodle version 1.7 et plus, dicotradfr17.zip :

Versions anglaises

• Pour Moodle version 1.6, dicotraden16.zip :
• Pour Moodle version 1.7 et plus, dicotraden16.zip :

Contenu de l'archive

• Readme.txt
• block_dicotradfr.php (code source du bloc)
• tree.css (fichier de style pour l'affichage de l'arbre (menu))
• Répertoire treeview (répertoire contenant les images de l'arbre)
• dicotradfr16.zip contient un répertoire yui (une partie de la yahoo user interface, Moodle 1.7 contient cette librairie)

Configuration requise

• Moodle version 1.6 ou ultérieure
• Résolution minimale recommandée: 1024x768
• Le bloc n'est pas visible dans les tests
• Firefox 1.5 / Internet Explorer 7

Installation

1. Téléchargez, selon votre version de Moodle, le fichier dicotradfr16.zip ou dicotradfr17.zip.
   
2. Décompressez l'archive
   
3. Placez le dossier dicotradfr dans votre répertoire moodle/blocks.
   
4. Connectez-vous au site Moodle avec un compte d'administrateur.
5. Allez à la page d'administration de votre site Moodle (moodle/admin), si tout s'est bien passé le message suivant devrait apparaître : "Les tables DicoTradFR ont été installées correctement"
6. Aller sur la page d'accueil du site ou dans le cours où vous souhaitez afficher le bloc. Activez le mode édition, puis dans le bloc "blocs" sélectionnez DicoTradFR.
   
7. Vous pouvez personnaliser le nom du bloc en cliquant sur l'icône de la main.
   
8. Entrez un nouveau nom pour le bloc puis appuyez sur la touche entrée.
   

Utilisation du bloc

1. 
   Rentrez un mot dans le champ puis cliquez sur la flèche ou sur la touche entrée du clavier
2. Cliquez un ou plusieurs liens du menu (p.ex Littré) et/ou choisissez une langue dans la catégorie "Traduction". Chaque clique ouvrira une nouvelle fenêtre.

Problèmes connus

• Il est possible de réduire l'arborescence (en cliquant sur Dictionnaires, Wikipedia ou Traduction). Toutefois si une requête est soumise, ou la page rechargée, l'arborescence s'étend à nouveau. En cas d’inutilisation du bloc il vaut donc mieux le réduire à la base (dans la barre de titre).
• A chaque requête la page est rechargée. Il est donc conseillé d'utiliser le bloc en haut de la page afin d'éviter des bonds entre le bas et le haut de la page.
• Le dictionnaire des synonymes ne fonctionne pas à la première requête (mise en place d'un cookie). Des problèmes d'affichage d'accents sont probables et diffèrent selon les navigateurs. Lorsque vous envoyez une requête sur ce dictionnaire, il est recommandé de ne pas utiliser les accents. Par exemple, pour "été" rentrez "ete".

Comment ajouter un dictionnaire

En première approche, ce travail peut paraître long et fastidieux. Sachez toutefois qu'avec un peu d'habitude, vous pourrez ajouter, tester ou supprimer un dictionnaire en quelques minutes ! Bon courage :) L'ajout ou la suppression d'un dictionnaire demandent la modification du code source du bloc. Pour cela il faut utiliser un éditeur PHP comme par exemple PHP Designer (http://www.mpsoftware.dk/phpdesigner_personal.php).

D’une manière générale, ce travail peut être décomposé comme suit :

1.) Récolte d’informations sur le site à ajouter :
- La structure de l’adresse (URL)
- L’encodage du serveur

2.) Ajout de ces données dans le fichier block_dictotradfr.php

3.) L’affichage de la nouvelle fonction de recherche

4.) Essai sous Moodle

A titre d'exemple nous allons ajouter une fonction de recherche Google à notre bloc.

Récolte d’informations sur le site à ajouter

GET et POST

Pour commencer il faut savoir que certains sites ne fonctionneront pas avec ce bloc. Ce dernier contient un formulaire HTML pour que l'on puisse récolter, à l'aide d'un champ, la demande de l'utilisateur. Il existe deux méthodes pour envoyer les données d'un formulaire vers un serveur. La première, celle utilisée par le bloc, passe par l'URL (l'adresse internet figurant dans la barre du navigateur); c'est la méthode GET. Si l'on cherche par exemple oiseau sur google on obtient l'URL suivante:

http://www.google.ch/search?q=oiseau&start=0&ie=utf-8&oe=utf-8&client=firefox-a&rls=org.mozilla:fr:official

Le terme "oiseau" figure dans la barre d'adresse du navigateur.

L'autre méthode, appelée POST, n'affiche pas les données du formulaire dans l'URL. C'est une méthode plus sûr qui est utilisée typiquement lors de l'enregistrement d'un nouvel utilisateur sur un site. Son utilisation est étendue à d'autres applications comme par exemple le site de traduction babelfish; http://babelfish.altavista.com

Si l'on traduit une phrase, l'URL reste toujours la même quelques soient les langues utilisées; http://babelfish.altavista.com/tr

Comme on le voit avec cet exemple, avec la méthode POST, les données (votre phrase à traduire) ne sont pas affichées dans la barre du navigateur.

DicoTrad utilise la méthode GET, on ne peut donc pas y ajouter un site utilisant la méthode POST !

Identifier la "racine" du lien

Si le site que l'on souhaite ajouter utilise la méthode GET, il nous faut identifier la partie du lien qui reste toujours la même quelque soit la requête. Cherchons "moodle" puis "LMS" sous Google (http://www.google.ch), on obtient les résultats suivants;

Pour moodle

http://www.google.ch/search?hl=fr&q=moodle&btnG=Recherche+Google&meta=

Pour LMS

http://www.google.ch/search?hl=fr&q=LMS&btnG=Recherche+Google&meta=

On remarque que les deux liens sont très similaires, seul les mots de la requête changent. La structure est la suivante:

http://www.google.ch/search?hl=fr&q= REQUETE &btnG=Recherche+Google&meta=

Sans passer par google, c'est à dire en modifiant directement l'adresse de votre navigateur, essayez de mettre un autre mot à la place de REQUETE et validez, par exemple avec pomme:

http://www.google.ch/search?hl=fr&q=pomme&btnG=Recherche+Google&meta=

ou encore

http://www.google.ch/search?hl=fr&q=abricot&btnG=Recherche+Google&meta=

Remarquez ça fonctionne aussi comme cela :

http://www.google.ch/search?hl=fr&q=abricot

Dans les deux cas les résultats affichés sont ceux de notre demande. Que choisir entre les deux possibilités suivantes ?

http://www.google.ch/search?hl=fr&q=REQUETE&btnG=Recherche+Google&meta=

http://www.google.ch/search?hl=fr&q=REQUETE

Dans ce cas précis la partie supprimée n'a pas un rôle primordial, il vaut mieux choisir la 2ème qui est plus courte et qui contient moins d'option. Regardons le cas où la recherche est effectuée depuis la boîte de recherche dans firefox. On obtient:

http://www.google.ch/search?q=abricot&start=0&ie=utf-8&oe=utf-8&client=firefox-a&rls=org.mozilla:fr:official

On retrouve la racine (http://www.google.ch/search?q=abricot) avec une série d'informations comme le codage et le navigateur. Il vaut mieux supprimer cette partie pour notre bloc, puisque certains utilisateurs utiliserons un autre navigateur ce qui pourrait provoquer des erreurs d'affichage.

    De tout ce que nous venons de dire, retenons comme racine du lien l'adresse suivante:
    http://www.google.ch/search?q=

Codage du serveur

Une autre étape importante consiste à connaître le codage du serveur (server encoding en anglais). De son côté Moodle utilise l'UTF-8 aussi nommé Unicode. Ce codage se veut universel, c'est à dire qu'il est capable d'afficher les caractères de toutes les langues. De nombreux serveurs utilisent toutefois d'autres types de codage, pour la langue française le codage est dans la majorité des cas de l'ISO-8859-1. Du côté client, les navigateurs (firefox, internet explorer) sont plus ou moins aptes à reconnaitre le codage du serveur et d'adapter l'affichage en conséquence. Vous avez très certainement déjà rencontré des problèmes de codage en surfant sur internet ou en lisant vos messages électroniques, certains caractères accentués se transformant en ?,@,%,&,..

Dicotrad a pour but de créer différentes adresses internet (URL) à partir du mot rentré par l'utilisateur. Chacune de ces URL effectuera une demande sur un serveur (p.ex www.google.ch). Il est donc nécessaire que le codage de l'adresse créée par Dicotrad soit le même que celui du serveur interrogé.

Comment identifier le codage du serveur ?

Une méthode simple consiste à faire une requête contenant le caractère "é". Par exemple dans google on obtient:

http://www.google.ch/search?hl=fr&q=%C3%A9&btnG=Rechercher&meta=

Le caractère "é" est donc codé dans l'adresse par %C3%A9. Cela signifie un codage en UTF-8.

Si l'on effectue cette même requête (é) sur le dictionnaire Trésor:

http://atilf.atilf.fr/dendien/scripts/fast.exe

On obtient:

http://atilf.atilf.fr/dendien/scripts/fast.exe?mot=%E9

Le caractère "é" est donc codé dans l'adresse par %E9. Cela signifie un codage en ISO-8859-1. Comme nous le verrons par la suite, cela nécessitera quelques ajustements (simples) pour que Dicotrad puisse dialoguer correctement avec ce type de serveur.

===Ajouter un dictionnaire dans le code de Dicotrad=== (EN CONSTRUCTION) Pour cette étape il faut éditer le fichier block_dicotradfr.php avec un éditeur (p.ex PHP Designer). Ce fichier php se trouve dans le répertoire moodle/blocks/dicotradfr.
Le code procède selon l'ordre suivant:

1. Déclaration du bloc pour la plateforme.
2. Formulaire incluant le champ dans lequel l'utilisateur rentre sa requête.
3. Adresse et codage des différents dictionnaires.
4. Affichage des adresses dans le bloc.
5. Visibilité du bloc dans la plateforme et au sein des différentes activités.

Seuls les points 3 et 4 rentrent en jeu pour l'ajout d'un dictionnaire ou de tout autre moteur de recherche. Reprenons notre exemple de Google. Nous avions vu que le lien racine était . Nous avions également vu que le codage utilisé est l'UTF-8. Nous allons devoir ajouter la ligne suivante. $urlgoogle='http://fr.wikipedia.org/wiki/'.urlencode($url); Regardons de plus près cette ligne de code:

• $urlgoogle est un nom de variable. Nous aurions très bien pu la nommer $google, $a, mais pas...
• http... est le lien racine google
• .urlencode($url). $url contient le mot (la chaîne de caractère) rentré par l'utilisateur. La fonction urlencode permet de convertir ce terme en un format compatible d'adresse internet. C'est à ce moment là que les caractères accentués sont convertis. Dans ce cas précis été devient par exemple é devient %

L'endroit oû nous plaçons cette ligne n'a pas d'influence sur l'ordre d'affichage.