iGalerie

Accès rapide : - Le répertoire de langue et ses fichiers - Extraction du texte à traduire - Fichier de langue personnalisé

Créer ou modifier une langue

Le répertoire de langue et ses fichiers

Chaque langue doit se trouver dans un sous-répertoire du répertoire locale. Ce répertoire de langue comporte plusieurs fichiers et un répertoire organisés comme suit :

• locale/fr/help/
• locale/fr/install.php
• locale/fr/lang.php
• locale/fr/text.php

Le répertoire de langue doit être nommé à partir d'un code de langue ISO 639 de 2 ou 3 lettres en minuscules, suivi éventuellement d'un code pays ISO 3166 de 2 ou 3 lettres en majuscules avec le caractère "_" pour séparer les deux codes. Voici quelques exemples valides :

• fr : français générique
• fr_FR : français de France
• fr_CA : français du Canada

Le sous-répertoire help contient des fichiers .html utilisés pour l'aide contextuelle dans l'interface d'administration.

Le fichier install.php contient le texte à traduire qui est inséré en base de données lors de l'installation : le titre de la galerie et les messages de notifications par courriel.

Le fichier lang.php contient le nom de la langue tel qu'il apparaîtra dans la galerie :

<?php
$name = 'Français';
?>

Et enfin, le fichier text.php contient tout le texte de l'application à traduire. Si ce fichier est vide ou si certains textes sont absents, c'est la version originale en français qui sera utilisée à la place.

Prenons un exemple pour comprendre comment ça fonctionne. Dans le code de l'application, il y a une multitude de texte en français qui sera affiché dans la galerie et dans l'interface d'administration. Ce texte est passé en argument d'une fonction de localisation :

__('galerie')

Par défaut, ce texte sera affiché tel quel, sauf si on renseigne un texte de remplacement dans le fichier text.php :

<?php
$text =
[
   "galerie" => "gallery",
];
?>

Extraction du texte à traduire

Pour effectuer la traduction vers une nouvelle langue, le plus simple est de modifier les fichiers à partir d'une langue existante. Si vous souhaitez obtenir un fichier text.php avec le texte directement issu de l'application (afin de traduire la dernière version), utilisez le script text_extract.php. Placez ce fichier dans le répertoire d'iGalerie, exécutez-le depuis un navigateur et cliquez sur le bouton Créer le fichier de langue : un nouveau fichier text.php sera créé dans le répertoire d'iGalerie.

Fichier de langue personnalisé

Si vous souhaitez apporter des modifications au texte d'une langue sans que ces modifications soient écrasées à chaque mise à jour d'iGalerie, vous avez la possibilité de le faire en créant un fichier custom.php dans le répertoire de langue :

• locale/fr/custom.php

Ce fichier doit être construit de la même manière que text.php, mais avec un tableau $custom au lieu de $text :

<?php
$custom =
[
];
?>