Gettext: Utiliser plusieurs fichiers de traduction en même temps

Dans certains projets modulaires, certains modules utilisent l’internationalisation (avec gettext notamment). Le problème, c’est quand il y en a plusieurs, quel fichier gettext va-t-il être utilisé ? C’est assez difficile à répondre car gettext est très…très pauvre en fonctions de débugguage. En réalité c’est impossible de débugguer gettext sans procéder par tests.

Du coup, ça serait très pratique d’utiliser plusieurs fichiers compilés de langue. Pour ça, il y a la fonction ngettext qui permet de spécifier le nom du domaine à utiliser. Le nom du domaine c’est le premier paramètre de bindtextdomain qui vous avez dû appeler pour initialiser le fichier de texte à trouver dedans.

C’est très pratique, surtout, lisez la documentation de ngettext pour pouvoir utiliser plusieurs fichiers de traduction dans un même programme PHP !

facebooktwittergoogle_plusredditpinterestlinkedinmail

Créer une documentation à partir de fichiers bien commentés

Dans n’importe quel projet, la documentation est presque indispensable dans la mesure où l’on passe plus de temps à relire et à maintenir du code qu’a en écrire… Commenter le code source est tout aussi important et permet d’intervenir beaucoup plus rapidement sur le code, même après quelques mois voir années. Il permet aussi à quelqu’un qui reprend le projet de mieux comprendre comment il fonctionne.

Seulement, une fois que l’on a commenter, on doit à nouveau s’occuper d’écrire la documentation, chose très ennuyante. Afin d’aider au maximum les développeurs, il existe de nombreux outils pour créer des documentations à partir du code source comme PHPDocumentor.

Continue reading Créer une documentation à partir de fichiers bien commentés

facebooktwittergoogle_plusredditpinterestlinkedinmail