Package Traductions

Fichiers du package

FichierDescription
traduire.php

Outils pour la traduction et recherche de traductions

Proposer une amélioration

Liste des fonctions

Interprête un fichier de langue pour le module et la langue désignée s'il existe, et sinon se rabat soit sur la langue principale du site (définie par la meta langue_site), soit sur le français.

Définit la globale idx_lang qui sert à la lecture du fichier de langue (include) et aux surcharges via surcharger_langue()

string charger_langue( string $lang , string $module = 'spip' )

Paramètres

  1. string $lang

    Code de langue

  2. string $module = 'spip'

    Nom du module de langue

Retour

  • string

    Langue du module chargé, sinon chaîne vide.

Utilisé par

Package

Proposer une amélioration
array chercher_module_lang( string $module , string $lang = '' )

Paramètres

  1. string $module

    Nom du module de langue, tel que mots ou ecrire

  2. string $lang = ''

    Langue dont on veut obtenir les traductions. Paramètre optionnel uniquement si le module est local

Retour

  • array

    Liste des fichiers touvés pour ce module et cette langue.

Package

Proposer une amélioration
\SPIP_Traductions_Description definir_details_traduction( \SPIP_Traductions_Description $desc , string $modules )

Paramètres

  1. \SPIP_Traductions_Description $desc
  2. string $modules

    Les modules qui étaient demandés

Retour

  • \SPIP_Traductions_Description

Package

Proposer une amélioration

Version dédiée et optimisée pour cet usage de find_in_path

array find_langs_in_path( string $file , string $dirname = 'lang' )

Paramètres

  1. string $file

    Nom du fichier cherché, tel que mots_fr.php

  2. string $dirname = 'lang'

    Nom du répertoire de recherche

Retour

  • array

    Liste des fichiers de langue trouvés, dans l'ordre des chemins

Voir également

Package

Staticvar

  • array $dirs
Proposer une amélioration

Lorsque la langue demandée n'a pas de traduction pour la clé de langue transmise, la fonction cherche alors la traduction dans la langue principale du site (défini par la meta langue_site), puis, à défaut dans la langue française.

Les traductions sont cherchées dans les modules de langue indiqués. Par exemple le module mots dans la clé mots:titre_mot, pour une traduction es (espagnol) provoquera une recherche dans tous les fichiers lang\mots_es.php.

Des surcharges locales peuvent être présentes également dans les fichiers lang/local_es.php ou lang/local.php

string | array inc_traduire_dist( string $ori , string $lang , boolean $raw = false )

Paramètres

  1. string $ori

    Clé de traduction, tel que bouton_enregistrer ou mots:titre_mot

  2. string $lang

    Code de langue, la traduction doit se faire si possible dans cette langue

  3. boolean $raw = false
    • false : retourne le texte (par défaut)
    • true : retourne une description de la chaine de langue (module, texte, langue)

Retour

  • string | array
    • string : Traduction demandée. Chaîne vide si aucune traduction trouvée.
    • SPIP_Traductions_Description : traduction et description (texte, module, langue)

Utilisé par

Package

Note

  • Les couples clé/traductions déjà connus sont sauvés en interne dans les globales i18n_${module}_${lang} tel que i18n_mots_es et sont également sauvés dans la variable statique deja_vu de cette fonction.
Proposer une amélioration

Charge chaque fichier de langue dont les chemins sont transmis et surcharge les infos de cette langue/module déjà connues par les nouvelles données chargées. Seule les clés nouvelles ou modifiées par la surcharge sont impactées (les clés non présentes dans la surcharge ne sont pas supprimées !).

La fonction suppose la présence de la globale idx_lang indiquant la destination des couples de traduction, de la forme i18n_${module}_${lang}

void surcharger_langue( array $fichiers )

Paramètres

  1. array $fichiers

    Liste des chemins de fichiers de langue à surcharger.

Package

Proposer une amélioration

Liste des classes

NomDescription
SPIP_Traductions_Description