*********************************
* Utilisation de UTF-8 dans GRR *
*********************************

Depuis la version GRR 1.9.2, il est possible d'utiliser GRR en mode UTF8.
Pour cela la variable $unicode_encoding doit avoir pour valeur 1 dans le
fichier "config.inc.php."

Si c'est le cas, GRR affiche toutes les pages en utilisant l'encodage UTF-8
et stocke toutes les donnes dans la base au format UTF-8.
Selon la langue choisie, GRR traduit les chanes de caractres stockes dans
les fichiers lang.XX en UTF-8 pour les afficher correctement  l'cran.

ATTENTION :
Pour que cela fonctionne, php doit avoir t compil avec le support 'iconv'
(directive '--with-iconv').


Mode opratoire :
-----------------
- Dans le fichier config.inc.php, mettre la valeur de $unicode_encoding  1.

- Pour un bon fonctionnement, il est ncessaire que la base Mysql soit au format UTF-8
Depuis la version 4.1 de MySQL, il est possible d'utiliser l'encodage UTF-8 pour stocker des donnes Unicode.

S'il s'agit d'une nouvelle installation de GRR, veillez  ce que le jeu de caractres
des colonnes des tables de la base GRR soient en UTF-8.
Si ce n'est pas le cas, il faudra convertir les colonnes dans le jeu de caractres UTF-8.
On peut alors utiliser un outil tel que PhpMyadmin.

S'il s'agit d'une installation existante de GRR, cela signifie que des donnes
figurent dj dans la base, en latin 1 (ISO-8859-1).
Il faut donc convertir ces donnes au format UTF-8. dans le cas contraire,
des points d'interrogation s'afficheront dans le navigateur  la place de
certains caractres (caractres accentus notamment).
Selon les environnements, il existe diffrentes solutions pour convertir les donnes.

De faon gnrale, cette conversion se fait en trois tapes :
-Cration d'une sauvegarde de la base,
-Conversion de la sauvegarde,
-Restauration de la sauvegarde.

La cration et la restauration ne posent pas de problme est utilisant un outil tel que PhpMyadmin.

Exemple de conversion de la base en UTF-8 sous Linux en utilisant iconv :
-------------------------------------------------------------------------
La simple commande suivante permet de crer  partir de votre fichier
de sauvegarde "ma_base_grr.dump", un nouveau fichier de sauvegarde
"ma_base_grr_UTF8.dump" au format UTF-8 :
$ iconv -f ISO8859-1 -t UTF-8 ma_base_grr.dump > ma_base_grr_UTF8.dump

Exemple de conversion de la base en UTF-8 sous windows XP en utilisant notepad :
--------------------------------------------------------------------------------
Ouvrir  l'aide de notepad le fichier de sauvegarde "ma_base_grr.dump"
Faire un enregistrer sous : choisir le format UTF-8 et enregistrer.