--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/sysmodellibs/sysmodelgen/doc/sysmodel/SMG-Input-Files/Localisation-XMLFile.html Wed Oct 13 16:21:25 2010 +0100
@@ -0,0 +1,151 @@
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <!-- Generated by Xbuild version: 5.0.20 -->
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+ <meta name="show-comments" content="" />
+ <title>Localization XML File in System Model Generator Input Files</title>
+ <link href="../../_stock/css/reset.css" rel="stylesheet" type="text/css" />
+ <link href="../../_stock/css/portal.css" rel="stylesheet" type="text/css" />
+ <link href="../../_stock/css/iefix.css" rel="stylesheet" type="text/css" />
+ <link href="../../_stock/css/ui.tabs.css" rel="stylesheet" type="text/css" />
+ <link href="../../_stock/css/developer.css" rel="stylesheet" type="text/css" />
+ <link rel="stylesheet" type="text/css" href="../../_stock/css/ui.css" media="screen" />
+ <link rel="stylesheet" type="text/css" href="../../_stock/css/sysdoc.css" media="screen" />
+ <link rel="stylesheet" type="text/css" href="../../_stock/css/sdlplugin.css" media="screen" />
+ </head>
+ <body>
+ <div id="main_content">
+ <table width="100%" cellpadding="0" cellspacing="0" border="0">
+ <tr>
+ <td valign="top" width="100%">
+ <div id="main_content_txt">
+ <div class="main_content_padding">
+ <div id="main">
+ <div id="authoredContent">
+ <div class="section">
+<a name="Localisation"></a><h1>Localization XML File</h1><div class="section">
+<h2>Purpose</h2><p>
+ You can use the Localization XML file to customize the appearance of an
+ item name on the model. It enables you to perform the following tasks:
+ </p><ul>
+ <li>
+
+ <p>
+ Provide abbreviations of item names. For example,
+ “<code>Application Launch Services</code>”. can appear as “<code>App. Launch
+ Services</code>”.
+ </p>
+ </li>
+
+ <li>
+
+ <p>
+ Include special characters in names, such as soft hyphens. For
+ example, "<code>Graphics Device Interface</code>" can appear as "<code>Graphics Dev&#xad;ice Interface</code>". This allows the word to split across
+ multiple lines on the diagram if it is needed.
+ </p>
+ </li>
+
+ <li>
+
+ <p>
+ Provide a localized translation of a word. For example, "Device
+ Provisioning" can appear as "端末管理".
+ </p>
+ </li>
+
+ </ul>
+
+<p>If using the Localization XML file just to provide abbreviations, you may be better of using a <a href="Dictionary-XMLFile.html">Dictionary XML file</a> instead.</p>
+
+ </div>
+<div class="section">
+<h2>Syntax</h2>
+<div class="Example"><code class="xml"><?xml version="1.0"?>
+<br><display-names <span class="opt">xml:lang="<var>language-code</var></span> <span class="opt">id-namespace="<var>uri</var>"</span> <span class="opt"><var>…namespaces…</var></span> >
+<div class="indent"> <abbrev ref="<var>id</var>" abbrev="<var>abbreviation</var>"/>
+<br> <abbrev name="<var>item-name</var>" abbrev="<var>abbreviation</var>"/>
+<br> …
+</div></display-names></code></div>
+
+<p>There are two ways to assign a localized name to a system model item. </p>
+<ol>
+<li><strong>By ID</strong> - you can use the <code>ref</code> attribute to specify the unique ID of a single system model item to rename.</li>
+<li><strong>By name</strong> - you can use the <code>name</code> attribute to specify that any system model item with that human-readable name will be renamed.</li>
+</ol>
+
+<p>The root element <code>display-names</code> can take these optional attributes:
+ </p><ul>
+
+ <li>
+ <p>
+ <code class="xml">xml:lang="<var>language-code</var>"</code>: This indicates that the file is for localisation and not just a set of abbreviations.
+ The affects of setting this are: <ol>
+ <li>The xml:lang will be set to this value in the generated SVG. This lets you put CSS like this in the Shapes XML:
+ <br/><code class="CSS">text.title:lang(jp) {letter-spacing: -0.15}</code><br/>
+ so that you can fine tune the diagram for different languages.
+
+ </li>
+ <li>All generated numbers (eg when counting in the legend) will be localised (if possible) to this language.</li>
+ </ol>
+ </p>
+ </li>
+
+ <li>
+ <p>
+ <code class="xml">id-namespace="<var>uri</var>"</code>: The default namespace for all <code>ref</code> attributes in the XML file. Has the same meaning, usage and default value as <code>id-namespace</code> in the <a href="http://developer.symbian.org/wiki/index.php/System_Definition/Root#Attributes">System Definition</a>.
+ </p>
+ </li>
+
+ <li>
+ <p>
+ <code><var>namespaces</var></code>: Any namespace declaration should be done in the root element. ID references can use namespace prefixes to associate with system model items. See <a href="http://developer.symbian.org/wiki/index.php/System_Definition/Attributes#Namespacing_names">Namespacing names</A> in the System Definition specification.
+ </p>
+ </li>
+
+
+</div>
+<div class="section">
+<h2>Example</h2>
+<div class="Example"><code class="xml"><?xml version="1.0" ?>
+<br><display-names xml:lang="jp">
+<div class="indent"> <abbrev name="Device Provisioning" abbrev="端末管理" />
+<br> <abbrev name="PIM App Support" abbrev="PIM アプリケーション・サポート" />
+<br> <abbrev name="Multimedia" abbrev="マルチメディア" />
+<br> <abbrev name="Messaging Application Support" abbrev="メッセージング・アプリケーション・サポート" />
+<br> <abbrev name="Graphics" abbrev="グラフィックス" />
+<br> <abbrev name="Application Framework" abbrev="アプリケーション・フレームワーク" />
+<br> <abbrev name="Plugin Compo&#xad;nent" abbrev="プラグイン コンポーネント"/>
+</div></display-names></code></div></div>
+<div class="section">
+<h2> See also</h2><p>
+ <a href="System-Info-XMLFile.html#SystemInfoXML">SystemInfo XML File</a>
+ </p><p>
+ <a href="Dependencies-sysinfo.html">Dependencies Sysinfo File</a>
+ </p><p>
+ <a href="Values-XML-index.html#valuesxml" title="The Values XML files are used to define default and per-component display properties. You can use a values XML file to define colors, patterns, border shapes, or border styles of the components.">Values XML File</a>
+ </p></div>
+</div>
+
+ </div>
+ <div id="printer_copyright">
+ <div id="printer_copyright_padding">
+ Copyright ©2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. License: <a href="http://www.symbianfoundation.org/legal/sfl-v10.html">SFL</a>
+ </div>
+ </div>
+ </div>
+ </div>
+ </div>
+ </td>
+ </tr>
+ </table>
+ <div style="clear: both"></div>
+ </div>
+ <div id="includedFooter">
+ <div id="devnet_footer">
+ <div style="float: left;">Copyright ©2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. License: <a href="http://www.symbianfoundation.org/legal/sfl-v10.html">SFL</a>. </div>
+ <div id='BUILD_VERSION'></div>
+ </div>
+ </div>
+</body>
+</html>