Author: tchemit Date: 2011-01-21 11:43:58 +0100 (Fri, 21 Jan 2011) New Revision: 1854 Url: http://nuiton.org/repositories/revision/i18n/1854 Log: update docs Modified: trunk/src/site/apt/bestPractices.apt trunk/src/site/apt/index.apt trunk/src/site/en/apt/index.apt Modified: trunk/src/site/apt/bestPractices.apt =================================================================== --- trunk/src/site/apt/bestPractices.apt 2011-01-21 10:43:48 UTC (rev 1853) +++ trunk/src/site/apt/bestPractices.apt 2011-01-21 10:43:58 UTC (rev 1854) @@ -38,3 +38,9 @@ Ce n'est pas une obligation, mais comme cela vous fait gagner un temps considérable à l'initialisation, il est fortement conseillé d'utiliser DefaultI18nInitializer pour toutes vos applications finales. + + De plus cet initializer basé sur une unique bundle (produit par le goal bundle) + permet de vous assurer que les traductions de plus haut niveau (celles que + vous avez peut-être surchargées dans votre application finale seront bien + celles utilisés et non pas celle d'une librairie...). + Modified: trunk/src/site/apt/index.apt =================================================================== --- trunk/src/site/apt/index.apt 2011-01-21 10:43:48 UTC (rev 1853) +++ trunk/src/site/apt/index.apt 2011-01-21 10:43:58 UTC (rev 1854) @@ -38,7 +38,7 @@ Petit exemple qui démontre la simplicité d'utilisation de Nuiton I18n : -------------------------------------------------------------------------------- -I18n.init(Locale.UK); +I18n.init(new DefaultI18nInitializer("myBundle"), Locale.FRANCE); System.out.println(I18n._("This text will be translated")); -------------------------------------------------------------------------------- @@ -52,6 +52,8 @@ Quoi de neuf dans la version 2.1 +* Nouveautés dans le module maven + Il est maintenant possible de générer une locale par défaut (par exemple mesTraductions.properties) en utilisant l'option generateDefaultLocale dans votre pom. @@ -60,6 +62,36 @@ récupère toutes les clés identifiées par l'annotation @Key. En le couplant avec le parseurXML, vous pouvez gérer complètement vos traductions avec nuiton-i18n. +* Nouveautés dans l'api + + Il est possible désormais de spécifier la locale à utiliser pour la traduction + en utilisant la nouvelle méthode + +-------------------------------------------------------------------------------- +I18n.l_(Locale.FRANCE, "To translate"); +-------------------------------------------------------------------------------- + + Ainsi on peut désormais utiliser I18n pour des applications de type web dans + les couches de services en passant la locale de l'utilisateur. + + Ce nouveau mode de traduction a nécessité de revoir le design d'initialisation + de la librarie qui s'en trouve simplifié et renforcé. Un certain nombre de + méthodes sont dépréciées et seront supprimées en version 3.0. + + Globalement une seule méthode devrait rester dans la version 3.0 : + +-------------------------------------------------------------------------------- +I18n.init(I18nInitializer, Locale); +-------------------------------------------------------------------------------- + + + Les méthodes <n_(String)>, <_(String)> ont été dépréciées et seront supprimées + en version 3.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>) Modified: trunk/src/site/en/apt/index.apt =================================================================== --- trunk/src/site/en/apt/index.apt 2011-01-21 10:43:48 UTC (rev 1853) +++ trunk/src/site/en/apt/index.apt 2011-01-21 10:43:58 UTC (rev 1854) @@ -38,7 +38,7 @@ Here is a small example that shows Nuiton I18n usage simplicity : ----------------------------------------------------------------------------- -I18n.init(Locale.FR); +I18n.init(new DefaultI18nInitializer("myBundle"), Locale.FR); System.out.println(I18n._("This text will be translated")); -----------------------------------------------------------------------------