i18n documentation

git-svn-id: https://svn.apache.org/repos/asf/archiva/trunk@1234432 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/archiva-modules/archiva-web/archiva-webapp-js/src/site/apt/i18n.apt b/archiva-modules/archiva-web/archiva-webapp-js/src/site/apt/i18n.apt
index fc5f27c744813d644c0d7457ec1518c73a64b789..840b75accccb1806418968862281ccffef83c029 100644 (file)
--- a/archiva-modules/archiva-web/archiva-webapp-js/src/site/apt/i18n.apt
+++ b/archiva-modules/archiva-web/archiva-webapp-js/src/site/apt/i18n.apt
@@ -26,4 +26,28 @@
 ~~ NOTE: For help with the syntax of this file, see:
 ~~ http://maven.apache.org/guides/mini/guide-apt-format.html
 
-i18n management
\ No newline at end of file
+i18n management
+
+  The js library {{{http://code.google.com/p/jquery-i18n-properties}jquery-i18n-properties}} is used for i18n.
+
+  On application loading, i18n properties are loaded by calling a REST services with the browser lang
+  or with the requested language specified by the request parameter : ?request_lang=en.
+
+  This service will load properties in this order:
+
+  * redback properties in en then in specified language
+
+  * archiva properties (from org/apache/archiva/i18n/default.properties) in en then in specified language
+
+* Javascript method
+
+   You can use the "interpolation" mechanism in javascript too (sample for property managedrepository.deleted=Managed Repository " {0} " deleted. )
+
++-----------------------
+Javascript code :
+$.i18n.prop("managedrepository.deleted",managedRepository.name())
++-----------------------
+
+* Missing properties
+
+  In case of missing property, the key is returned.
\ No newline at end of file

diff --git a/archiva-modules/archiva-web/archiva-webapp-js/src/site/site.xml b/archiva-modules/archiva-web/archiva-webapp-js/src/site/site.xml
index a435ec0edbe8813f8f4854fdfb1b00ef531bd604..5414680c511496fc36148353feee25bb45cc09fe 100644 (file)
--- a/archiva-modules/archiva-web/archiva-webapp-js/src/site/site.xml
+++ b/archiva-modules/archiva-web/archiva-webapp-js/src/site/site.xml
@@ -43,8 +43,8 @@
       <item name="General Design"        href="/index.html" />
       <item name="Rest service"          href="/rest.html"/>
       <item name="JS Template loading"   href="/template-loading.html"/>
-      <item name="Knockout Binding"      href="/knockout-binding.html"/>
       <item name="i18n"                  href="/i18n.html"/>
+      <item name="Knockout Binding"      href="/knockout-binding.html"/>
       <item name="Generic Javascipts"    href="/generics-js"/>
     </menu>