You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by de...@apache.org on 2008/03/23 15:22:54 UTC
svn commit: r640212 -
/maven/plugins/trunk/maven-site-plugin/src/site/xdoc/i18n.xml
Author: dennisl
Date: Sun Mar 23 07:22:49 2008
New Revision: 640212
URL: http://svn.apache.org/viewvc?rev=640212&view=rev
Log:
o Reorganize the layout of the page, especially the links to properties files, and include links and references to Doxia Tools.
o Rewrite instructions for translators according to the discussions we had about this.
Modified:
maven/plugins/trunk/maven-site-plugin/src/site/xdoc/i18n.xml
Modified: maven/plugins/trunk/maven-site-plugin/src/site/xdoc/i18n.xml
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-site-plugin/src/site/xdoc/i18n.xml?rev=640212&r1=640211&r2=640212&view=diff
==============================================================================
--- maven/plugins/trunk/maven-site-plugin/src/site/xdoc/i18n.xml (original)
+++ maven/plugins/trunk/maven-site-plugin/src/site/xdoc/i18n.xml Sun Mar 23 07:22:49 2008
@@ -23,397 +23,326 @@
<properties>
<title>Internationalization</title>
<author email="vincent.siveton@gmail.com">Vincent Siveton</author>
+ <author email="dennisl@apache.org">Dennis Lundberg</author>
</properties>
<body>
- <section name="Supported Languages">
+ <section name="Internationalization">
<p>
- <ul>
- <li>
- Maven Site Plugin
- <br />
- <table>
- <tr>
- <th>Languages available</th>
- <th>
- Files
- <a href="#note">*</a>
- </th>
- </tr>
- <tr>
- <td>Brazilian Portuguese</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_pt_BR.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Chinese simplified</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_zh_CN.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Czech</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_cs.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Dutch</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_nl.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>English (Default)</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>French</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_fr.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>German</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_de.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Hungarian</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_hu.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Italian</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_it.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Japanese</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_ja.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Korean</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_ko.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Norwegian</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_no.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Polish</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_pl.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Slovak</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_sk.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Spanish</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_es.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Swedish</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_sv.properties">
- See
- </a>
- </td>
- </tr>
- </table>
- <br />
- </li>
- <li>
- Maven Project Info Reports Plugin
- <br />
- <table>
- <tr>
- <th>Languages available</th>
- <th>
- Files
- <a href="#note">*</a>
- </th>
- </tr>
- <tr>
- <td>Brazilian Portuguese</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_pt_BR.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Chinese simplified</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_zh_CN.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Czech</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_cs.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Dutch</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_nl.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>English (Default)</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>French</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_fr.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>German</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_de.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Hungarian</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_hu.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Italian</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_it.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Japanese</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_ja.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Korean</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_ko.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Norwegian</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_no.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Polish</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_pl.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Slovak</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_sk.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Spanish</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_es.properties">
- See
- </a>
- </td>
- </tr>
- <tr>
- <td>Swedish</td>
- <td>
- <a
- href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_sv.properties">
- See
- </a>
- </td>
- </tr>
- </table>
- <br />
- </li>
- </ul>
- <a name="note">
- * The files linked above are the files used in the latest development code. So the file
- may be newer than the one included in the latest release.
- </a>
+ The site generation done by the Site Plugin and the Project Info
+ Reports Plugin is fully internationalized. This means that adapting them
+ to another language, a process known as localization, is very easy. All
+ that is needed is to download a couple of properties files and start
+ translating the texts in them. If you want to provide a patch for an
+ unsupported language, there are
+ <a href="#Instructions for Translators">detailed instructions</a> below.
</p>
- </section>
- <section name="Unsupported Languages - Patches welcome!">
- <subsection name="Prerequisites">
+ <p>
+ There are currently three files that needs to be localized to support a
+ new language. The following table summarizes the currently supported
+ languages.
+ </p>
+
+ <p>
+ <b>Note:</b> The files linked to below are the files used in the latest
+ development code. So the files may be newer than the ones included in
+ the latest release.
+ </p>
+
+ <subsection name="Supported Languages">
<p>
- Please refer to the
- <a target="_blank" href="http://java.sun.com/j2se/corejava/intl/index.jsp">
- Java Internationalization home page</a> for an introduction to the topic.
+ <table>
+ <tr>
+ <th>Languages available</th>
+ <th>Site Plugin</th>
+ <th>Project Info Reports Plugin</th>
+ <th>Doxia Tools</th>
+ </tr>
+ <tr>
+ <td>Brazilian Portuguese</td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_pt_BR.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_pt_BR.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/shared/trunk/maven-doxia-tools/src/main/resources/site-tool_pt_BR.properties">See</a>
+ </td>
+ </tr>
+ <tr>
+ <td>Chinese simplified</td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_zh_CN.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_zh_CN.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/shared/trunk/maven-doxia-tools/src/main/resources/site-tool_zh_CN.properties">See</a>
+ </td>
+ </tr>
+ <tr>
+ <td>Czech</td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_cs.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_cs.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/shared/trunk/maven-doxia-tools/src/main/resources/site-tool_cs.properties">See</a>
+ </td>
+ </tr>
+ <tr>
+ <td>Dutch</td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_nl.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_nl.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/shared/trunk/maven-doxia-tools/src/main/resources/site-tool_nl.properties">See</a>
+ </td>
+ </tr>
+ <tr>
+ <td>English (Default)</td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/shared/trunk/maven-doxia-tools/src/main/resources/site-tool.properties">See</a>
+ </td>
+ </tr>
+ <tr>
+ <td>French</td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_fr.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_fr.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/shared/trunk/maven-doxia-tools/src/main/resources/site-tool_fr.properties">See</a>
+ </td>
+ </tr>
+ <tr>
+ <td>German</td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_de.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_de.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/shared/trunk/maven-doxia-tools/src/main/resources/site-tool_de.properties">See</a>
+ </td>
+ </tr>
+ <tr>
+ <td>Hungarian</td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_hu.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_hu.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/shared/trunk/maven-doxia-tools/src/main/resources/site-tool_hu.properties">See</a>
+ </td>
+ </tr>
+ <tr>
+ <td>Italian</td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_it.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_it.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/shared/trunk/maven-doxia-tools/src/main/resources/site-tool_it.properties">See</a>
+ </td>
+ </tr>
+ <tr>
+ <td>Japanese</td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_ja.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_ja.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/shared/trunk/maven-doxia-tools/src/main/resources/site-tool_ja.properties">See</a>
+ </td>
+ </tr>
+ <tr>
+ <td>Korean</td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_ko.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_ko.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/shared/trunk/maven-doxia-tools/src/main/resources/site-tool_ko.properties">See</a>
+ </td>
+ </tr>
+ <tr>
+ <td>Norwegian</td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_no.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_no.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/shared/trunk/maven-doxia-tools/src/main/resources/site-tool_no.properties">See</a>
+ </td>
+ </tr>
+ <tr>
+ <td>Polish</td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_pl.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_pl.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/shared/trunk/maven-doxia-tools/src/main/resources/site-tool_pl.properties">See</a>
+ </td>
+ </tr>
+ <tr>
+ <td>Slovak</td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_sk.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_sk.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/shared/trunk/maven-doxia-tools/src/main/resources/site-tool_sk.properties">See</a>
+ </td>
+ </tr>
+ <tr>
+ <td>Spanish</td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_es.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_es.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/shared/trunk/maven-doxia-tools/src/main/resources/site-tool_es.properties">See</a>
+ </td>
+ </tr>
+ <tr>
+ <td>Swedish</td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_sv.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/project-info-report_sv.properties">See</a>
+ </td>
+ <td>
+ <a href="http://svn.apache.org/repos/asf/maven/shared/trunk/maven-doxia-tools/src/main/resources/site-tool_sv.properties">See</a>
+ </td>
+ </tr>
+ </table>
</p>
+
<p>
- You could find here some useful tools to help you with charset questions:
+ To see the current level of localization support you can have a look
+ at the L10n Status Report for each one of them:
<ul>
- <li>
- <b>Tools to know the charset of a file</b>: Unix <i>file</i> command,
- <a href="http://cpdetector.sourceforge.net/">cpdetector</a>,
- <a href="http://plugins.intellij.net/plugin/?id=24">IntelliJ IDEA ShowEncodingPlugin</a>, ...
- </li>
- <li>
- <b>Tools to write a file in a given charset like UTF-8</b>: any editor like Notepad,
- Eclipse, IntelliJ IDEA, ...
- </li>
- <li>
- <b>Tools to convert a file from one encoding to another encoding</b>:
- Unix <i>iconv</i> command.
- </li>
+ <li><a href="l10n-status.html">Site Plugin</a></li>
+ <!-- TODO: This one has not bee published yet. Remove this comment when that has been done.
+ <li><a href="http://maven.apache.org/plugins/maven-project-info-reports-plugin/l10n-status.html">Project Info Reports Plugin</a></li>
+ -->
+ <li><a href="http://maven.apache.org/shared/maven-doxia-tools/l10n-status.html">Doxia Tools</a></li>
</ul>
</p>
- <p>
- You could also refer to this Sun FAQ:
- <a href="http://developers.sun.com/global/technology/standards/reference/faqs/determining-file-encoding.html">
- How Can I Determine the Encoding of a File?</a>.
- </p>
</subsection>
+
<subsection name="Instructions for Translators">
<p>
- If your language is not currently supported and you want to contribute a translation,
- follow these steps:
+ If you want to contribute a localization, follow these steps:
<ol>
<li>
- Download one of the text files linked above as the base for your translation. For
- instance, the English file.
+ Download each of the three properties files linked above as
+ the base for your translation. Pick files from a language that you
+ understand well, for instance English.
</li>
<li>
- Rename the file with the wanted locale. For example, <code>site-plugin_de.properties</code> for a
- new German translation for the Maven Site Plugin.
+ Rename the files to the wanted locale. For example,
+ <code>site-plugin_de.properties</code> for a new German
+ translation for the Maven Site Plugin.
</li>
<li>
- Translate the file contents using your preferred text editor.
- <b>Make sure you save the file with UTF-8 encoding</b>.
+ Translate the files contents using your preferred text editor. If
+ the characters of your language are included in the ISO-8859-1
+ character set, then use that encoding for your files. Otherwise
+ either use Unicode escapes, like "\u8ff0", or save your files with
+ UTF-8 encoding.
</li>
<li>
- To test the translation, checkout the Site Plugin, include your file in
- <code>src/main/resources</code>, and run "<code>mvn install</code>"
- on the plugin, then "<code>mvn site</code>" on a project to test it.
+ To test your localization
+ <ul>
+ <li>Checkout the latest source for
+ <a href="source-repository.html">Site Plugin</a>,
+ <a href="http://maven.apache.org/plugins/maven-project-info-reports-plugin/source-repository.html">Project Info Reports Plugin</a> and
+ <a href="http://maven.apache.org/shared/maven-doxia-tools/source-repository.html">Doxia Tools</a></li>
+ <li>Include your files in <code>src/main/resources</code> for each one</li>
+ <li>Run "<code>mvn install</code>" for each one</li>
+ <li>Configure a project to produce a site in several locales</li>
+ <li>Make sure that it is using the latest SNAPSHOT versions of
+ the above artifacts</li>
+ <li>Run "<code>mvn site</code>" on that project to test it</li>
+ </ul>
</li>
<li>
- When happy with it, create a new issue in
+ When you are happy with it, create a new issue in
<a href="http://jira.codehaus.org/browse/MSITE">JIRA</a>
- and attach your file there.
+ and attach your files there.
</li>
</ol>
</p>
+ </subsection>
+
+ <subsection name="References and Tools">
+ <p>
+ Please refer to the
+ <a target="_blank" href="http://java.sun.com/j2se/corejava/intl/index.jsp">
+ Java Internationalization home page</a> for an introduction to the topic.
+ </p>
+
+ <p>
+ Here you can find some useful tools to help you with charset
+ questions and conversions:
+ <ul>
+ <li>
+ <b>Tools to find out the charset of a file</b>:
+ Unix <i>file</i> command,
+ <a href="http://cpdetector.sourceforge.net/">cpdetector</a>,
+ <a href="http://plugins.intellij.net/plugin/?id=24">IntelliJ IDEA ShowEncodingPlugin</a>,
+ <a href="http://notepad-plus.sourceforge.net/">Notepad++</a>, ...
+ </li>
+ <li>
+ <b>Tools to write a file in a given charset, like UTF-8</b>:
+ any editor like Notepad, Eclipse, IntelliJ IDEA, ...
+ </li>
+ <li>
+ <b>Tools to convert a file from one encoding to another encoding</b>:
+ Unix <i>iconv</i> command, Notepad++.
+ </li>
+ </ul>
+ </p>
<p>
- You could also refer to the <a href="l10n-status.html">L10n Status report</a>.
+ You can also refer to this Sun FAQ:
+ <a href="http://developers.sun.com/global/technology/standards/reference/faqs/determining-file-encoding.html">
+ How Can I Determine the Encoding of a File?</a>.
</p>
</subsection>
</section>