Author: tchemit Date: 2010-11-21 11:38:20 +0100 (Sun, 21 Nov 2010) New Revision: 1823 Url: http://nuiton.org/repositories/revision/i18n/1823 Log: update docs Modified: trunk/src/site/apt/index.apt Modified: trunk/src/site/apt/index.apt =================================================================== --- trunk/src/site/apt/index.apt 2010-11-21 10:04:23 UTC (rev 1822) +++ trunk/src/site/apt/index.apt 2010-11-21 10:38:20 UTC (rev 1823) @@ -37,20 +37,79 @@ Petit exemple qui démontre la simplicité d'utilisation de Nuiton I18n : ------------------------------------------------------------------------------ +-------------------------------------------------------------------------------- I18n.init(Locale.FR); System.out.println(I18n._("This text will be translated")); +-------------------------------------------------------------------------------- + + Les deux modules du projet Nuiton I18n : + + - {{{./nuiton-i18n/index.html}I18n Api}} + + - {{{./maven-i18n-plugin/index.html}I18n Maven Plugin}} + + - {{{./ant-i18n-task/index.html}I18n Ant task}} (ce module a été désactivé depuis la version 2.0) + +Quoi de nouveau dans la version 2.0 + + Depuis la version 2.0, les bundles i18n générés (dans <src/main.resources/i18n>) + sont compatibles avec l'api java de <ResourceBundle>, à savoir qu'on a + remplacé les <<->> par des <<_>>. + + Avant on avait + ----------------------------------------------------------------------------- +malib-fr_FR.properties +----------------------------------------------------------------------------- + Et maintentant c'est : + +----------------------------------------------------------------------------- +malib_fr_FR.properties +----------------------------------------------------------------------------- + + * Migration vers la version 2.0 + + Pour utiliser la version 2.0, il faut avant tout renommer dans votre projet + les bundles avant les bons noms (sinon ils seront générés lors de la première + exécution et il est toujours mieux de renommer des fichiers existants pour + conserver l'historique des fichiers dans le gestionnaire de versions). + + Pour ce qui est du mode <<bundle>> (mojo bundle), aucune modification n'est + nécessaire et il restera compatible avec des librairies packagées avec I18n + non en 2.0. + + * Ajout d'un parseur JSP + + Un nouveau parseur JSP a été introduit pour pouvoir intégrer le système de + détection I18n dans des développement web (struts par exemple). + Jettez un oeil aux tutoriaux pour voir comment enrichir votre application avec Nuiton I18n. - Les trois modules du projet Nuiton I18n : + * Amélioration des parser xml - - {{{./nuiton-i18n/index.html}I18n Api}} + Les parseurs de type xml (actuellement on avait que le <<parserValidation>>) + ont été améliorés dans leur design. Certain paramètres sont devenus communs + à tous les parseurs. Regarder la page de détails de goal pour voir ce qui a + changé. - - {{{./maven-i18n-plugin/index.html}I18n Maven Plugin}} + On a pu introduire un nouveau parseur <<parserXml>> qui ne contient aucune + règle de détection de clefs (via xpath), l'utilisateur doit les spécifier par + lui même; ce nouveau mojo permet ainsi d'utiliser la détection de clef dans du + xml non pris en charge par le projet. - - {{{./ant-i18n-task/index.html}I18n Ant task}} + * Suppression du module <<I18n ant tasks>> + Ce module n'est plus maintenu depuis bien longtemps, il est donc désactivé du + build par défaut, il reste cependant dans le projet et est activitable dans un + profile nommé <<ant-task-profile>>. + Donc pour construire le projet I18n avec ce module il suffit de lancer : + +----------------------------------------------------------------------------- +mvn install -Pant-task-profile +----------------------------------------------------------------------------- + + +