| <?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> |
| <properties> |
| <title>Internationalization</title> |
| <author email="vincent.siveton@gmail.com">Vincent Siveton</author> |
| </properties> |
| <body> |
| <section name="Supported languages"> |
| <p> |
| <ul> |
| <li> |
| Maven-site-plugin |
| <br /> |
| <table> |
| <tr> |
| <th>Languages available</th> |
| <th> |
| Files |
| <a href="#note">*</a> |
| </th> |
| </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>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>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>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>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>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>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>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>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>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>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>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>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> |
| </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>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>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>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>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>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>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>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>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>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>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>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>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>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> |
| </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> |
| </p> |
| </section> |
| |
| <section name="Unsupported languages - Patches welcome!"> |
| <section name="Prerequisites"> |
| <p> |
| Please refer to |
| <a target="_blank" href="http://java.sun.com/j2se/corejava/intl/index.jsp"> |
| Java Internationalization home page</a>. |
| </p> |
| <p> |
| You could find here some useful tools to help you with charset questions: |
| <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 ShowEncodingPlugin</a>... |
| </li> |
| <li> |
| <b>Tools to write a file in a given charset like UTF-8</b>: any editor like Notepad, |
| Eclipse, Intellij... |
| </li> |
| <li> |
| <b>Tools to convert a file from one encoding to another encoding</b>: |
| Unix <i>iconv</i> command. |
| </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> |
| </section> |
| <section name="Instructions for translators"> |
| <p> |
| If your language is not currently supported and you want to contribute a translation, |
| follow these steps: |
| <ol> |
| <li> |
| Download one of the text files linked above as the base for your translation. For |
| instance, the English file. |
| </li> |
| <li> |
| Rename the file with the wanted locale. For example, site-plugin_de.properties 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>. |
| </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. |
| </li> |
| <li> |
| When happy with it, create a new issue in |
| <a href="http://jira.codehaus.org/browse/MSITE">JIRA</a> |
| and attach your file there. |
| </li> |
| </ol> |
| </p> |
| </section> |
| </section> |
| </body> |
| </document> |
