From do-not-reply at jboss.org Tue Jan 29 11:07:57 2013
Content-Type: multipart/mixed; boundary="===============4585611591176874203=="
MIME-Version: 1.0
From: do-not-reply at jboss.org
To: gatein-commits at lists.jboss.org
Subject: [gatein-commits] gatein SVN: r9055 - in
 epp/docs/branches/6.0/Reference_Guide/en-US:
 extras/PortalDevelopment_InternationalizationConfiguration and 3 other
 directories.
Date: Wed, 16 Jan 2013 00:12:37 -0500
Message-ID: <201301160512.r0G5CbrX026371@svn01.web.mwc.hst.phx2.redhat.com>

--===============4585611591176874203==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

Author: jaredmorgs
Date: 2013-01-16 00:12:37 -0500 (Wed, 16 Jan 2013)
New Revision: 9055

Added:
   epp/docs/branches/6.0/Reference_Guide/en-US/images/PortalDevelopment/Int=
ernationalization/
   epp/docs/branches/6.0/Reference_Guide/en-US/images/PortalDevelopment/Int=
ernationalization/LanguageChoice.png
Modified:
   epp/docs/branches/6.0/Reference_Guide/en-US/Reference_Guide.ent
   epp/docs/branches/6.0/Reference_Guide/en-US/Revision_History.xml
   epp/docs/branches/6.0/Reference_Guide/en-US/extras/PortalDevelopment_Int=
ernationalizationConfiguration/default151.xml
   epp/docs/branches/6.0/Reference_Guide/en-US/modules/PortalDevelopment/In=
ternationalizationConfiguration.xml
Log:
https://docs.jboss.org/author/display/GTNPORTAL35/Internationalization+Conf=
iguration Incorporated changes up to V3 of the revision history.

Modified: epp/docs/branches/6.0/Reference_Guide/en-US/Reference_Guide.ent
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- epp/docs/branches/6.0/Reference_Guide/en-US/Reference_Guide.ent	2013-01=
-16 01:08:30 UTC (rev 9054)
+++ epp/docs/branches/6.0/Reference_Guide/en-US/Reference_Guide.ent	2013-01=
-16 05:12:37 UTC (rev 9055)
@@ -5,12 +5,12 @@
 <!ENTITY BOOKID "Reference Guide">
 =

 <!-- Bugzilla Specifics -->
-<!ENTITY BZPRODUCT "JBoss Portal Platform 6">
+<!ENTITY BZPRODUCT "JBoss Enterprise Portal Platform 6">
 <!ENTITY BZCOMPONENT "docs-Reference_Guide">
 <!ENTITY BZURL "<ulink url=3D'https://bugzilla.redhat.com/enter_bug.cgi?pr=
oduct=3DJBoss&percnt;20Portal&percnt;20Platform&percnt;206&amp;component=3D=
docs-Reference_Guide&amp;version=3D6.0'>http://bugzilla.redhat.com/</ulink>=
">
 =

 <!-- Corporate Specifics: -->
-<!ENTITY YEAR "2012">
+<!ENTITY YEAR "2013">
 <!ENTITY HOLDER "Red Hat, Inc">
 =

 <!-- Version Specifcs: -->

Modified: epp/docs/branches/6.0/Reference_Guide/en-US/Revision_History.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- epp/docs/branches/6.0/Reference_Guide/en-US/Revision_History.xml	2013-0=
1-16 01:08:30 UTC (rev 9054)
+++ epp/docs/branches/6.0/Reference_Guide/en-US/Revision_History.xml	2013-0=
1-16 05:12:37 UTC (rev 9055)
@@ -7,7 +7,22 @@
   <title>Revision History</title>
   <simpara>
     <revhistory>
-			<revision>
+      <revision>
+        <revnumber>6.0.0-29</revnumber>
+        <date>Wed Jan 16 2013</date>
+        <author>
+          <firstname>Jared</firstname>
+          <surname>Morgan</surname>
+          <email/>
+        </author>
+        <revdescription>
+          <simplelist>
+            <member>Made changes from https://docs.jboss.org/author/displa=
y/GTNPORTAL35/Internationalization+Configuration </member>
+            <member>I have some NEEDINFO to be answered by ppalaga before =
this can be finalized.</member>
+          </simplelist>
+        </revdescription>
+      </revision>
+      <revision>
         <revnumber>6.0.0-28</revnumber>
         <date>Mon Jan 7 2013</date>
         <author>
@@ -21,7 +36,7 @@
           </simplelist>
         </revdescription>
       </revision>
-			<revision>
+      <revision>
         <revnumber>6.0.0-27</revnumber>
         <date>Fri Jan 4 2013</date>
         <author>
@@ -35,7 +50,7 @@
           </simplelist>
         </revdescription>
       </revision>
-			<revision>
+      <revision>
         <revnumber>6.0.0-26</revnumber>
         <date>Mon Dec 21 2012</date>
         <author>
@@ -49,7 +64,7 @@
           </simplelist>
         </revdescription>
       </revision>
-			<revision>
+      <revision>
         <revnumber>6.0.0-19</revnumber>
         <date>Mon Dec 12 2012</date>
         <author>
@@ -63,7 +78,7 @@
           </simplelist>
         </revdescription>
       </revision>
-			<revision>
+      <revision>
         <revnumber>6.0.0-18</revnumber>
         <date>Mon Dec 11 2012</date>
         <author>
@@ -91,20 +106,20 @@
           </simplelist>
         </revdescription>
       </revision>
-       <revision>
-       <revnumber>6.0.0-23</revnumber>
-       <date>Fri Nov 30 2012</date>
-       <author>
+      <revision>
+        <revnumber>6.0.0-23</revnumber>
+        <date>Fri Nov 30 2012</date>
+        <author>
           <firstname>Scott</firstname>
           <surname>Mumford</surname>
-          <email></email>
-       </author>
-       <revdescription>
+          <email/>
+        </author>
+        <revdescription>
           <simplelist>
-             <member>BZ#807499: Added SME approved content regarding advan=
ced WCI registration features.</member>
+            <member>BZ#807499: Added SME approved content regarding advanc=
ed WCI registration features.</member>
           </simplelist>
-       </revdescription>
-    </revision>
+        </revdescription>
+      </revision>
       <revision>
         <revnumber>6.0.0-22</revnumber>
         <date>Fri Nov 30 2012</date>

Modified: epp/docs/branches/6.0/Reference_Guide/en-US/extras/PortalDevelopm=
ent_InternationalizationConfiguration/default151.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- epp/docs/branches/6.0/Reference_Guide/en-US/extras/PortalDevelopment_In=
ternationalizationConfiguration/default151.xml	2013-01-16 01:08:30 UTC (rev=
 9054)
+++ epp/docs/branches/6.0/Reference_Guide/en-US/extras/PortalDevelopment_In=
ternationalizationConfiguration/default151.xml	2013-01-16 05:12:37 UTC (rev=
 9055)
@@ -7,7 +7,8 @@
       <name>classpath.resources</name>
       <description>The resources  that start with the following package na=
me should be load from file system</description>
       <value>locale.portlet</value>      =

-    </values-param>      =

+    </values-param>
+    <!--Comment #2 -->      =

     <values-param>
       <name>init.resources</name>
       <description>Initiate the following resources during the first launc=
h</description>
@@ -21,7 +22,7 @@
       <value>locale.navigation.group.platform.guests</value>
       <value>locale.navigation.group.organization.management.executive-boa=
rd</value>               =

     </values-param>      =

-    <!-- Comment #2 -->
+    <!-- Comment #3 -->
     <values-param>
       <name>portal.resource.names</name>
       <description>The properties files of  the portal ,  those file will =
be merged =


Added: epp/docs/branches/6.0/Reference_Guide/en-US/images/PortalDevelopment=
/Internationalization/LanguageChoice.png
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
(Binary files differ)


Property changes on: epp/docs/branches/6.0/Reference_Guide/en-US/images/Por=
talDevelopment/Internationalization/LanguageChoice.png
___________________________________________________________________
Added: svn:mime-type
   + image/png

Modified: epp/docs/branches/6.0/Reference_Guide/en-US/modules/PortalDevelop=
ment/InternationalizationConfiguration.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- epp/docs/branches/6.0/Reference_Guide/en-US/modules/PortalDevelopment/I=
nternationalizationConfiguration.xml	2013-01-16 01:08:30 UTC (rev 9054)
+++ epp/docs/branches/6.0/Reference_Guide/en-US/modules/PortalDevelopment/I=
nternationalizationConfiguration.xml	2013-01-16 05:12:37 UTC (rev 9055)
@@ -58,14 +58,14 @@
             Various languages are available in the portal package. The con=
figuration below will define which languages are shown in the &quot;<emphas=
is role=3D"bold">Change Language</emphasis>&quot; section and made availabl=
e to users.
         </para>
     <para>
-            The <filename>02portal.war:/WEB-INF/conf/common/common-configu=
ration.xml</filename> file of your installation contains the following sect=
ion:
+            The <filename>portal.war:/WEB-INF/conf/common/common-configura=
tion.xml</filename> file of your installation contains the following sectio=
n:
         </para>
     <programlisting language=3D"XML" role=3D"XML"><xi:include xmlns:xi=3D"=
http://www.w3.org/2001/XInclude" href=3D"../../extras/PortalDevelopment_Int=
ernationalizationConfiguration/default149.xml" parse=3D"text"/></programlis=
ting>
     <para>
             This configuration points to the locale configuration file.
         </para>
     <para>
-            The locale configuration file (<filename>02portal.war:/WEB-INF=
/conf/common/locales-config.xml</filename>) contains the following code:
+            The locale configuration file (<filename>portal.war:/WEB-INF/c=
onf/common/locales-config.xml</filename>) contains the following code:
         </para>
     <example>
       <title>The locales-config.xml File Explanation</title>
@@ -90,16 +90,17 @@
   <section id=3D"sect-Reference_Guide-Internationalization_Configuration-R=
esourceBundleService">
     <title>ResourceBundleService</title>
     <para>
-            The resource bundle service is configured in: <filename>02port=
al.war:/WEB-INF/conf/common/common-configuration.xml</filename>:
+            The resource bundle service is configured in: <filename>portal=
.war:/WEB-INF/conf/common/common-configuration.xml</filename>:
         </para>
-    <example>
+    <example id=3D"exam-common_config_xml_file_explained">
       <title>The common-configuration.xml file explained</title>
       <programlisting language=3D"XML" role=3D"XML"><xi:include xmlns:xi=
=3D"http://www.w3.org/2001/XInclude" href=3D"../../extras/PortalDevelopment=
_InternationalizationConfiguration/default151.xml" parse=3D"text"/></progra=
mlisting>
       <para>
                         Comment #1: resources whose package name starts wi=
th the name specified in the <emphasis>classpath.resources</emphasis> param=
eter are loaded from the file system. Detailed information can be found in =
a later section of this chapter.
                     </para>
+      <para>Comment #2: resources related to portal, group, and user refer=
ence bundles</para>
       <para>
-                        Comment #2: the <emphasis>portal.resource.names</e=
mphasis> parameter defines all resources that belong to the <emphasis>Porta=
l Resource Bundle</emphasis>. These resources are merged to a single resour=
ce bundle which is accessible from anywhere in JBoss Portal Platform. All t=
hese keys are located in the same bundle, which is separated from the navig=
ation resource bundles.
+                        Comment #3: the <emphasis>portal.resource.names</e=
mphasis> parameter defines all resources that belong to the <emphasis>Porta=
l Resource Bundle</emphasis>. These resources are merged to a single resour=
ce bundle which is accessible from anywhere in JBoss Portal Platform. All t=
hese keys are located in the same bundle, which is separated from the navig=
ation resource bundles.
                     </para>
     </example>
   </section>
@@ -108,11 +109,10 @@
     <para>
             There is a resource bundle for each navigation. A navigation c=
an exist for user, groups, and portal.
         </para>
-    <para>
-            The previous example shows bundle definitions for the navigati=
on of the classic portal and of four different groups. Each of these resour=
ce bundles occupies a different sphere, they are independent of each other =
and they are not included in the <parameter>portal.resource.names</paramete=
r> parameter.
+    <para><xref linkend=3D"exam-common_config_xml_file_explained"/> shows =
bundle definitions for the navigation of the classic portal and of four dif=
ferent groups. Each of these resource bundles occupies a different sphere, =
they are independent of each other and they are not included in the <parame=
ter>portal.resource.names</parameter> parameter.
         </para>
     <para>
-            The properties for a group must be in the <filename>WEB-INF/cl=
asses/locale/navigation/group/</filename> folder. For example; <literal>/WE=
B-INF/classes/locale/navigation/group/organization/management/executive-boa=
rd_en.properties</literal>.
+            The properties for a group must be in the <filename>WEB-INF/cl=
asses/locale/navigation/group/</filename> folder. For example,  <literal>/W=
EB-INF/classes/locale/navigation/group/organization/management/executive-bo=
ard_en.properties</literal>.
         </para>
     <para>
             The folder and file names must correspond to the group hierarc=
hy. The group name &quot;<parameter>executive-board</parameter>&quot; is fo=
llowed by the ISO 639 code.
@@ -134,13 +134,13 @@
             Portlets are independent applications and deliver their own re=
source files.
         </para>
     <para>
-            All shipped portlet resources are located in the <emphasis rol=
e=3D"bold">locale/portlet</emphasis> sub-folder. The ResourceBundleService =
parameter <emphasis role=3D"bold">classpath.resources</emphasis> defines th=
is sub-folder. <!--            Doing so the resource file that are in ~~loc=
ale/portlet~~ will never be stored in the JCR and reloaded at each start of=
 the application server.            -->
+            All shipped portlet resources are located in the <emphasis rol=
e=3D"bold">locale/portlet</emphasis> sub-folder. The ResourceBundleService =
parameter <emphasis role=3D"bold">classpath.resources</emphasis> defines th=
is sub-folder. =

         </para>
     <procedure id=3D"proc-Reference_Guide-Portlets-To_add_a_Spanish_transl=
ation_to_the_GadgetPortlet">
-      <title>To add a Spanish translation to the GadgetPortlet</title>
+      <title>Add Spanish Translation to the GadgetPortlet</title>
       <step>
         <para>
-                    Create the file <literal>GadgetPortlet_es.properties</=
literal> in: <filename>WEB-INF/classes/locale/portlet/gadget/GadgetPortlet<=
/filename>.
+                    Create the file <literal>GadgetPortlet_es.properties</=
literal> in <filename>WEB-INF/classes/locale/portlet/gadget/GadgetPortlet</=
filename>.
                 </para>
       </step>
       <step>
@@ -162,64 +162,108 @@
             </para>
       <programlisting language=3D"Java" role=3D"Java"><xi:include xmlns:xi=
=3D"http://www.w3.org/2001/XInclude" href=3D"../../extras/PortalDevelopment=
_InternationalizationConfiguration/default154.java" parse=3D"text"/></progr=
amlisting>
     </section>
-<!--        Commented out as not fully enterprise ready: https://jira.jbos=
s.org/browse/GTNPORTAL-1482
-Will reinstate when issues resolved
-<section id=3D"sect-Reference_Guide-_Portlets_-Debugging_Resource_Bundle_U=
sage">
-<title>Debugging Resource Bundle Usage</title>
-<para>
+    <section id=3D"sect-Reference_Guide-_Portlets_-Debugging_Resource_Bund=
le_Usage">
+      <title><remark>NEEDINFO </remark>Debugging Resource Bundle Usage</ti=
tle>
+      <remark>NEEDINFO - jmorgan - from https://docs.jboss.org/author/disp=
lay/GTNPORTAL35/Internationalization+Configuration there is mention of enab=
ling debug mode, and using the Magic Locale. This was commented out in the =
XML here, but I have reinstated it and tried to add some more info to it. I=
t needs to be verified for correctness. </remark>
+      <para>
 When translating an application it can sometimes be difficult to find the =
right key for a given property.
 </para>
-<para>
-You can start the Portal in <emphasis>debug mode</emphasis> and use the <e=
mphasis role=3D"bold">Magic locale</emphasis> special language to assist in=
 finding the correct translated key value.
+      <para>
+You can start the Portal in <emphasis>debug mode</emphasis> and use the <e=
mphasis role=3D"bold">Magic locale</emphasis> from the list of available po=
rtal languages to assist in finding the correct translated key value.
+This special locale  translates a key to the same value.</para>
+      <para>For example, the translated value for the &quot;organization.t=
itle&quot; key is  the value &quot;organization.title&quot;. Selecting Magi=
c locale  allows use of the portal and its applications with all the keys v=
isible. This makes it easier to discover the correct key for a given label =
in the portal page.</para>
+      <remark>NEEDINFO - jmorgan - 20130116 - I have added these procedure=
s based on commented out material written for EPP 5. I have updated it to w=
hat I think is required, but can&apos;t seem to get the Magic locale to dis=
play.</remark>
+      <procedure>
+        <title>Executing the portal in debug mode</title>
+        <step>
+          <para>
+Open the <replaceable>JBOSS_HOME/bin/standalone.conf</replaceable>  file i=
n a text editor.
 </para>
-<procedure>
-<title>Executing the portal in <emphasis role=3D"bold">debug mode</emphasi=
s></title>
-<step>
-<para>
-Open the <replaceable>JBOSS_AS</replaceable> <filename>run.conf</filename>=
 file.
+        </step>
+        <step>
+          <para>Add the <literal>-Xdebug</literal> parameter to the JVM <e=
mphasis role=3D"bold">JAVA_OPTS</emphasis> listed on (or near, if you have =
made previous configuration changes) line 49.
 </para>
-<programlisting>[<replaceable>USER</replaceable>@<replaceable>HOST</replac=
eable> <replaceable>JBOSS_AS</replaceable>]$ vi bin/run.conf
-</programlisting>
-</step>
-<step>
-<para>
-Add the <literal>-Xdebug</literal> parameter to the JVM <emphasis role=3D"=
bold">JAVA_OPTS</emphasis> listed on (or near, if you have made previous co=
nfiguration changes) line 45.
-</para>
-<programlisting>if [ "x$JAVA_OPTS" =3D "x" ]; then
-JAVA_OPTS=3D"-Xms256m -Xmx512m <emphasis role=3D"bold">-Xdebug</emphasis> =
-XX:MaxPermSize=3D256m -Dorg.jboss.resolver.warning=3Dtrue -Dsun.rmi.dgc.cl=
ient.gcInterval=3D3600000 -Dsun.rmi.dgc.server.gcInterval=3D3600000 -Dsun.l=
ang.ClassLoader.allowArraySyntax=3Dtrue"
+          <programlisting>if [ &quot;x$JAVA_OPTS&quot; =3D &quot;x&quot; ]=
; then
+   JAVA_OPTS=3D&quot;-Xms1303m -Xmx1303m <parameter>-Xdebug</parameter> -X=
X:MaxPermSize=3D256m -Djava.net.preferIPv4Stack=3Dtrue -Dorg.jboss.resolver=
.warning=3Dtrue -Dsun.rmi.dgc.client.gcInterval=3D3600000 -Dsun.rmi.dgc.ser=
ver.gcInterval=3D3600000&quot;
+   JAVA_OPTS=3D&quot;$JAVA_OPTS -Djboss.modules.system.pkgs=3D$JBOSS_MODUL=
ES_SYSTEM_PKGS -Djava.awt.headless=3Dtrue&quot;
+   JAVA_OPTS=3D&quot;$JAVA_OPTS -Djboss.server.default.config=3Dstandalone=
.xml&quot;
+else
+   echo &quot;JAVA_OPTS already set in environment; overriding default set=
tings with values: $JAVA_OPTS&quot;
 fi</programlisting>
-<para>
-Please note that the memory settings in the above example have been change=
d from the default.
+        </step>
+        <step>
+          <para>
+Start the portal as normal by executing the following command:
 </para>
-</step>
-Metadata:
-Source URL: http://www.coderanch.com/t/90611/JBoss/Running-JBoss-Debug-mode
-http://community.jboss.org/thread/78131
-http://stackoverflow.com/questions/1891053/how-to-run-jboss-4-2-3-in-the-d=
ebug-mode-eom
-Source Author: [the name of the original author - add as many as necessary
-Source Author email: [source author email, match up name and email pairs p=
lease
-Source License: [the license of the original material*]
-<step>
-<para>
-Start the portal as normal:
-</para>
-<programlisting><command>[<replaceable>USER</replaceable>@<replaceable>HOS=
T</replaceable> <replaceable>JBOSS_AS</replaceable>]$ ./bin/run.sh [-c <rep=
laceable>PROFILE]</replaceable></command>
+          <programlisting><command>[<replaceable>USER</replaceable>@<repla=
ceable>HOST</replaceable> jboss-jpp-6.0]$ ./bin/standalone.sh </command>
 </programlisting>
-</step>
-</procedure>
-<procedure>
-<title>Setting the Magic Locale</title>
-<step>
-<para>
-<emphasis role=3D"bold">I have no idea how to do this. And no amount of Go=
ogling is revealing anything...</emphasis>
+        </step>
+      </procedure>
+      <procedure>
+        <title>Setting the Magic Locale</title>
+        <step>
+          <para> =

+Open <ulink url=3D"http://localhost:8080/portal/classic"/> to display the =
Portal Platform landing page.
 </para>
-</step>
-</procedure>
-<para>
-This feature translates a key to the same key value.
-</para>
-<para>
-For example, the translated value for the key "<parameter>organization.tit=
le</parameter>" is simply the value "<parameter>organization.title</paramet=
er>". Selecting that language allows use of the portal and its applications=
 with all the keys visible. This makes it easier to find out the correct ke=
y for a given label in the portal page.
-</para>
-</section>        -->  </section>
+        </step>
+        <step>
+          <para>Click <guibutton>Change Language</guibutton>.</para>
+        </step>
+        <step>
+          <para>Select <guimenuitem>Magic locale</guimenuitem> from the li=
st of available languages.</para>
+        </step>
+      </procedure>
+    </section>
+    <section>
+      <title>Translate the Language Selection Form</title>
+      <figure>
+        <title>Language Selection Screen</title>
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref=3D"images/PortalDevelopment/Internationaliz=
ation/LanguageChoice.png"/>
+          </imageobject>
+          <caption>Image displaying the available languages in the portal,=
 with French selected.</caption>
+        </mediaobject>
+      </figure>
+      <para>
+          =

+          =

+          When choosing a language from the Language Select screen, the us=
er is presented with a list of languages on the left side in the current ch=
osen language. On the right side, the same language is  translated into its=
 own language. </para>
+      <para>The local language values are obtained from the JDK API
+          <code>java.util.Locale.getDisplayedLanguage()</code>
+          and
+          <code>java.util.Locale.getDisplayedCountry()</code>
+          (if needed). Not all  languages may  be translated,  and the lan=
guages available can also depend on the JVM currently used. </para>
+      <para>It is  possible to override these values by editing the
+          <code>locale.portal.webui</code>
+          resource bundle. </para>
+      <procedure>
+        <title>Overriding Default JDK API Language Values</title>
+        <step>
+          <para>Edit the
+          <code>gatein.ear/portal.war/WEB-INF/classes/locale/portal/webui_=
<replaceable>xx_yy</replaceable>.properties</code>
+          file where
+          <replaceable role=3D"italics">xx_yy</replaceable>
+          represents the country code of the language you wish to translat=
e. </para>
+        </step>
+        <step>
+          <para>In that file, add or modify a key such as
+          <code>Locale.<replaceable>xx_yy</replaceable></code>
+          with the <replaceable>xx_yy</replaceable> value being the transl=
ated string.
+        </para>
+        </step>
+        <step>
+          <para>Edit
+          <code>gatein.ear/portal.war/WEB-INF/classes/locale/portal/webui_=
fr.properties</code>
+          where
+          <emphasis role=3D"italics">fr</emphasis>
+          is the country code for French, and add the following key into i=
t:
+        </para>
+          <programlisting>Locale.zh_TW=3DChinois traditionnel</programlist=
ing>
+        </step>
+      </procedure>
+      <para>When the portal is next restarted, the localized language will=
 be updated in the user interface when a user tries to change the current l=
anguage.
+        </para>
+    </section>
+  </section>
 </chapter>


--===============4585611591176874203==--