source: release-kits/lirk3/bin/ant-installer/web/.bak/i18n.html@ 14982

Last change on this file since 14982 was 14982, checked in by oranfry, 16 years ago

initial import of LiRK3
File size: 11.6 KB
Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3<head>
4 <title>Ant Installer</title>
5 <link href="style.css" type="text/css" rel="stylesheet">
6 <link href="css/nav.css" rel="stylesheet" type="text/css">
7 <link rel="SHORTCUT ICON" type="image/png" href="images/antinstaller-icon.png">
8 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
9 <meta name="keywords"
10 content="Ant, installer, AntInstall, gui, console, input, parameters, properties, swing, user interface, validation, configuration">
11 <script type="text/javascript" src="js/menu.js"></script>
12 <script type="text/javascript" src="js/sstree.js"></script>
13 <script type="text/javascript" src="js/winfix.js"></script>
14</head>
15<body onload="collapseAll('contents-panel', ['ol']); "><div id="tpallcontent">
16<table cellspacing="0" width="100%">
17 <tbody>
18 <tr class="tpheader">
19 <th class="tpleft">
20 <a target="_top" href="index.html" title="home"><img src="images/ant-install-small.png" alt="AntInstaller" id="logo" width="76" height="50"/></a>
21 <script type="text/javascript">winFix();</script>
22 </th>
23 <th class="tptop" valign="bottom">
24 <img src="space.gif" height="1" width="440" alt="spacer"/><br/>
25
26 <table>
27 <tr>
28 <td valign="top">
29 <div class="tpheadertitle">AntInstaller</div>
30 <!--img src="images/ant-install-title.png" alt="AntInstaller"/-->
31 </td>
32 <td width="100%" align="right" valign="bottom" nowrap="NOWRAP">
33 <div class="tpraised">
34 <a class="tpbutton" target="_top" href="index.html">home</a>
35 <a class="tpbutton" target="_top" href="http://sourceforge.net/project/showfiles.php?group_id=123466&amp;package_id=134917">download</a>
36 <a class="tpbutton" target="_top" href="http://sf.net">sourceforge</a>
37 <a class="tpbutton" target="_top" href="manual-ant.html">antmanual</a>
38 <a class="tpbutton" target="_top" href="http://sourceforge.net/tracker/?group_id=123466&amp;atid=696615">RFEs</a>
39 <a class="tpbutton" target="_top" href="http://sourceforge.net/tracker/?group_id=123466&amp;atid=696612">Bugs</a></div>
40 </td>
41 </tr>
42 </table>
43 </th>
44 </tr>
45 <tr class="tpbody">
46 <td class="tpleft" valign="bottom">
47 <br/>
48 <div id="logoset">
49 <a target="_top" href="http://sourceforge.net"><img src="http://sourceforge.net/sflogo.php?group_id=123466&amp;type=2" alt="SourceForge.net Logo" border="0" height="37" width="125"></a>
50 <br/><br/>
51 <a target="_top" href="http://sourceforge.net/donate/index.php?group_id=123466">
52 <img src="http://sourceforge.net/images/project-support.jpg" alt="donate to AntInstaller"/>
53 </a>
54 </div>
55 </td>
56 <td class="tpright" valign="top">
57 <div class="tpcontent">
58 <!--[segment-content] page content start -->
59 <h2>Internationalisation</h2>
60 Internationalisation (a.k.a multiligual) installers are possible by creating language packs for the core functionality of AntInstaller
61 and for your <code>antinstall-config.xml</code> file.
62 Language packs exist for English, German, Spanish and Euskera please feel free to contribute more lanugages.<br/><br/>
63 A tool exists to help create the properties files required to internationalise the installer config files.
64 A script called <code>createLanguagePack.sh</code> is included to run the tool.
65 The tool is very simple but gives you a starting point for internationalising config files.
66 It reads the <code>antinstall-config.xml</code> file in the current directory and asks for a Local string (e.g. es_EU for Euskera)
67 the tool creates two files <code>LanguagePack_es_EU.properties</code> and the default <code>LanguagePack.properties</code>
68 file in the current directory with default vlaues for each required text string.<br/><br/>
69
70 To use the tool effectively you should perform the following steps.
71 <ul>
72 <li>Prepare the <code>antinstall-config.xml</code> file as normal and ensure it is valid.</li>
73 <li>For comment fields it is a good idea to add a <code>name</code> attribute to the elements to easily identify the fields in the LanguagePack file.
74 All other input elements use the <code>property</code> attribute as the identifyer in the LanguagePack file and should not have <code>name</code> attributes.<br/>
75 The page element shouyld already have a <code>name</code> attribute since it is a required attribute for page.
76 </li>
77 <li>Copy your <code>antinstall-config.xml</code> file temporarily to the root directory where AntInstaller is installed.</li>
78 <li>Run the <code>createLanguagePack.sh</code> script.</li>
79 <li>Translate all the properties in the generated file for the foreign language.</li>
80 <li>Include this file in the <code>/resources/</code> directory of the installer Jar when creating the installer.</li>
81 <li>To test your internationalisation run the installer with the following command line arguments<br/>
82 <code>-Duser.language=es -Duser.region=EU</code><br/>
83 Users with a default Locale already set will not need to take this step.
84 </li>
85 </ul>
86
87 <h2>Maintenance</h2>
88 Once you have internationalised your installer you have increased the maintenance load for any changes. Each element added or changed should be changed in the <code>antinstall-config.xml</code> file and each <code>.properties</code> file and the elements must match up. Some properties are indexed so the ordering of the elements is significant.<br/>
89 For this reason it is a good idea to have a stable installer working before you attempt to internationalise it. It is a good idea to use tools such as SVN, CVS for version management and what ever takes your fancy for diffs.<br/><br/>
90
91 <h2>GUI tool</h2>
92 A fancy GUI tool is also available based on PBR Editor (found at <a href="https://prbeditor.dev.java.net" title="PBR Editor">https://prbeditor.dev.java.net</a>) written by eduardj at dev.java.net. The tool has been modified so that an antinstaller-config.xml file can be used as a starting point for the internationalisation. Click on the AntInstaller icon on the tool bar or in the file menu and select the file. The default properties file is created where ever you specify and from that additional language packs can be added using the GUI.
93
94 <!-- content end [segment-end]-->
95 </div>
96 </td>
97 </tr>
98 </tbody>
99</table>
100<div id="contents-panel">
101<!--[segment-file://contents-include.html] menu start -->
102<div id="contents-menu">
103<ol class="sidebar" id="root">
104 <li class="panel"><a href="#default" class="folder" onclick="toggle(this)"></a><b>Site map</b>
105 <ol>
106 <li class="sidebar"><a href="introduction.html">Introduction</a></li>
107 <li class="panel"><a href="#default" class="folder" onclick="toggle(this)"></a><b>Developer References</b>
108 <ol>
109 <li class="sidebar"><a href="quickstart.html">Quick Start</a></li>
110 <li class="panel"><a href="#default" class="folder" onclick="toggle(this)"></a><a href="manual.html">Manual</a>
111 <ol class="init-hidden">
112 <li class="sidebar"><a href="manual.html#config">antinstall-config.xml</a></li>
113 <li class="panel"><a href="#default" class="folder" onclick="toggle(this)"></a><a href="manual.html#page">Pages</a>
114 <ol class="init-hidden">
115 <li class="sidebar"><a href="manual.html#pagesplash">Splash Page</a></li>
116 <li class="sidebar"><a href="manual.html#pagetext">Text Page</a></li>
117 <li class="sidebar"><a href="manual.html#pagelicense">License Page</a></li>
118 <li class="sidebar"><a href="manual.html#pageinput">Input Page</a></li>
119 <li class="sidebar"><a href="manual.html#pageprogress">Progress Page</a></li>
120 </ol>
121 </li>
122 <li class="panel"><a href="#default" class="folder" onclick="toggle(this)"></a><a href="manual.html#inputtypes">Input types</a>
123 <ol class="init-hidden">
124 <li class="sidebar"><a href="manual.html#app-root">Application Root</a></li>
125 <li class="sidebar"><a href="manual.html#checkbox">Checkbox</a></li>
126 <li class="sidebar"><a href="manual.html#comment">Comment</a></li>
127 <li class="sidebar"><a href="manual.html#date">Date</a></li>
128 <li class="sidebar"><a href="manual.html#directory">Directory</a></li>
129 <li class="sidebar"><a href="manual.html#file">File</a></li>
130 <li class="sidebar"><a href="manual.html#large-select">Large Select</a></li>
131 <li class="sidebar"><a href="manual.html#password">Password Text</a></li>
132 <li class="sidebar"><a href="manual.html#password-confirm">Confirm Password</a></li>
133 <li class="sidebar"><a href="manual.html#select">Select</a></li>
134 <li class="sidebar"><a href="manual.html#target">Target</a></li>
135 <li class="sidebar"><a href="manual.html#target-select">Target Select</a></li>
136 <li class="sidebar"><a href="manual.html#text">Unvalidated Text</a></li>
137 <li class="sidebar"><a href="manual.html#validated">Validated Text</a></li>
138 <li class="sidebar"><a href="manual.html#extvalidated">Externally Validated Text</a></li>
139 </ol>
140 </li>
141 <li class="sidebar"><a href="manual.html#extractor">Self Extractor</a></li>
142 <li class="sidebar"><a href="manual.html#non-extractor">Non Extractor</a></li>
143 <li class="sidebar"><a href="manual.html#scripts">Start Scripts</a></li>
144 <li class="sidebar"><a href="manual.html#refs">Dynamic References</a></li>
145 <li class="sidebar"><a href="manual.html#pagedisplay">Page Displaying</a></li>
146 </ol>
147 </li>
148 <li class="sidebar"><a href="installertask.html">Installer Ant task</a></li>
149 <li class="sidebar"><a href="validationofconfig.html">Validation of config</a></li>
150 <li class="sidebar"><a href="lookandfeels.html">LookAndFeels</a> <br/>(inc screenshots)</li>
151 <li class="sidebar"><a href="classpathresources.html">Resources/Classpath issues</a></li>
152 <li class="sidebar"><a href="i18n.html">Internationalisation</a></li>
153 <li class="sidebar"><a href="auto.html">Automated installs</a></li>
154 <li class="sidebar"><a href="installtypes.html">Multiple install types</a></li>
155 <li class="sidebar"><a href="posttargets.html">Post display targets</a></li>
156 <li class="sidebar"><a href="icons.html">Button Icons</a></li>
157 <li class="sidebar"><a href="antinstall-config-example.html">Example antinstall-config.xml</a></li>
158 </ol>
159 </li>
160 <li class="sidebar"><a href="manual-ant.html">Ant Manual</a></li>
161 <li class="sidebar"><a href="antlinks.html">Ant links</a></li>
162 <li class="sidebar"><a href="userusage.html">User usage</a></li>
163 <li class="sidebar"><a href="licenses.html">Licenses</a></li>
164 <li class="sidebar"><a href="potentialuses.html">Potential uses</a></li>
165 <li class="sidebar"><a href="roadmap.html">Road Map</a></li>
166 <li class="sidebar"><a href="wanted.html">Wanted</a></li>
167 <li class="sidebar"><a href="dtds.html">DTDs</a></li>
168 <li class="sidebar"><a href="changelog.html">Changelog</a></li>
169 <li class="sidebar"><a href="http://sourceforge.net/projects/antinstaller">Project page on SourceForge</a></li>
170 <li class="sidebar"><a href="java2html/antinstaller/index.html">Java2HTML (main)</a></li>
171 <li class="sidebar"><a href="java2html/ext/index.html">Java2HTML (extensions)</a></li>
172 <li class="sidebar"><a href="http://antinstaller.cvs.sourceforge.net/antinstaller">Public CVS over HTTP</a></li>
173 <li class="sidebar"><a href="http://sourceforge.net/sendmessage.php?touser=616485">Contact AntInstaller Admin</a></li>
174 </ol>
175 </li>
176</ol>
177<br/>
178<br/>
179</div>
180
181
182<!-- menu end [segment-end]-->
183</div>
184<div id="contents-options">
185<a id="toggle" href="#" onclick="toggleMenu(); return false;">show menu</a>
186</div>
187
188</div>
189</body>
190</html>
Note: See TracBrowser for help on using the repository browser.