| <?xml version="1.0" encoding="ISO-8859-1"?> |
| |
| <!-- |
| Licensed to the Apache Software Foundation (ASF) under one |
| or more contributor license agreements. See the NOTICE file |
| distributed with this work for additional information |
| regarding copyright ownership. The ASF licenses this file |
| to you under the Apache License, Version 2.0 (the |
| "License"); you may not use this file except in compliance |
| with the License. You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, |
| software distributed under the License is distributed on an |
| "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| KIND, either express or implied. See the License for the |
| specific language governing permissions and limitations |
| under the License. |
| --> |
| |
| <document xmlns="http://maven.apache.org/XDOC/2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd"> |
| <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="Internationalization"> |
| <p> |
| 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> |
| |
| <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"> |
| <table> |
| <tr> |
| <th>Languages available</th> |
| <th>Site Plugin</th> |
| <th>Project Info Reports Plugin</th> |
| <th>Maven 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>Catalan</td> |
| <td> |
| <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_ca.properties">See</a> |
| </td> |
| <td> |
| N/A |
| </td> |
| <td> |
| <a href="http://svn.apache.org/repos/asf/maven/shared/trunk/maven-doxia-tools/src/main/resources/site-tool_ca.properties">See</a> |
| </td> |
| </tr> |
| <tr> |
| <td>Chinese (China)</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>Chinese (Taiwan)</td> |
| <td> |
| <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_zh_TW.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_TW.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_TW.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>Danish</td> |
| <td> |
| <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_da.properties">See</a> |
| </td> |
| <td> |
| N/A |
| </td> |
| <td> |
| <a href="http://svn.apache.org/repos/asf/maven/shared/trunk/maven-doxia-tools/src/main/resources/site-tool_da.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>Portuguese</td> |
| <td> |
| <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_pt.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.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.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> |
| <tr> |
| <td>Turkish</td> |
| <td> |
| <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/site-plugin_tr.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_tr.properties">See</a> |
| </td> |
| <td> |
| <a href="http://svn.apache.org/repos/asf/maven/shared/trunk/maven-doxia-tools/src/main/resources/site-tool_tr.properties">See</a> |
| </td> |
| </tr> |
| </table> |
| |
| <p> |
| To see the current level of localization support you can have a look |
| at the L10n Status Report for each one of them: |
| </p> |
| |
| <ul> |
| <li><a href="l10n-status.html">Site Plugin</a></li> |
| <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> |
| </subsection> |
| |
| <subsection name="Instructions for Translators"> |
| <p> |
| If you want to contribute a localization, follow these steps: |
| </p> |
| |
| <ol> |
| <li> |
| 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 files to the wanted locale. For example, |
| <code>site-plugin_de.properties</code> for a new German |
| translation for Maven Site Plugin. |
| </li> |
| <li> |
| Translate the files contents using your preferred text editor. |
| The files must use US-ASCII encoding. For characters that are not |
| included in US-ASCII you must use Unicode escapes, like "\u8ff0". |
| See the tools section below for examples of tools that can help |
| you to convert your texts to use Unicode escapes. |
| </li> |
| <li> |
| 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">Maven 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 version of |
| each of the above artifacts</li> |
| <li>Run "<code>mvn site</code>" on that project and test it</li> |
| </ul> |
| </li> |
| <li> |
| When you are happy with it, create a new issue in |
| <a href="http://jira.codehaus.org/browse/MSITE">JIRA</a> |
| and attach your files there. |
| </li> |
| </ol> |
| </subsection> |
| |
| <subsection name="References and Tools"> |
| <p> |
| Please refer to the |
| <a target="_blank" href="http://java.sun.com/javase/technologies/core/basic/intl/"> |
| 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: |
| </p> |
| |
| <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</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> |
| <li> |
| <b>IDE plugins</b>: <a href="http://propedit.sourceforge.jp/index_en.html">Properties Editor Eclipse Plugin</a>. |
| </li> |
| </ul> |
| |
| <p> |
| 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> |
| </body> |
| </document> |