You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openoffice.apache.org by bu...@apache.org on 2011/12/19 22:10:57 UTC
svn commit: r800537 [2/22] - in
/websites/staging/ooo-site/trunk/content/l10n: ./ L10N_Framework/
L10N_Framework/Examples.inv/ L10N_Framework/ooo20/
L10N_Framework/ooo20/oo_images/ download/ i18n_framework/
i18n_framework/cldr/ localization/ localizati...
Added: websites/staging/ooo-site/trunk/content/l10n/L10N_Framework/iso_code_build2.html
==============================================================================
--- websites/staging/ooo-site/trunk/content/l10n/L10N_Framework/iso_code_build2.html (added)
+++ websites/staging/ooo-site/trunk/content/l10n/L10N_Framework/iso_code_build2.html Mon Dec 19 21:10:54 2011
@@ -0,0 +1,427 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<link href="/css/ooo.css" rel="stylesheet" type="text/css">
+
+
+ <meta http-equiv="CONTENT-TYPE"
+ content="text/html; charset=windows-1252">
+ <title>Iso Code</title>
+ <meta name="GENERATOR" content="StarOffice 7 RC (Win32)">
+ <meta name="AUTHOR" content="ivo hinkelmann">
+ <meta name="CREATED" content="20040614;13531000">
+ <meta name="CHANGEDBY" content="ivo hinkelmann">
+ <meta name="CHANGED" content="20040714;14124363">
+ <style>
+ <!--
+ @page { size: 21cm 29.7cm; margin: 2cm }
+ P { margin-bottom: 0.21cm }
+ TD P { margin-bottom: 0.21cm }
+ -->
+ </style>
+
+
+</head>
+
+<body>
+ <div id="bannera">
+ <div id="bannerleft">
+ <img id="ooo-logo" alt="Apache OpenOffice.org (Incubating)" src="/images/ooo-logo.png"/></div>
+ <div id="bannerright"><a alt="Apache Incubator" href="http://incubator.apache.org">
+ <img id="asf-logo" alt="Apache Incubator" src="/images/apache-incubator-logo.png"/></a></div>
+ <div id="bannercenter"><br/>(incubating) | The Free and Open Productivity Suite</div>
+ </div>
+ <div id="clear"></div>
+ <div id="topbara">
+ <div id="breadcrumbsa"><a href="/">home</a> » <a href="/l10n/">l10n</a> » <a href="/l10n/L10N_Framework/">L10N_Framework</a></div>
+ <div id="topnava">
+ <ul>
+<li><a href="/download/index.html" title="Download OpenOffice.org">Download</a></li>
+<li><a href="/support/index.html" title="Find Support for OpenOffice.org">Support</a></li>
+<li><a href="/extensions/index.html" title="Find Extensions and Templates">Extend</a></li>
+<li><a href="http://incubator.apache.org/openofficeorg/get-involved.html" title="Get involved in Apache OpenOffice (incubating)">Develop</a></li>
+<li><a href="/projects/native-lang.html" title="OpenOffice.org in your Native Language">Native Language</a></li>
+</ul>
+ </div>
+ </div>
+ <div id="clear"></div>
+
+ <div id="content">
+
+
+
+<p style="margin-bottom: 0cm;" align="center">How to create a localized
+version of OOo</p>
+<p style="margin-bottom: 0cm;" align="left"><br>
+</p>
+<p style="margin-bottom: 0cm;" align="left">This document descibes how
+to proceed to create a localized version and gives some brief
+background information about ISO Codes and the resourcesystem. </p>
+<p style="margin-bottom: 0cm;" align="left"><b>Build environment</b></p>
+<p style="margin-bottom: 0cm;" align="left">First of all you need the
+source code and a working build environment. Please visit </p>
+<p style="margin-bottom: 0cm;"><a href="http://tools.openoffice.org/">http://tools.openoffice.org/</a>
+<br>
+<br>
+Building Linux
+<br>
+<a href="http://tools.openoffice.org/dev_docs/build_linux.html">http://tools.openoffice.org/dev_docs/build_linux.html</a>
+<br>
+<br>
+Building Windows
+<br>
+<a href="http://tools.openoffice.org/dev_docs/build_windows_tcsh.html">http://tools.openoffice.org/dev_docs/build_windows_tcsh.html</a>
+<br>
+<a href="http://tools.openoffice.org/dev_docs/build_windows.html">http://tools.openoffice.org/dev_docs/build_windows.html</a>
+<br>
+</p>
+<p style="margin-bottom: 0cm;" align="left">I suggest to join the
+mailinglist <a href="mailto:dev@l10n">dev@l10n</a>. You can find a
+lot of people involved into localization there<br>
+<br>
+<a href="http://l10n.openoffice.org/servlets/ProjectMailingListList">http://l10n.openoffice.org/servlets/ProjectMailingListList</a>
+<br>
+</p>
+<p style="margin-bottom: 0cm;"><b>ISO Codes</b></p>
+<p style="margin-bottom: 0cm;">Languages are handled within the
+buildsystem using ISO Codes. As discussed in Issuezilla Task #i8252#
+we support a subset of RFC 3066 [1] for the language identifier.</p>
+<p style="margin-bottom: 0cm;">RFC 3066 basically says:
+<br style="margin-bottom: 0cm;">
+1. Use ISO 639-1 [2] if possible <br style="margin-bottom: 0cm;">
+2. Use ISO 639-2 [2] if no ISO 639-1
+code exists <br style="margin-bottom: 0cm;">
+3. Use ISO 3166 [3] country code if
+necessary,
+to separate to languages with the
+same language code, e.g. US English and British
+English.
+</p>
+<p style="margin-bottom: 0cm;">This means we'll have these codes for
+example:</p>
+<p style="margin-bottom: 0cm;">ISO 639-1 sv Swedish
+<br style="margin-bottom: 0cm;">
+ISO 3166 en-US US English
+<br style="margin-bottom: 0cm;">
+<br>
+To prevent matching problems, languages
+with identical language and coutry code like de-DE are
+reduced to the language code de. Currently the build
+environment don't support ISO 639-2.</p>
+<p style="margin-bottom: 0cm;">
+</p>
+<p style="margin-bottom: 0cm;"><b>Resourcesystem</b></p>
+<p style="margin-bottom: 0cm;">The OpenOffice.org source code contains
+several file types, where strings and messages are declared:</p>
+<br style="margin-bottom: 0cm;">
+*.src / *.hrc : Contains main UI strings
+<br style="margin-bottom: 0cm;">
+*.xrm: Contains readme strings
+<br style="margin-bottom: 0cm;">
+*.xcu: Contains configuration strings <br style="margin-bottom: 0cm;">
+*.ulf: Container for strings converted
+to several custom formats (.rc, .par)<br>
+*.xhp: Contains online help strings<br>
+<p style="margin-bottom: 0cm;">An example of a src resource file:</p>
+<table border="1" bordercolor="#000000" cellpadding="4" cellspacing="0">
+ <col width="256*"> <thead> <tr>
+ <td valign="top" width="100%">
+ <p style="margin-bottom: 0cm;">...</p>
+ <p style="margin-bottom: 0cm;"><font face="Courier New, monospace"><font
+ size="2">CheckBox CB_READ_ONLY</font></font> <br
+ style="margin-bottom: 0cm;">
+ <font face="Courier New, monospace"><font size="2">{</font></font> <br
+ style="margin-bottom: 0cm;">
+ <font face="Courier New, monospace"><font size="2"> Text [ de ] =
+"Nu~r lesen" ;</font></font> <br style="margin-bottom: 0cm;">
+ <font face="Courier New, monospace"><font size="2"> Text [ en-US ]
+= "~Read-only" ;</font></font> <br style="margin-bottom: 0cm;">
+ <font face="Courier New, monospace"><font size="2">};</font></font>
+ </p>
+ <p>...</p>
+ </td>
+ </tr>
+ </thead>
+</table>
+<p style="margin-bottom: 0cm;"><br>
+</p>
+<p style="margin-bottom: 0cm;">Untranslatable string in src files have
+no language code:</p>
+<p style="margin-bottom: 0cm;"> </p>
+<table border="1" bordercolor="#000000" cellpadding="4" cellspacing="0">
+ <col width="256*"> <thead> <tr>
+ <td valign="top">
+ <p><font face="Courier New, monospace"><font size="2"> Text = "50%"</font></font></p>
+ </td>
+ </tr>
+ </thead>
+</table>
+<br>
+<p style="margin-bottom: 0cm;">The untranslatable strings in xml files
+are marked by the reserved language identifier
+x-no-translate:</p>
+<table border="1" bordercolor="#000000" cellpadding="4" cellspacing="0">
+ <col width="256*"> <thead> <tr>
+ <td valign="top" width="100%">
+ <p><font size="2">...</font> <br>
+ <font face="Courier New, monospace"><font size="2"><Text
+lang="x-no-translate">OOo</Text></font></font> <br>
+ <font size="2">...</font> </p>
+ </td>
+ </tr>
+ </thead>
+</table>
+<p style="margin-bottom: 0cm;">Another reserved language identifier
+used for documentaion purpose is x-comment, these
+strings are known as the old developer English and no longer used. The
+comments are outdated. The standart string encoding in the all
+formats like src , ulf , xcs , xcu is UTF8.<br>
+</p>
+<p style="margin-bottom: 0cm;">The interface between the source code
+and the translation tooling is the so called sdf file format ( also
+know as gsi ). The sdf intermediate file format is introduce here: </p>
+<p style="margin-bottom: 0cm;"><a
+ href="http://l10n.openoffice.org/L10N_Framework/Intermediate_file_format.html">http://l10n.openoffice.org/L10N_Framework/Intermediate_file_format.html</a></p>
+<p style="margin-bottom: 0cm;">Note that this format is strict and
+should not violated. You can use the tool gsicheck in
+the module transex3 to perfom simple format checks. Deviant to the
+sdf file format, the language column have been changed from numeric
+language identifier to ISO Codes.</p>
+<p style="margin-bottom: 0cm;">In the source files are only English
+and German strings. There is a sdf file particle called
+localize.sdf placed inside each directory, which
+contains all other language strings. </p>
+<p><font size="2"> </font></p>
+<table bordercolor="#000000" cellpadding="0" cellspacing="0" frame="box">
+ <tbody>
+ <tr>
+ <td> <font face="Courier New, monospace"><font size="2">sw/source/ui/frmdlg/</font></font>
+ </td>
+ <td><font face="Courier New, monospace"><font size="2">frmpage.cxx</font></font>
+ </td>
+ </tr>
+ <tr>
+ <td> <br>
+ </td>
+ <td><font face="Courier New, monospace"><font size="2">frmpage.src</font></font></td>
+ </tr>
+ <tr>
+ <td> <br>
+ </td>
+ <td><font face="Courier New, monospace"><font size="2">localize.sdf</font></font></td>
+ </tr>
+ <tr>
+ <td> <br>
+ </td>
+ <td><font face="Courier New, monospace"><font size="2">wrap.src</font></font></td>
+ </tr>
+ <tr>
+ <td> <br>
+ </td>
+ <td> <font size="2">...</font></td>
+ </tr>
+ </tbody>
+</table>
+<p style="margin-bottom: 0cm;">The content of the particle SDF file is
+merged into the temporary copies of the source files during the
+build. From that temporary source files, now containing all strings,
+the resources files are created. You can use the localize tool to
+collect and merge strings back into that sdf particles.</p>
+<p style="margin-bottom: 0cm;">
+</p>
+<p style="margin-bottom: 0cm;"><b>Real life</b></p>
+<p style="margin-bottom: 0cm;">What steps are need to
+create a OOo build for Khmer? </p>
+<p style="margin-bottom: 0cm;">There are some steps nessesary to add a
+new language to the OOo build environment.</p>
+<p style="margin-bottom: 0cm;">First introduce the ISO Code for Khmer
+(km) to the build environment, add a new entry in
+solenv/inc/postset.mk:</p>
+<table border="1" bordercolor="#000000" cellpadding="4" cellspacing="0">
+ <col width="256*"> <thead> <tr>
+ <td valign="top" width="100%">
+ <p style="margin-bottom: 0cm;">...</p>
+ <font face="Courier New, monospace"><font size="2">
+ <p>completelangiso=af ar be-BY bg br bn bn-BD bn-IN bs ca cs cy da
+de el en-GB en-US en-ZA eo es et eu fa fi fr ga gl gu-IN he hi-IN hr hu
+it ja <span style="color: rgb(255, 0, 0);">km</span> kn-IN ko lo lt lv
+mk ms ne nb nl nn nr ns pa-IN pl pt pt-BR ru rw sk sl sh-YU sr-CS ss st
+sv sw sw-TZ sx ta-IN th tn tr ts ve vi xh zh-CN zh-TW zu</p>
+ </font> </font>
+ <p><font face="Courier New, monospace"><font size="2">...</font></font></p>
+ <font face="Courier New, monospace"> </font></td>
+ </tr>
+ </thead>
+</table>
+<br>
+<p style="margin-bottom: 0cm;">To build the Khmer resources set the
+new environment variable <font face="Courier New, monospace">setenv
+WITH_LANG "km"</font> every time before building, you can also use
+configure to set this variable in the <font
+ face="Courier New, monospace">LinuxIntelEnv</font> script.<br>
+</p>
+<p style="margin-bottom: 0cm;">Now introduce the language to the
+tools/source/intntl/isolang.cxx</p>
+<table border="1" bordercolor="#000000" cellpadding="4" cellspacing="0">
+ <col width="256*"> <thead> <tr>
+ <td valign="top" width="100%">
+ <p><font size="2">...</font></p>
+ <p><font face="Courier New, monospace"><font size="2">{
+LANGUAGE_KHMER, "km", "KH" },</font></font></p>
+ <p><font size="2">...</font></p>
+ </td>
+ </tr>
+ </thead>
+</table>
+<p style="margin-bottom: 0cm;">and tools/inc/lang.hxx</p>
+<table border="1" bordercolor="#000000" cellpadding="4" cellspacing="0">
+ <col width="256*"> <thead> <tr>
+ <td valign="top" width="100%">
+ <p><font size="2">...</font></p>
+ <p><font face="Courier New, monospace"><font size="2">#define
+LANGUAGE_KHMER 0x0453</font></font></p>
+ <p><font size="2">...</font></p>
+ </td>
+ </tr>
+ </thead>
+</table>
+<br>
+<p style="margin-bottom: 0cm;">The hexadezimal value in lang.hxx is
+the Microsoft Language identifier. The MS Lang IDs are used in core
+code, and are of course also needed when storing documents in MS binary
+file formats. They are not relevant for
+UI localization, except in one place where they are used for values in
+a language listbox, see svx/source/dialog/langtab.src . For futher
+information about that
+identifier visit the Microsoft webseites [4]</p>
+<p style="margin-bottom: 0cm;">There are additional steps needed to do
+for the complete introduction of this language, please consult this
+document
+<a
+ href="http://www.khmeros.info/tools/localization_of_openoffice_2.0.html">http://www.khmeros.info/tools/localization_of_openoffice_2.0.html</a><br>
+</p>
+<p style="margin-bottom: 0cm;">Ensure that you have sourced the file
+<font face="Courier New, monospace">LinuxIntelEnv </font><font
+ face="Th">so
+you have a proper environment.</font><br>
+First build the whole office. This is
+needed to build all necessary tools.</p>
+<p style="margin-bottom: 0cm;"> <font face="Courier New, monospace">cd
+instsetoo_native</font>
+<br style="margin-bottom: 0cm;">
+<font face="Courier New, monospace">build --all</font><br>
+</p>
+<p style="margin-bottom: 0cm;">Use the localize tool to extract and
+merging the strings</p>
+<p style="margin-bottom: 0cm;"> </p>
+<p style="margin-bottom: 0cm;">Extracting the strings:</p>
+<p style="margin-bottom: 0cm;"><font face="Courier New, monospace">
+perl
+-w localize.pl -e -l km=en-US -f khmer.sdf</font></p>
+<p style="margin-bottom: 0cm;">Note that the Khmer strings are
+fallbacked to English US, if there is no existing translation yet.
+Choose the language that best fits as fallback.</p>
+<p style="margin-bottom: 0cm;">Now translate the strings in the new
+created file khmer.sdf. You can do that by simple
+translate the file by hand or use tooling. Common are web based
+translation or a conversion to the PO file format and using the
+corresponding translation tools like KBabel. Please have a look here
+<a href="http://www.khmeros.info/tools/oo2.0_program_translaltion.html">http://www.khmeros.info/tools/oo2.0_program_translation.html</a><br>
+</p>
+<p style="margin-bottom: 0cm;">Merge the strings back:</p>
+<p style="margin-bottom: 0cm;"> <font face="Courier New, monospace">perl
+-w localize.pl -m -l km -f khmer.sdf</font></p>
+<p style="margin-bottom: 0cm;"> </p>
+<p style="margin-bottom: 0cm;">The tool distribute the translated
+strings into the sdf particles. </p>
+<p style="margin-bottom: 0cm;">Create the localized build</p>
+<p style="margin-bottom: 0cm;"> </p>
+<p style="margin-bottom: 0cm;"> <font face="Courier New, monospace">cd
+instsetoo_native</font>
+<br style="margin-bottom: 0cm;">
+<font face="Courier New, monospace">setenv WITH_LANG "km"</font><br>
+<font face="Courier New, monospace">build --all<br>
+</font></p>
+<p style="margin-bottom: 0cm;">After a sucessfull build you should find
+localised install sets in your <font face="Courier New, monospace">
+instsetoo_native/<platform>/OpenOffice/<package_format>/rpm/install</font>
+tree</p>
+<p style="margin-bottom: 0cm;"> </p>
+<p style="margin-bottom: 0cm;"><b>Links</b></p>
+<p style="margin-bottom: 0cm;">[0] Much detailed additional
+documentation:
+<br style="margin-bottom: 0cm;">
+<a href="http://www.khmeros.info/tools/"><span
+ style="text-decoration: none;"> </span>http://www.khmeros.info/tools/</a>
+</p>
+<p style="margin-bottom: 0cm;">[1] For more information about RFC
+3066: <br style="margin-bottom: 0cm;">
+<a href="http://www.faqs.org/rfcs/rfc3066.html"><span
+ style="text-decoration: none;"> </span>http://www.faqs.org/rfcs/rfc3066.html</a>
+</p>
+<p style="margin-bottom: 0cm;">[2] For more information about ISO
+639-1 and ISO 639-2:
+<br style="margin-bottom: 0cm;">
+<a href="http://www.loc.gov/standards/iso639-2/">http://www.loc.gov/standards/iso639-2/</a>
+</p>
+<p style="margin-bottom: 0cm;">[3] For more information about ISO
+3166: <br style="margin-bottom: 0cm;">
+<a href="http://www.iso.org/iso/en/prods-services/iso3166ma/index.html"><span
+ style="text-decoration: none;"> </span>http://www.iso.org/iso/en/prods-services/iso3166ma/index.html</a>
+</p>
+<p style="margin-bottom: 0cm;">[4] Microsoft Language Identifier</p>
+<br>
+<p>The complete list, not necessarily supported by Windows:
+List of Locale ID (LCID) Values as Assigned by Microsoft<br>
+<a href="http://www.microsoft.com/globaldev/reference/lcid-all.mspx">http://www.microsoft.com/globaldev/reference/lcid-all.mspx</a>
+</p>
+<p>
+NLS information page<br>
+<a href="http://www.microsoft.com/globaldev/nlsweb/">http://www.microsoft.com/globaldev/nlsweb/</a>
+</p>
+<p style="margin-bottom: 0cm;"> Table of Language Identifiers
+<br style="margin-bottom: 0cm;">
+<a href="http://msdn.microsoft.com/library/en-us/intl/nls_238z.asp">http://msdn.microsoft.com/library/en-us/intl/nls_238z.asp</a>
+</p>
+<p style="margin-bottom: 0cm;"> Primary Language Identifiers
+<br style="margin-bottom: 0cm;">
+<a href="http://msdn.microsoft.com/library/en-us/intl/nls_61df.asp">http://msdn.microsoft.com/library/en-us/intl/nls_61df.asp</a>
+</p>
+<p style="margin-bottom: 0cm;"> SubLanguage Identifiers
+<br style="margin-bottom: 0cm;">
+<a href="http://msdn.microsoft.com/library/en-us/intl/nls_19ir.asp">http://msdn.microsoft.com/library/en-us/intl/nls_19ir.asp</a>
+</p>
+<p style="margin-bottom: 0cm;"> WD2000: Supported Language ID
+Reference Numbers (LCID)
+<br style="margin-bottom: 0cm;">
+<a
+ href="http://support.microsoft.com/default.aspx?scid=KB;en-us;q221435">http://support.microsoft.com/default.aspx?scid=KB;en-us;q221435</a>
+</p>
+<p style="margin-bottom: 0cm;"><br>
+</p>
+
+
+ </div>
+
+ <div id="footera">
+ <div id="poweredbya">
+ <p><img src="/images/feather-small.gif"/></p>
+ </div>
+ <div id="copyrighta">
+ <p>
+ Apache "OpenOffice.org" is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator.
+ Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and
+ decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is
+ not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has
+ yet to be fully endorsed by the ASF.</p>
+ <p>
+ <a href="/license.html">Copyright & License</a>
+ <br />Apache and the Apache feather logos are trademarks of The Apache Software Foundation.
+ OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation.
+ Other names appearing on the site may be trademarks of their respective owners.
+ </p>
+ </div>
+ </div>
+
+</body>
+</html>
Added: websites/staging/ooo-site/trunk/content/l10n/L10N_Framework/ooo20/Collation_in_ooo_2.0.html
==============================================================================
--- websites/staging/ooo-site/trunk/content/l10n/L10N_Framework/ooo20/Collation_in_ooo_2.0.html (added)
+++ websites/staging/ooo-site/trunk/content/l10n/L10N_Framework/ooo20/Collation_in_ooo_2.0.html Mon Dec 19 21:10:54 2011
@@ -0,0 +1,316 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<link href="/css/ooo.css" rel="stylesheet" type="text/css">
+
+
+<meta http-equiv="Content-Language" content="en-us">
+<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
+<title>Collation in OpenOffice 2.0</title>
+<style>
+<!--
+p
+ {margin-right:0in;
+ margin-left:0in;
+ font-size:12.0pt;
+ font-family:"Times New Roman";
+ }
+div.Section1
+ {page:Section1;}
+ p.MsoNormal
+ {mso-style-parent:"";
+ margin-bottom:.0001pt;
+ font-size:10.0pt;
+ font-family:"Times New Roman";
+ margin-left:0in; margin-right:0in; margin-top:0in}
+h3
+ {margin-top:12.0pt;
+ margin-right:0in;
+ margin-bottom:3.0pt;
+ margin-left:0in;
+ page-break-after:avoid;
+ font-size:13.0pt;
+ font-family:Arial;
+ font-weight:bold}
+ li.MsoNormal
+ {mso-style-parent:"";
+ margin-bottom:.0001pt;
+ font-size:10.0pt;
+ font-family:"Times New Roman";
+ margin-left:0in; margin-right:0in; margin-top:0in}
+p.tablehead-western
+ {margin-right:0in;
+ margin-left:0in;
+ font-size:12.0pt;
+ font-family:"Times New Roman";
+ }
+p.textintable-western
+ {margin-right:0in;
+ margin-left:0in;
+ font-size:12.0pt;
+ font-family:"Times New Roman";
+ }
+div.Section2
+ {page:Section2;}
+ table.MsoNormalTable
+ {mso-style-parent:"";
+ font-size:10.0pt;
+ font-family:"Times New Roman";
+ }
+span.moz-txt-citetags
+ {}
+-->
+</style>
+
+
+</head>
+
+<body>
+ <div id="bannera">
+ <div id="bannerleft">
+ <img id="ooo-logo" alt="Apache OpenOffice.org (Incubating)" src="/images/ooo-logo.png"/></div>
+ <div id="bannerright"><a alt="Apache Incubator" href="http://incubator.apache.org">
+ <img id="asf-logo" alt="Apache Incubator" src="/images/apache-incubator-logo.png"/></a></div>
+ <div id="bannercenter"><br/>(incubating) | The Free and Open Productivity Suite</div>
+ </div>
+ <div id="clear"></div>
+ <div id="topbara">
+ <div id="breadcrumbsa"><a href="/">home</a> » <a href="/l10n/">l10n</a> » <a href="/l10n/L10N_Framework/">L10N_Framework</a> » <a href="/l10n/L10N_Framework/ooo20/">ooo20</a></div>
+ <div id="topnava">
+ <ul>
+<li><a href="/download/index.html" title="Download OpenOffice.org">Download</a></li>
+<li><a href="/support/index.html" title="Find Support for OpenOffice.org">Support</a></li>
+<li><a href="/extensions/index.html" title="Find Extensions and Templates">Extend</a></li>
+<li><a href="http://incubator.apache.org/openofficeorg/get-involved.html" title="Get involved in Apache OpenOffice (incubating)">Develop</a></li>
+<li><a href="/projects/native-lang.html" title="OpenOffice.org in your Native Language">Native Language</a></li>
+</ul>
+ </div>
+ </div>
+ <div id="clear"></div>
+
+ <div id="content">
+
+
+
+
+<div align="center">
+
+<table border="0" cellpadding="0" cellspacing="0" width="90%">
+ <!-- MSTableType="layout" -->
+ <tr>
+ <td valign="top">
+ <!-- MSCellType="ContentBody" -->
+ <div class="Section1">
+ <p class="MsoNormal"> </p>
+ <p class="MsoNormal" align="center" style="text-align: center"><b>
+ <span style="font-size: 16.0pt">Collation in OpenOffice 2.0</span></b></p>
+ <p class="MsoNormal" align="center" style="text-align: center"> </p>
+ <p class="MsoNormal" align="center" style="text-align: center"><b>
+ <font size="3">This file contains work in progress. </font></b>
+ <font size="3"><b>Its contents might change without warning.</b></font></p>
+ <p class="MsoNormal" align="center" style="text-align: center"> </p>
+ <p class="MsoNormal" align="center" style="text-align: center"> </p>
+ <p class="MsoNormal" align="center" style="text-align: center">
+ <span style="font-size: 11pt">Javier SOLA -
+ <a href="http://www.khmeros.info">www.khmeros.info</a> - Last edited
+ <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%m/%d/%Y" startspan -->04/21/2005<!--webbot bot="Timestamp" i-checksum="12526" endspan --></span></p>
+ <p class="MsoNormal" align="center" style="text-align: center">
+ </p>
+ <p class="MsoNormal"><span style="font-size: 12.0pt"> </span></p>
+ <hr color="#0000FF" size="5">
+ <p class="MsoNormal"> </p>
+ <p class="MsoNormal" style="text-align:justify;text-justify:inter-ideograph">
+ <span style="font-size: 12.0pt">By default, collation (the
+ alphabetic order of characters for sorting) in OpenOffice follows
+ the rules of the Unicode Collation Algorithm.</span></p>
+ <p class="MsoNormal" style="text-align:justify;text-justify:inter-ideograph">
+ <span style="font-size: 12.0pt"> </span></p>
+ <p class="MsoNormal" style="text-align:justify;text-justify:inter-ideograph">
+ <span style="font-size: 12.0pt">If collation for a specific language
+ or region is not considered as correct by the localisers to that
+ language/country, the collation sequence (order of characters) can
+ be tailored or customized (modified, that is).</span></p>
+ <p class="MsoNormal" style="text-align:justify;text-justify:inter-ideograph">
+ <span style="font-size: 12.0pt"> </span></p>
+ <p class="MsoNormal" style="text-align:justify;text-justify:inter-ideograph">
+ <span style="font-size: 12.0pt">The Unicode Collation Algorithm does
+ not use Unicode code-points (Unicode numbers assigned to each
+ character) as a reference for sorting, it use a huge list that
+ includes all the characters that are currently in Unicode, and which
+ can be found in:</span></p>
+ <p class="MsoNormal" style="text-align:justify;text-justify:inter-ideograph">
+ <span style="font-size: 12.0pt"> </span></p>
+ <p>Latest version:<br>
+ <a style="color: blue; text-decoration: underline; text-underline: single" href="http://www.unicode.org/Public/UCA/latest/allkeys.txt%20(1%20Mb)">
+ http://www.unicode.org/Public/UCA/latest/allkeys.txt (1 Mb)<br>
+ </a>The official 4.0 version:<br>
+ <a style="color: blue; text-decoration: underline; text-underline: single" href="http://www.unicode.org/Public/UCA/4.0.0/allkeys-4.0.0.txt">
+ http://www.unicode.org/Public/UCA/4.0.0/allkeys-4.0.0.txt<br>
+ </a></p>
+ <p style="text-align:justify;text-justify:inter-ideograph">This list
+ is used as a reference. If you wish to modify the collation sequence
+ for your language, you do not need to modify this list; you just
+ have to create a separate file in which you indicate the
+ discrepancies with this file (with the present collation system).</p>
+ <p style="text-align:justify;text-justify:inter-ideograph">This file
+ that you need to create contains one or more reordering sequences
+ with a syntax of the style:</p>
+ <p>&n < ñ <<< Ñ < o</p>
+ <p style="text-align:justify;text-justify:inter-ideograph">(this
+ particular sequence places the letter ñ in the correct order for
+ traditional Spanish sorting, between the letter n and the letter
+ o, indicating that if two words are identical, but one of them
+ starts with a Capital Ñ and another one with lowercase ñ, the
+ lowercase one should go first).</p>
+ <p style="text-align:justify;text-justify:inter-ideograph">But to
+ really know how it works, you should look into the following
+ document, which explains in detail the tailoring syntax and
+ philosophy:</p>
+ <pre style="text-align: justify; text-justify: inter-ideograph; tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><a style="color: blue; text-decoration: underline; text-underline: single" href="http://icu.sourceforge.net/userguide/Collate_Customization.html">http://icu.sourceforge.net/userguide/Collate_Customization.html</a></pre>
+ <p style="text-align:justify;text-justify:inter-ideograph">
+ <span style="font-size: 12.0pt">You can also see:
+ <a href="http://icu.sourceforge.net/docs/papers/icu_collation_iuc26.ppt">
+ http://icu.sourceforge.net/docs/papers/icu_collation_iuc26.ppt</a>
+ (a powerpoint presentation).</span></p>
+ <p style="text-align:justify;text-justify:inter-ideograph">
+ You should also look at some simple files such as
+ collator/data/km_charset.txt. You will not be able to see the
+ characters, unless you have a Khmer font, but it will give you an
+ idea of what your file should look like.</p>
+ <p style="text-align:justify;text-justify:inter-ideograph">
+ <span style="font-size: 12.0pt">Supposing that the ISO code used by
+ OpenOffice for your language/country is xx, we would recommend
+ that you call this file xx_charset.txt (you can call it in different
+ ways, but by giving a fixed name it is easier to give instructions).
+ Sometimes more than one sequence might be defined for a language, in
+ which case you would have to use different names, but always
+ starting with xx_.</span></p>
+ <p class="MsoNormal" style="text-align:justify;text-justify:inter-ideograph">
+ <span style="font-size: 12.0pt">The xx_charset.txt file should be in
+ UTF-8 format (do not use escaped Unicode code-point numbers, as
+ sometimes indicated in the ICU documentation mentioned above).</span></p>
+ <p class="MsoNormal" style="text-align:justify;text-justify:inter-ideograph">
+ <span style="font-size: 12.0pt"> </span></p>
+ <p class="MsoNormal" style="text-align:justify;text-justify:inter-ideograph">
+ <span style="font-size: 12.0pt">This file has to be introduced in
+ the source in location:</span></p>
+ <p class="MsoNormal"><span style="font-size: 12.0pt"> </span></p>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt">collator/data/xx_charset.txt</pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"> </pre>
+ <hr color="#0000FF" size="5">
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"> </pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><span style="font-size:12.0pt;font-family:"Times New Roman"">The second step is to modify file:</span></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"> </pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt">collator/makefile.mk</pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"> </pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><span style="font-size:12.0pt;font-family:"Times New Roman"">to include treatment of your file. Add a line similar to:</span></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><span style="font-size:12.0pt;font-family:"Times New Roman""> </span></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><span style="font-size:12.0pt;font-family:"Times New Roman"">$(SLO)$/collator_xx_charset.obj \</span></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"> </pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><span style="font-size:12.0pt;font-family:"Times New Roman"">(please include the line where it corresponds alphabetically, sorting by ISO code)</span></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><span style="font-size:12.0pt;font-family:"Times New Roman""> </span></pre>
+ <hr color="#0000FF" size="5">
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"> </pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><span style="font-size:12.0pt;font-family:"Times New Roman"">The third step is to modify file:</span></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"> </pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt">registerservices/registerservices.cxx</pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><span style="font-size:12.0pt;font-family:"Times New Roman""> </span></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><span style="font-size:12.0pt;font-family:"Times New Roman"">adding in the corresponding places a line with</span></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><span style="font-size:12.0pt;font-family:"Times New Roman""> </span></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><span style="font-size:12.0pt;font-family:"Times New Roman"">IMPL_CREATEINSTANCE( Collator_xx_charset )</span></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><span style="font-size:12.0pt;font-family:"Times New Roman""> </span></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><span style="font-size:12.0pt;font-family:"Times New Roman"">and a block with:</span></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><span style="font-size:12.0pt;font-family:"Times New Roman""> </span></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><span style="font-size:12.0pt;font-family:"Times New Roman"">{ "com.sun.star.i18n.Collator_xx_charset",</span></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><span style="font-size:12.0pt;font-family:"Times New Roman""> "com.sun.star.i18n.Collator_xx_charset",</span></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><span style="font-size:12.0pt;font-family:"Times New Roman""> &Collator_xx_charset_CreateInstance },</span></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><span style="font-size:12.0pt;font-family:"Times New Roman""> </span></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><span style="font-size:12.0pt;font-family:"Times New Roman"">(please also include these items where they correspond alphabetically, sorting by ISO code)</span></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><span style="font-size:12.0pt;font-family:"Times New Roman""> </span></pre>
+ <hr color="#0000FF" size="5">
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"> </pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt">The forth step is to modify file:</pre>
+ <pre wrap><a href="http://l10n.openoffice.org/source/browse/l10n/i18npool/inc/collator_unicode.hxx">i18npool/inc/collator_unicode.hxx</a></pre>
+ <pre wrap>which requires a line of the type</pre>
+ <pre>COLLATOR( xx_charset )</pre>
+ <pre wrap>together with all other similar lines, respecting, of course, alphabetic order.</pre>
+ <hr color="#0000FF" size="5">
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"> </pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"> </pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><span style="font-size:12.0pt;font-family:"Times New Roman"">The fifth and last step is to modify the locale file for you language/country, making sure that the LC_COLLATION section of it looks like:</span></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><span style="font-size:12.0pt;font-family:"Times New Roman""> </span></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><LC_COLLATION></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><Collator unoid="charset" default="true"/></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><CollationOptions></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"><TransliterationModules>IGNORE_CASE</TransliterationModules></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"></CollationOptions></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"></LC_COLLATION></pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"> </pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt">All locale files are in</pre>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"> </pre>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <a style="color: blue; text-decoration: underline; text-underline: single" href="http://l10n.openoffice.org/source/browse/l10n/i18npool/source/localedata/data/">
+ <font size="3">http://l10n.openoffice.org/source/browse/l10n/i18npool/source/localedata/data/</font></a></p>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"> </pre>
+ <hr color="#0000FF" size="5">
+ <p style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"> </p>
+ <p style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt">
+ <font size="3">If you want to stablish more than one collation
+ sequence for a language/region, you should look into the Chinese and
+ Japanese locales and setting in the same files mentioned above and
+ see how difference sequences are included in different files and how
+ they are then added to the files mentioned above.</font></p>
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"> </pre>
+ <hr color="#0000FF" size="5">
+ <pre style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; font-family: Courier New; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt"> </pre>
+ <p style="tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size: 10.0pt; margin-left: 0in; margin-right: 0in; margin-top: 0in; margin-bottom: .0001pt">
+ <font size="3">Once you have all these modifications, you should
+ check them one more time, <a href="how_to_patch.html">prepare a
+ patch</a> with them and submit it as an ENHANCEMENT issue
+ against the Localization (L10n) project. To submit
+ an issue you first need to login into the OpenOffice website, then hit
+ <b>File Issue</b> on the left hand menu
go to <b>proceed</b> in the
+ next page
click in the component<b> l10n</b> in the next one
are you
+ are ready to file it. Select version <b>current</b>, subcomponent <b>
+ code</b>, type <b>ENHANCEMENT</b>, Summary <b>Collation sequence for
+ language
., </b>and hit<b> Submit. </b>The system will ask you if you
+ want to attach a file and what type<b>. </b>Attach the patch and <b>submit it
</b>and you are done.</font></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in"> </p>
+ <hr color="#0000FF" size="5">
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in"> </p>
+ <p class="MsoNormal" style="margin-left: .5in">
+ </p>
+ </div>
+ <p class="MsoNormal" style="margin-left: .5in"> </p>
+ </td>
+ </tr>
+</table>
+
+</div>
+
+
+
+ </div>
+
+ <div id="footera">
+ <div id="poweredbya">
+ <p><img src="/images/feather-small.gif"/></p>
+ </div>
+ <div id="copyrighta">
+ <p>
+ Apache "OpenOffice.org" is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator.
+ Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and
+ decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is
+ not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has
+ yet to be fully endorsed by the ASF.</p>
+ <p>
+ <a href="/license.html">Copyright & License</a>
+ <br />Apache and the Apache feather logos are trademarks of The Apache Software Foundation.
+ OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation.
+ Other names appearing on the site may be trademarks of their respective owners.
+ </p>
+ </div>
+ </div>
+
+</body>
+</html>
Added: websites/staging/ooo-site/trunk/content/l10n/L10N_Framework/ooo20/config_options_in_ooo_2.0.html
==============================================================================
--- websites/staging/ooo-site/trunk/content/l10n/L10N_Framework/ooo20/config_options_in_ooo_2.0.html (added)
+++ websites/staging/ooo-site/trunk/content/l10n/L10N_Framework/ooo20/config_options_in_ooo_2.0.html Mon Dec 19 21:10:54 2011
@@ -0,0 +1,312 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<link href="/css/ooo.css" rel="stylesheet" type="text/css">
+
+
+<meta http-equiv="Content-Language" content="en-us">
+<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
+<title>Configuration Options for Localization in OpenOffice.org.2.0</title>
+<style>
+<!--
+p
+ {margin-right:0in;
+ margin-left:0in;
+ font-size:12.0pt;
+ font-family:"Times New Roman";
+ }
+div.Section1
+ {page:Section1;}
+ p.MsoNormal
+ {mso-style-parent:"";
+ margin-bottom:.0001pt;
+ font-size:10.0pt;
+ font-family:"Times New Roman";
+ margin-left:0in; margin-right:0in; margin-top:0in}
+h3
+ {margin-top:12.0pt;
+ margin-right:0in;
+ margin-bottom:3.0pt;
+ margin-left:0in;
+ page-break-after:avoid;
+ font-size:13.0pt;
+ font-family:Arial;
+ font-weight:bold}
+ li.MsoNormal
+ {mso-style-parent:"";
+ margin-bottom:.0001pt;
+ font-size:10.0pt;
+ font-family:"Times New Roman";
+ margin-left:0in; margin-right:0in; margin-top:0in}
+p.tablehead-western
+ {margin-right:0in;
+ margin-left:0in;
+ font-size:12.0pt;
+ font-family:"Times New Roman";
+ }
+p.textintable-western
+ {margin-right:0in;
+ margin-left:0in;
+ font-size:12.0pt;
+ font-family:"Times New Roman";
+ }
+div.Section2
+ {page:Section2;}
+ table.MsoNormalTable
+ {mso-style-parent:"";
+ font-size:10.0pt;
+ font-family:"Times New Roman";
+ }
+span.moz-txt-citetags
+ {}
+-->
+</style>
+
+
+</head>
+
+<body>
+ <div id="bannera">
+ <div id="bannerleft">
+ <img id="ooo-logo" alt="Apache OpenOffice.org (Incubating)" src="/images/ooo-logo.png"/></div>
+ <div id="bannerright"><a alt="Apache Incubator" href="http://incubator.apache.org">
+ <img id="asf-logo" alt="Apache Incubator" src="/images/apache-incubator-logo.png"/></a></div>
+ <div id="bannercenter"><br/>(incubating) | The Free and Open Productivity Suite</div>
+ </div>
+ <div id="clear"></div>
+ <div id="topbara">
+ <div id="breadcrumbsa"><a href="/">home</a> » <a href="/l10n/">l10n</a> » <a href="/l10n/L10N_Framework/">L10N_Framework</a> » <a href="/l10n/L10N_Framework/ooo20/">ooo20</a></div>
+ <div id="topnava">
+ <ul>
+<li><a href="/download/index.html" title="Download OpenOffice.org">Download</a></li>
+<li><a href="/support/index.html" title="Find Support for OpenOffice.org">Support</a></li>
+<li><a href="/extensions/index.html" title="Find Extensions and Templates">Extend</a></li>
+<li><a href="http://incubator.apache.org/openofficeorg/get-involved.html" title="Get involved in Apache OpenOffice (incubating)">Develop</a></li>
+<li><a href="/projects/native-lang.html" title="OpenOffice.org in your Native Language">Native Language</a></li>
+</ul>
+ </div>
+ </div>
+ <div id="clear"></div>
+
+ <div id="content">
+
+
+
+
+<div align="center">
+
+<table border="0" cellpadding="0" cellspacing="0">
+ <!-- MSTableType="layout" -->
+ <tr>
+ <td valign="top" height="1914">
+ <!-- MSCellType="ContentBody" -->
+ <div class="Section1">
+ <p class="MsoNormal"> </p>
+ <p class="MsoNormal" align="center" style="text-align: center"><b>
+ <span style="font-size: 16.0pt">Configuration Options for
+ Localization of OpenOffice.org 2.0</span></b></p>
+ <p class="MsoNormal" align="center" style="text-align: center"> </p>
+ <p class="MsoNormal" align="center" style="text-align: center"><b>
+ <font size="3">This file contains work in progress. </font></b></p>
+ <p class="MsoNormal" align="center" style="text-align: center">
+ <font size="3"><b>Its might (and probably
+ will) change often without warning.</b></font></p>
+ <p class="MsoNormal" align="center" style="text-align: center"> </p>
+ <p class="MsoNormal" align="center" style="text-align: center"> </p>
+ <p class="MsoNormal" align="center" style="text-align: center">
+ <span style="font-size: 11pt">Javier SOLA -
+ <a href="http://www.khmeros.info">www.khmeros.info</a> - Last edited
+ <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%m/%d/%Y" startspan -->04/23/2005<!--webbot bot="Timestamp" i-checksum="12558" endspan --></span></p>
+ <p class="MsoNormal" align="center" style="text-align: center">
+ </p>
+ <p class="MsoNormal" align="center" style="text-align: left">
+ </p>
+ <p class="MsoNormal" align="center" style="text-align: left">
+ <span style="font-size: 11pt; font-weight: 700"><a href="#startup">
+ Start-up configuration options</a></span></p>
+ <p class="MsoNormal" align="center" style="text-align: left">
+ <span style="font-weight: 700; font-size: 11pt">
+ <a href="#dialogboxsize">Control dialog box size</a></span></p>
+ <p class="MsoNormal" align="center" style="text-align: left">
+ </p><hr color="#0000FF" size="5">
+ <p class="MsoNormal" align="center" style="text-align: left">
+ </p>
+ <p class="MsoNormal" align="center" style="text-align: left">
+ </p>
+ <p class="MsoNormal" align="center" style="text-align: left">
+ <span style="font-size: 11pt; font-weight: 700"><a name="startup">
+ </a>Start-up configuration options</span></p>
+ </div>
+ <p wrap>If you want to have some UI language or locale configuration options in your
+ own build,
+ you need to create a file called Linguistic.xcu that needs to be placed
+ in the directory:</p>
+ <p wrap>
+ <a href="http://util.openoffice.org/source/browse/util/officecfg/registry/data/org/openoffice/Office">
+ officecfg/registry/data/org/openoffice/Office</a></p>
+ <p wrap>Note that this file cannot be committed to the common source, as
+ it is the same name for all languages, and should not contain contradictory
+ statements.</p>
+ <blockquote>
+ <p wrap><b>Note: </b>This is not entirely true. You actually can
+ accomodate contradictory settings in this file, which then are
+ distributed to multiple files during the build. But you have to make
+ sure only one of these files is installed. Thus, if the scp part is
+ conditionalized appropriately, this could be included into the
+ common source. But in a normal build, without special-purpose
+ configure options this should not be included. </p>
+ </blockquote>
+ <p wrap>Working on options can be complicated; you really need to
+ know what you are doing. If you are not sure, you should probably
+ subscribe to the <a href="mailto:dev@installation.openoffice.org">
+ dev@util.openoffice.org</a> mailing list and ask there. </p>
+ <p wrap>As an example if you were planning to create an English (en_US)
+ and Khmer (km) bi-lingual build, the installer would work in English,
+ and the default language for OOo when it started the first time would be
+ Khmer... but
+ if what you want is that
+ -once installed- the system starts automatically in Khmer (UI in Khmer
+ by default), using Khmer
+ locale by default and selecting Khmer as the CTL language by default,
+ then you need to change the configuration.</p>
+ <p wrap>In this case, your Linguistic.xcu file would have to include:</p>
+ <p wrap><?xml version="1.0" encoding="UTF-8"?> <br>
+ <oor:component-data xmlns:oor=<a class="moz-txt-link-rfc2396E" href="http://openoffice.org/2001/registry">"http://openoffice.org/2001/registry"</a>
+ <br>
+ xmlns:xs=<a class="moz-txt-link-rfc2396E" href="http://www.w3.org/2001/XMLSchema">"http://www.w3.org/2001/XMLSchema"</a>
+ <br>
+ oor:name="Linguistic" <br>
+ oor:package="org.openoffice.Office"> <br>
+ <node oor:name="General"> <br>
+ <prop oor:name="UILocale" oor:type="xs:string"> <br>
+ <value>km</value> <br>
+ </prop> <br>
+ <prop oor:name="DefaultLocale_CTL" oor:type="xs:string"> <br>
+ <value>km</value> <br>
+ </prop> <br>
+ </node> <br>
+ </oor:component-data> <br>
+ </p>
+ <blockquote>
+ <blockquote>
+ <p wrap><b>Note: </b>To allow multiple contradicting values to
+ coexist, you would have to change both occurances of
+ <value>km</value> to <br>
+ <value install:module="km">km</value> <br>
+ <br>
+ (you can use <value install:module="XX">some value</value>, with
+ different XX to add different values) <br>
+ <br>
+ You also have to add the attribute xmlns:install=<a class="moz-txt-link-rfc2396E" href="http://openoffice.org/2004/installation">"http://openoffice.org/2004/installation"</a>
+ to the oor:component-data element in this case. </p>
+ </blockquote>
+ </blockquote>
+ <p wrap>Once you create the file, you need to include infomation about
+ it in </p>
+ <p wrap>officecfg/registry/data/org/openoffice/Office/makefile.mk</p>
+ <p wrap>under XCUFILES.</p>
+ <blockquote>
+ <blockquote>
+ <p wrap><b>Note:</b> If you have added the install:module
+ attribute, you (additionally) need to add "Linguistic-km.xcu" to
+ MODULEFILES. More generally you need to add "Linguistic-XX.xcu"
+ for all XX you used in the install:module attribute to
+ MODULEFILES. </p>
+ </blockquote>
+ </blockquote>
+ <p wrap> </p>
+ <p wrap>--------------------</p>
+ <p wrap>Add an entry for the file in file
+ /scp2/source/ooo/file_ooo.scp so that it gets packed by the
+ installer. You need to include an entry of the type: </p>
+ <pre>File gid_File_Oo_Office_Linguistics_Xcu_Khmer
+ TXT_FILE_BODY;
+ Styles = (PACKED);
+ Dir = gid_Dir_Share_Registry_Data_Org_Openoffice_Office;
+ Name = "/registry/data/org/openoffice/Office/Linguistics.xcu";
+End</pre>
+ <blockquote>
+ <blockquote>
+ <p><b>Note:</b> If you went with the install:modules version,
+ you need to use <br>
+ <br>
+ File gid_File_Oo_Office_Linguistics_LanguagePreselect_Xcu <br>
+ TXT_FILE_BODY; <br>
+ Styles = (PACKED); <br>
+ Dir = gid_Dir_Share_Registry_Modules_Oo_Office_Linguistic
+ <br>
+ Name =
+ "/registry/spool/org/openoffice/Office/Linguistics-km.xcu"; <br>
+ End <br>
+ <br>
+ Use Name=
+ "/registry/spool/org/openoffice/Office/Linguistics-XX.xcu"
+ conditionally for other preselections. </p>
+ </blockquote>
+ </blockquote>
+ <p wrap>Be sure that the
+ entry has a unique gid_... identifier (search the file to make sure that
+ gid_File_Oo_Office_Linguistics_Xcu does not exist anywhere else). <b>
+ In a normal case this modification is for your own build, it should NOT be submitted for
+ inclusion in the common repository. </b>If you use install:module and
+ appropriate conditionals in scp2, you could add it. But for private use
+ your simpler version is sufficient. </p>
+ <p class="MsoNormal" align="center" style="text-align: left">
+ </p><hr color="#0000FF" size="5">
+ <p class="MsoNormal" align="center" style="text-align: left">
+ </p>
+ <p class="MsoNormal" align="center" style="text-align: left">
+ <span style="font-weight: 700; font-size: 11pt">
+ <a name="dialogboxsize"></a>Control dialog box size</span></p>
+ <p class="MsoNormal" align="center" style="text-align: left">
+ </p>
+ <p class="MsoNormal" style="margin-left: .5in">
+ <font style="font-size: 11pt">If you need to change the horizontal size
+ (scale) of controls in dialogs, you can do it by modifying the value
+ corresponding to your locale in the table ..... in file</font></p>
+ <p class="MsoNormal" style="margin-left: .5in"> </p>
+ <p class="MsoNormal" style="margin-left: .5in">
+ <font style="font-size: 11pt">
+ <a href="http://util.openoffice.org/source/browse/util/officecfg/registry/data/org/openoffice/Office/Common.xcu">officecfg/registry/data/org/openoffice/Office/Common.xcu</a></font></p>
+ <p class="MsoNormal" style="margin-left: .5in"> </p>
+ <p class="MsoNormal" style="margin-left: .5in">
+ <font style="font-size: 11pt">You can see that there is a number
+ asssociated to each locale (usually 10 or 13). It is a number between 0
+ and 100 that indicates how large the controls should be. To make a
+ change, include your locale here with a number, and change it if
+ necessary... or increase it if the locale is already there.</font><span style="font-size: 11pt">
+ The size of the dialog window itself will be scaled as well. </span></p></td>
+ </tr>
+ <tr>
+ <td> </td>
+ </tr>
+</table>
+
+</div>
+
+
+
+ </div>
+
+ <div id="footera">
+ <div id="poweredbya">
+ <p><img src="/images/feather-small.gif"/></p>
+ </div>
+ <div id="copyrighta">
+ <p>
+ Apache "OpenOffice.org" is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator.
+ Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and
+ decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is
+ not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has
+ yet to be fully endorsed by the ASF.</p>
+ <p>
+ <a href="/license.html">Copyright & License</a>
+ <br />Apache and the Apache feather logos are trademarks of The Apache Software Foundation.
+ OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation.
+ Other names appearing on the site may be trademarks of their respective owners.
+ </p>
+ </div>
+ </div>
+
+</body>
+</html>
Added: websites/staging/ooo-site/trunk/content/l10n/L10N_Framework/ooo20/how_to_patch.html
==============================================================================
--- websites/staging/ooo-site/trunk/content/l10n/L10N_Framework/ooo20/how_to_patch.html (added)
+++ websites/staging/ooo-site/trunk/content/l10n/L10N_Framework/ooo20/how_to_patch.html Mon Dec 19 21:10:54 2011
@@ -0,0 +1,365 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<link href="/css/ooo.css" rel="stylesheet" type="text/css">
+
+
+<meta http-equiv="Content-Language" content="en-us">
+<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
+<title>How to patch in OpenOffice.org</title>
+<style>
+<!--
+p
+ {margin-right:0in;
+ margin-left:0in;
+ font-size:12.0pt;
+ font-family:"Times New Roman";
+ }
+div.Section1
+ {page:Section1;}
+ p.MsoNormal
+ {mso-style-parent:"";
+ margin-bottom:.0001pt;
+ font-size:10.0pt;
+ font-family:"Times New Roman";
+ margin-left:0in; margin-right:0in; margin-top:0in}
+h3
+ {margin-top:12.0pt;
+ margin-right:0in;
+ margin-bottom:3.0pt;
+ margin-left:0in;
+ page-break-after:avoid;
+ font-size:13.0pt;
+ font-family:Arial;
+ font-weight:bold}
+ li.MsoNormal
+ {mso-style-parent:"";
+ margin-bottom:.0001pt;
+ font-size:10.0pt;
+ font-family:"Times New Roman";
+ margin-left:0in; margin-right:0in; margin-top:0in}
+p.tablehead-western
+ {margin-right:0in;
+ margin-left:0in;
+ font-size:12.0pt;
+ font-family:"Times New Roman";
+ }
+p.textintable-western
+ {margin-right:0in;
+ margin-left:0in;
+ font-size:12.0pt;
+ font-family:"Times New Roman";
+ }
+div.Section2
+ {page:Section2;}
+ table.MsoNormalTable
+ {mso-style-parent:"";
+ font-size:10.0pt;
+ font-family:"Times New Roman";
+ }
+span.moz-txt-citetags
+ {}
+-->
+</style>
+
+
+</head>
+
+<body>
+ <div id="bannera">
+ <div id="bannerleft">
+ <img id="ooo-logo" alt="Apache OpenOffice.org (Incubating)" src="/images/ooo-logo.png"/></div>
+ <div id="bannerright"><a alt="Apache Incubator" href="http://incubator.apache.org">
+ <img id="asf-logo" alt="Apache Incubator" src="/images/apache-incubator-logo.png"/></a></div>
+ <div id="bannercenter"><br/>(incubating) | The Free and Open Productivity Suite</div>
+ </div>
+ <div id="clear"></div>
+ <div id="topbara">
+ <div id="breadcrumbsa"><a href="/">home</a> » <a href="/l10n/">l10n</a> » <a href="/l10n/L10N_Framework/">L10N_Framework</a> » <a href="/l10n/L10N_Framework/ooo20/">ooo20</a></div>
+ <div id="topnava">
+ <ul>
+<li><a href="/download/index.html" title="Download OpenOffice.org">Download</a></li>
+<li><a href="/support/index.html" title="Find Support for OpenOffice.org">Support</a></li>
+<li><a href="/extensions/index.html" title="Find Extensions and Templates">Extend</a></li>
+<li><a href="http://incubator.apache.org/openofficeorg/get-involved.html" title="Get involved in Apache OpenOffice (incubating)">Develop</a></li>
+<li><a href="/projects/native-lang.html" title="OpenOffice.org in your Native Language">Native Language</a></li>
+</ul>
+ </div>
+ </div>
+ <div id="clear"></div>
+
+ <div id="content">
+
+
+
+
+<table border="0" cellpadding="0" cellspacing="0" width="90%">
+ <!-- MSTableType="layout" -->
+ <tr>
+ <td valign="top" height="539" width="799">
+ <!-- MSCellType="ContentBody" -->
+ <div class="Section1">
+ <p class="MsoNormal"> </p>
+ </div>
+ <p class="MsoNormal" align="center">
+ <font size="6"><b>Preparing a patch for OpenOffice.org</b></font><p class="MsoNormal">
+ <p class="MsoNormal">
+ <p class="MsoNormal" align="center">
+ <span style="font-size: 11pt">Javier SOLA -
+ <a href="http://www.khmeros.info">www.khmeros.info</a> - Last edited
+ <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%m/%d/%Y" startspan -->05/02/2005<!--webbot bot="Timestamp" i-checksum="12528" endspan --> -
+ <a href="localization_of_openoffice_2.0.html">Top</a></span><p class="MsoNormal">
+ <p class="MsoNormal" align="center" style="text-align: center"><b>
+ <font size="3">This file contains work in progress. </font></b></p>
+ <p class="MsoNormal" align="center" style="text-align: center">
+ <font size="3"><b>The contents of this pages might (and probably
+ will) change often without warning</b></font></p>
+ <p class="MsoNormal">
+ <p class="MsoNormal">
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">A patch is a proposed modification to a
+ file that already exists in the system. The traditional way of sending a
+ patch to OpenOffice is not to send a new copy of the file, after you
+ modify it, but to send a file that shows the differences between the old
+ file (before you modified it) and the one that you have modified.</span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11.0pt">To prepare a patch </span>
+ <span style="font-size: 11pt">that you want to have integrated in the
+ source of OpenOffice</span><span style="font-size: 11.0pt">, you first
+ need to have the version of the file that corresponds to the version of
+ the program that you are localizing it for.</span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">Which brings us to talk about "branches"
+ and "tags". When OpenOffice reaches a major version (say 2.0), it
+ "branches", meaning that two copies of the source are made: </span></p>
+ <ol>
+ <li>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">One of them to continue development
+ towards the next major version (say 3.0) in which at some point many
+ changes will be made until it becomes stable again for 2.0; </span>
+ </p></li>
+ <li>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">The second copy will not receive major
+ improvements, it will only be modified to fix bugs bus for the
+ original version (reaching versions 2.0.1, 2.1.1, 2.1.2, etc...)
+ while the next major version is being developed in the other branch.</span></p>
+ </li>
+ </ol>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">Each branch has a major name which is
+ included in all the "tags" of files in that branch. For OpenOffice 1.x,
+ it was srx645, for OpenOffice 2.0 it is rsc680. Each time that a file is
+ modified, or that it is used in a new build, it is assigned a new tag. A
+ file , without being modified, might have a lot of "tags". For example,
+ if a file has tag src680_m45, it means that it was used for the
+ src680_m45 build. If that file was not modified for the next build, it
+ will also have tag src680_m45. </span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">All this comes to say that you need to
+ figure out which branch of the program you want to have modified. If the
+ problem that you have detected is in version 2.0, you cannot fix the bug
+ or make the change for version 2.0 (because 2.0 is already closed and
+ out). You either do it for a bug fixing version (2.0.1 or 2.1, whatever
+ the next version will be) or for a major new version. So, once again,
+ you need to figure out which branch you want to affect, and find the
+ last version of the file in that branch. This is not too difficult to do
+ if you know were to look. </span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">If you don't know the major name of the
+ branch you are looking for, ask in the list.</span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">You can look at the files of OpenOffice
+ from the web (webCVS). In OpenOffice this is a little tricky, because
+ you need to know to which project the file belongs within OpenOffice, go
+ to the project's webpage, and there click on "version control", and then
+ find the file in the tree.</span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">Let us say as an example that the file
+ that you want to modify is tools/source/intntl/isolang.cxx (which
+ belongs at this time to the utilities project). You need to go to the
+ page of the Utilities project, click on "Version control", then click on
+ Tools, in the next page on Source, on intntl in the next, and finally
+ click on isolang,cxx. Right now, to make it easier we give you exactly
+ the direct URL of the page:</span></p>
+ <blockquote>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">
+ <a href="http://util.openoffice.org/source/browse/util/tools/source/intntl/isolang.cxx">
+ http://util.openoffice.org/source/browse/util/tools/source/intntl/isolang.cxx</a>
+ </span></p>
+ </blockquote>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">This page, at some point in history (when
+ this document was made), looked like this:</span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <img border="0" src="oo_images/imageCVS2.jpg" width="675" height="1134"></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">If you go into this page, you will see -
+ one after the other - all the revisions that the file has gone through
+ (first at the bottom, last at the top), and all the tags that relate to
+ each revision. The revision of the file that you are looking for is the
+ first one that you find (higher in the page) that has a tag that
+ includes the name of the branch that you are looking for. </span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">You need to click on "view" for that
+ revision, so that you will get a new page with some comments and then
+ the contents of the file. Select and copy the content of the file in the
+ browser and copy it to an empty utf-8 file (and save it with the same
+ name).</span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11.0pt"> </span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">Of course, you can always use CVS directly
+ (not webCVS) to get the right version of the file, if you now the tag,
+ but the tricky part is to know the exact tag of what you are looking
+ for, and using webCVS makes it easy to find. </span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">Now that you have the file that you want
+ to modify, keep a copy of the original (say old_isolang.cxx) and modify
+ what ever you need in your copy. Test it is needed be. Once you are
+ happy with it, and want to submit the changes to OpenOffice, you need to
+ do a "diff" between the old file and the new one. </span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">If you are working with Unix or Linux, all
+ you need to do is to use the "diff" command in the following way:</span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">diff -u [old_file] [new_file] > [patch_file]</span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">You might want to give to the patch file
+ the same name of the file, but adding to it a ".diff" or a ".patch"
+ extension, so that everybody knows what it contains.</span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">Windows has the same function in the
+ command prompt, so you can do the same thing on Windows, but you do need
+ to make sure that the result is a UTF-8 file with no BOM mark and with
+ Unix-like endings. </span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">You probably want to look at the file that
+ you just created with the diff command. It should list each line that
+ you have added, erased or changed from the original file. You might find
+ there changes that you did not want to make and that are not important
+ (such as one of the files have one more blank line at the end) or one
+ more space in some line. It is nice for whomever has to review your
+ patch, to make sure that those things are the same as the original, so
+ that the reviewer does not have to pay attention to them. Please modify
+ your file to be the same as the original in those unimportant things,
+ and do a new -cleaner- diff.</span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">If you are used to CVS, you follow a
+ slightly different process: you can uncheck the file from CVS, make your
+ modifications and the do the diff using also CVS, with the command:</span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">cvs diff -u </span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">This assures that the diff is done against
+ the last version, in case the file had changed from the time you
+ downloaded it.</span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11.0pt">As mentioned above, the patch file needs
+ to follow unix-like file conventions. It must be in UTF-8 format,
+ without a BOM mark (a mark at the beginning of the file which indicates
+ that it is in UTF format), and the line-endings inside the file must be
+ unix-style (0x0A character), and not DOS/Windows style (0x0D + 0x0A
+ characters). If</span><span style="font-size: 11pt"> you are working on
+ Windows and you wish to make sure that your file has Unix-like endings,
+ you can use the
+ <a href="http://www.khmeros.info/tools/NoDosNoBOM.exe">NoDosNoBOM utility</a>. It can be used with two
+ arguments, if you do not want the original file to be modified, as in:</span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">NoDosNoBOM [OriginalFile] [DestinationFile]</span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">or as</span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in"> </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">NoDosNoBOM [File]</span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in"> </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">if you want to make the changes in the
+ file itself.</span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in"> </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">When you use programs that modify your
+ files, you should always make a security copy of your files before you
+ start </span></p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in"> </p>
+ <p class="MsoNormal" style="text-align: justify; margin-left: .5in">
+ <span style="font-size: 11pt">As a hint, pure ASCII text files are also
+ UTF-8 files (the formats are compatible).</span></p>
+ <p class="MsoNormal"><span style="font-size: 11.0pt"> </span></p>
+ <p class="MsoNormal">
+ <p class="MsoNormal"> </td>
+ </tr>
+</table>
+
+
+
+ </div>
+
+ <div id="footera">
+ <div id="poweredbya">
+ <p><img src="/images/feather-small.gif"/></p>
+ </div>
+ <div id="copyrighta">
+ <p>
+ Apache "OpenOffice.org" is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator.
+ Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and
+ decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is
+ not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has
+ yet to be fully endorsed by the ASF.</p>
+ <p>
+ <a href="/license.html">Copyright & License</a>
+ <br />Apache and the Apache feather logos are trademarks of The Apache Software Foundation.
+ OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation.
+ Other names appearing on the site may be trademarks of their respective owners.
+ </p>
+ </div>
+ </div>
+
+</body>
+</html>