i18n-design.adp
Delivered as text/html
Related Files
[ hide source ] | [ make this the default ]
File Contents
<property name="context">{/doc/acs-core-docs/ {ACS Core Documentation}} {Design Notes}</property>
<property name="doc(title)">Design Notes</property>
<master>
<style>
div.sect2 > div.itemizedlist > ul.itemizedlist > li.listitem {margin-top: 16px;}
div.sect3 > div.itemizedlist > ul.itemizedlist > li.listitem {margin-top: 6px;}
</style>
<include src="/packages/acs-core-docs/lib/navheader"
leftLink="i18n-convert" leftLabel="Prev"
title="
Chapter 14. Internationalization"
rightLink="i18n-translators" rightLabel="Next">
<div class="sect1">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="i18n-design" id="i18n-design"></a>Design Notes</h2></div></div></div><p>User locale is a property of ad_conn, <code class="computeroutput">ad_conn locale</code>. The request processor sets
this by calling <code class="computeroutput">lang::conn::locale</code>, which looks for the
following in order of precedence:</p><div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem"><p>Use user preference for this package (stored in
ad_locale_user_prefs)</p></li><li class="listitem"><p>Use system preference for the package (stored in
apm_packages)</p></li><li class="listitem"><p>Use user's general preference (stored in
user_preferences)</p></li><li class="listitem"><p>Use Browser header (<code class="computeroutput">Accept-Language</code> HTTP header)</p></li><li class="listitem"><p>Use system locale (an APM parameter for acs_lang)</p></li><li class="listitem"><p>default to en_US</p></li>
</ol></div><p>For ADP pages, message key lookup occurs in the templating
engine. For Tcl pages, message key lookup happens with the
<code class="computeroutput">_</code> function. In both cases, if
the requested locale is not found but a locale which is the default
for the language which matches your locale's language is found,
then that locale is offered instead.</p>
</div>
<include src="/packages/acs-core-docs/lib/navfooter"
leftLink="i18n-convert" leftLabel="Prev" leftTitle="How to Internationalize a Package"
rightLink="i18n-translators" rightLabel="Next" rightTitle="Translator's Guide"
homeLink="index" homeLabel="Home"
upLink="i18n" upLabel="Up">
