Modified: maven/website/content/plugins/localization.html ============================================================================== --- maven/website/content/plugins/localization.html (original) +++ maven/website/content/plugins/localization.html Sat Feb 18 20:40:58 2023 @@ -2,7 +2,7 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/markdown/plugins/localization.md at 2023-02-18 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/apt/plugins/localization.apt at 2023-02-18 | Rendered using Apache Maven Fluido Skin 1.11.1 --> <html xmlns="http://www.w3.org/1999/xhtml"; lang=""> @@ -10,7 +10,8 @@ <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M4" /> - <meta name="author" content="Dennis Lundberg, Vincent Siveton" /> + <meta name="author" content="Dennis Lundberg +Vincent Siveton" /> <meta name="date" content="2012-03-12" /> <title>Maven – Localization of Plugins</title> <link rel="stylesheet" href="../css/apache-maven-fluido-1.11.1.min.css" /> @@ -48,7 +49,7 @@ <ul class="breadcrumb"> <li class=""><a href="https://www.apache.org/"; class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li class=""><a href="../index.html" title="Maven">Maven</a><span class="divider">/</span></li> - <li class="active ">Localization of Plugins <a href="https://github.com/apache/maven-site/tree/master/content/markdown/plugins/localization.md";><img src="../images/accessories-text-editor.png" title="Edit" /></a></li> + <li class="active ">Localization of Plugins <a href="https://github.com/apache/maven-site/tree/master/content/apt/plugins/localization.apt";><img src="../images/accessories-text-editor.png" title="Edit" /></a></li> <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-18</li> <li class="pull-right"><span class="divider">|</span> <a href="../scm.html" title="Get Sources">Get Sources</a></li> @@ -123,32 +124,13 @@ </div> </header> <main id="bodyColumn" class="span10" > -<!-- -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. ---> -<section><section> -<h2>Localization of Plugins</h2> +<section> +<h1>Localization of Plugins</h1> <p>Most of the plugins involved with the site generation are 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 detailed instructions below.</p> <p>For the basic site generation there are currently files for three components that needs to be localized to support a new language: Maven Site Plugin, Maven Project Info Reports Plugin and Maven Doxia Tools.</p> -<p><strong>Note:</strong> The links to SVN below goes to the latest development code. So the files may be newer than the ones included in the latest release.</p> +<p><b>Note:</b> The links to SVN below goes to the latest development code. So the files may be newer than the ones included in the latest release.</p> <p>In the table below you can see our localized plugins and which languages they are available in.</p> -<table class="table table-striped"> -<thead> +<table class="bodyTable bodyTableBorder"> <tr class="a"> <th>Plugin</th> <th>ca</th> @@ -175,381 +157,369 @@ under the License. <th>zh_CN</th> <th>zh_TW</th> <th>l10n report</th> -<th>SVN</th></tr></thead><tbody> +<th>SVN</th></tr> <tr class="b"> -<td>Changelog</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td><a href="/plugins/maven-changelog-plugin/l10n-status.html">l10n report</a></td> -<td><a href="https://svn.apache.org/repos/asf/maven/plugins/trunk/maven-changelog-plugin/src/main/resources/"; class="externalLink">SVN</a></td></tr> +<td style="text-align: left;">Changelog</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;"><a href="/plugins/maven-changelog-plugin/l10n-status.html">l10n report</a></td> +<td style="text-align: left;"><a class="externalLink" href="https://svn.apache.org/repos/asf/maven/plugins/trunk/maven-changelog-plugin/src/main/resources/";>SVN</a></td></tr> <tr class="a"> -<td>Changes</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td><a href="/plugins/maven-changes-plugin/l10n-status.html">l10n report</a></td> -<td><a href="https://svn.apache.org/repos/asf/maven/plugins/trunk/maven-changes-plugin/src/main/resources/"; class="externalLink">SVN</a></td></tr> +<td style="text-align: left;">Changes</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;"><a href="/plugins/maven-changes-plugin/l10n-status.html">l10n report</a></td> +<td style="text-align: left;"><a class="externalLink" href="https://svn.apache.org/repos/asf/maven/plugins/trunk/maven-changes-plugin/src/main/resources/";>SVN</a></td></tr> <tr class="b"> -<td>Checkstyle</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td><a href="/plugins/maven-checkstyle-plugin/l10n-status.html">l10n report</a></td> -<td><a href="https://svn.apache.org/repos/asf/maven/plugins/trunk/maven-checkstyle-plugin/src/main/resources/"; class="externalLink">SVN</a></td></tr> +<td style="text-align: left;">Checkstyle</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;"><a href="/plugins/maven-checkstyle-plugin/l10n-status.html">l10n report</a></td> +<td style="text-align: left;"><a class="externalLink" href="https://svn.apache.org/repos/asf/maven/plugins/trunk/maven-checkstyle-plugin/src/main/resources/";>SVN</a></td></tr> <tr class="a"> -<td>Dependency</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td><a href="/plugins/maven-dependency-plugin/l10n-status.html">l10n report</a></td> -<td><a href="https://svn.apache.org/repos/asf/maven/plugins/trunk/maven-dependency-plugin/src/main/resources/"; class="externalLink">SVN</a></td></tr> +<td style="text-align: left;">Dependency</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;"><a href="/plugins/maven-dependency-plugin/l10n-status.html">l10n report</a></td> +<td style="text-align: left;"><a class="externalLink" href="https://svn.apache.org/repos/asf/maven/plugins/trunk/maven-dependency-plugin/src/main/resources/";>SVN</a></td></tr> <tr class="b"> -<td>DOAP</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td><a href="/plugins/maven-doap-plugin/l10n-status.html">l10n report</a></td> -<td><a href="https://svn.apache.org/repos/asf/maven/plugins/trunk/maven-doap-plugin/src/main/resources/"; class="externalLink">SVN</a></td></tr> +<td style="text-align: left;">DOAP</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;"><a href="/plugins/maven-doap-plugin/l10n-status.html">l10n report</a></td> +<td style="text-align: left;"><a class="externalLink" href="https://svn.apache.org/repos/asf/maven/plugins/trunk/maven-doap-plugin/src/main/resources/";>SVN</a></td></tr> <tr class="a"> -<td>Doxia Integration Tools</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td><a href="/doxia/doxia-tools/doxia-integration-tools/l10n-status.html">l10n report</a></td> -<td><a href="https://svn.apache.org/repos/asf/maven/doxia/doxia-sitetools/trunk/doxia-integration-tools/src/main/resources/"; class="externalLink">SVN</a></td></tr> +<td style="text-align: left;">Doxia Integration Tools</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;"><a href="/doxia/doxia-tools/doxia-integration-tools/l10n-status.html">l10n report</a></td> +<td style="text-align: left;"><a class="externalLink" href="https://svn.apache.org/repos/asf/maven/doxia/doxia-sitetools/trunk/doxia-integration-tools/src/main/resources/";>SVN</a></td></tr> <tr class="b"> -<td>Javadoc</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td><a href="/plugins/maven-javadoc-plugin/l10n-status.html">l10n report</a></td> -<td><a href="https://svn.apache.org/repos/asf/maven/plugins/trunk/maven-javadoc-plugin/src/main/resources/"; class="externalLink">SVN</a></td></tr> +<td style="text-align: left;">Javadoc</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;"><a href="/plugins/maven-javadoc-plugin/l10n-status.html">l10n report</a></td> +<td style="text-align: left;"><a class="externalLink" href="https://svn.apache.org/repos/asf/maven/plugins/trunk/maven-javadoc-plugin/src/main/resources/";>SVN</a></td></tr> <tr class="a"> -<td>JXR</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td><a href="/plugins/maven-jxr-plugin/l10n-status.html">l10n report</a></td> -<td><a href="https://svn.apache.org/repos/asf/maven/jxr/trunk/maven-jxr-plugin/src/main/resources/"; class="externalLink">SVN</a></td></tr> +<td style="text-align: left;">JXR</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;"><a href="/plugins/maven-jxr-plugin/l10n-status.html">l10n report</a></td> +<td style="text-align: left;"><a class="externalLink" href="https://svn.apache.org/repos/asf/maven/jxr/trunk/maven-jxr-plugin/src/main/resources/";>SVN</a></td></tr> <tr class="b"> -<td>PMD</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td><a href="/plugins/maven-pmd-plugin/l10n-status.html">l10n report</a></td> -<td><a href="https://svn.apache.org/repos/asf/maven/plugins/trunk/maven-pmd-plugin/src/main/resources/"; class="externalLink">SVN</a></td></tr> +<td style="text-align: left;">PMD</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;"><a href="/plugins/maven-pmd-plugin/l10n-status.html">l10n report</a></td> +<td style="text-align: left;"><a class="externalLink" href="https://svn.apache.org/repos/asf/maven/plugins/trunk/maven-pmd-plugin/src/main/resources/";>SVN</a></td></tr> <tr class="a"> -<td>Plugin</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td><a href="/plugins/maven-plugin-plugin/l10n-status.html">l10n report</a></td> -<td><a href="https://svn.apache.org/repos/asf/maven/plugin-tools/trunk/maven-plugin-plugin/src/main/resources/"; class="externalLink">SVN</a></td></tr> +<td style="text-align: left;">Plugin</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;"><a href="/plugins/maven-plugin-plugin/l10n-status.html">l10n report</a></td> +<td style="text-align: left;"><a class="externalLink" href="https://svn.apache.org/repos/asf/maven/plugin-tools/trunk/maven-plugin-plugin/src/main/resources/";>SVN</a></td></tr> <tr class="b"> -<td>Project Info Reports</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td><a href="/plugins/maven-project-info-reports-plugin/l10n-status.html">l10n report</a></td> -<td><a href="https://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/"; class="externalLink">SVN</a></td></tr> +<td style="text-align: left;">Project Info Reports</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;"><a href="/plugins/maven-project-info-reports-plugin/l10n-status.html">l10n report</a></td> +<td style="text-align: left;"><a class="externalLink" href="https://svn.apache.org/repos/asf/maven/plugins/trunk/maven-project-info-reports-plugin/src/main/resources/";>SVN</a></td></tr> <tr class="a"> -<td>Surefire report</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td>OK</td> -<td>-</td> -<td>-</td> -<td>-</td> -<td><a href="/plugins/maven-surefire-report-plugin/l10n-status.html">l10n report</a></td> -<td><a href="https://svn.apache.org/repos/asf/maven/surefire/trunk/maven-surefire-report-plugin/src/main/resources/"; class="externalLink">SVN</a></td></tr> +<td style="text-align: left;">Surefire report</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;">-</td> +<td style="text-align: left;"><a href="/plugins/maven-surefire-report-plugin/l10n-status.html">l10n report</a></td> +<td style="text-align: left;"><a class="externalLink" href="https://svn.apache.org/repos/asf/maven/surefire/trunk/maven-surefire-report-plugin/src/main/resources/";>SVN</a></td></tr> <tr class="b"> -<td>Site</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td>OK</td> -<td><a href="/plugins/maven-site-plugin/l10n-status.html">l10n report</a></td> -<td><a href="https://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/"; class="externalLink">SVN</a></td></tr></tbody> -</table> - +<td style="text-align: left;">Site</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;">OK</td> +<td style="text-align: left;"><a href="/plugins/maven-site-plugin/l10n-status.html">l10n report</a></td> +<td style="text-align: left;"><a class="externalLink" href="https://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin/src/main/resources/";>SVN</a></td></tr></table> <p>Is your favourite plugin missing a localization for your language? Please help us expand the language support by following the instructions below.</p><section> -<h3>Localizing a Plugin</h3> +<h2>Localizing a Plugin</h2> <ul> - -<li> -<p>Check out the source code for the plugin you want to add a translation to.</p></li> -<li> -<p>Find the resource bundles that needs to be translated. They are often found in the <code>src/main/resources</code> directory.</p></li> -<li> -<p>Copy the basefile for the bundle, i.e. the one <strong>without</strong> a language extension. The copy should have the same name as the original file, except for the addition of a language extension. If, for example, you want to translate the Checkstyle Plugin into Spanish, you would copy <code>src/main/resources/checkstyle-report.properties</code> to <code>src/main/resources/checkstyle-report_es.properties</code>.</p></li> -<li> -<p>Edit the new file and translate all the properties. Do not change the formating of the file, i.e. keep the current indentation and line breaks. This makes it easy to use a graphical diff tool to find missing keys in the file.</p></li> -<li> -<p>Convert the new file so that all non-US-ASCII characters are transformed into Unicode escapes, see below for a tool that can help with this.</p></li> -<li> -<p>Run “mvn install” for the plugin.</p></li> -<li> -<p>Configure a project to use the latest SNAPSHOT version of the plugin you are working on. Also configure the project to produce a site in the language you are adding a translation for. For Spanish, as we used in the example above, it would look like this:</p></li> -</ul> - -<div class="source"><pre class="prettyprint linenums"><code class="language-xml"> <build> +<li>Check out the source code for the plugin you want to add a translation to.</li> +<li>Find the resource bundles that needs to be translated. They are often found in the <code>src/main/resources</code> folder.</li> +<li>Copy the basefile for the bundle, i.e. the one <b>without</b> a language extension. The copy should have the same name as the original file, except for the addition of a language extension. If, for example, you want to translate the Checkstyle Plugin into Spanish, you would copy <code>src/main/resources/checkstyle-report.properties</code> to <code>src/main/resources/checkstyle-report_es.properties</code>.</li> +<li>Edit the new file and translate all the properties. Do not change the formating of the file, i.e. keep the current indentation and line breaks. This makes it easy to use a graphical diff tool to find missing keys in the file.</li> +<li>Convert the new file so that all non-US-ASCII characters are transformed into Unicode escapes, see below for a tool that can help with this.</li> +<li>Run "mvn install" for the plugin.</li> +<li>Configure a project to use the latest SNAPSHOT version of the plugin you are working on. Also configure the project to produce a site in the language you are adding a translation for. For Spanish, as we used in the example above, it would look like this: +<div class="source"><pre class="prettyprint linenums"> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> @@ -559,59 +529,35 @@ under the License. </configuration> </plugin> </plugins> - </build> -</code></pre></div> -<ul> - -<li> -<p>Run “mvn site” on that project to test it.</p></li> -<li> -<p>When you are happy with your translation, create an issue in JIRA for the plugin in question, with a description like this: “Add Spanish translation”. Take note of the issue number.</p></li> -<li> -<p>Create a patch file that contains your new translation. Use the issue number when you name the file:</p></li> -</ul> - -<div class="source"><pre class="prettyprint linenums"><code>svn diff > MYISSUE-123.patch -</code></pre></div> -<ul> - -<li>Attach your patch file to the issue in JIRA.</li> -</ul></section><section> -<h3>Tools</h3> -<p>There is a command line tool called <strong>native2ascii</strong> that can be used to convert a text file to use Unicode-encoded characters instead of native-encoded characters. This is part of the Java SDK and you can <a href="http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/native2ascii.html"; class="externalLink">read more about it here</a>. You use it like this:</p> - -<div class="source"><pre class="prettyprint linenums"><code>native2ascii checkstyle-report_es.properties checkstyle-report_es-encoded.properties -</code></pre></div><section> -<h4>Tools to find out the charset of a file</h4> + </build></pre></div></li> +<li>Run "mvn site" on that project to test it.</li> +<li>When you are happy with your translation, create an issue in JIRA for the plugin in question, with a description like this: "Add Spanish translation". Take note of the issue number.</li> +<li>Create a patch file that contains your new translation. Use the issue number when you name the file: +<div> +<pre>svn diff > MYISSUE-123.patch</pre></div></li> +<li>Attach your patch file to the issue in JIRA.</li></ul></section><section> +<h2>Tools</h2> +<p>There is a command line tool called <b>native2ascii</b> that can be used to convert a text file to use Unicode-encoded characters instead of native-encoded characters. This is part of the Java SDK and you can <a class="externalLink" href="http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/native2ascii.html";>read more about it here</a>. You use it like this:</p> +<div> +<pre>native2ascii checkstyle-report_es.properties checkstyle-report_es-encoded.properties</pre></div><section> +<h3>Tools to find out the charset of a file</h3> <ul> - -<li> -<p>Unix <code>file</code> command</p></li> -<li> -<p><a href="http://cpdetector.sourceforge.net/"; class="externalLink">cpdetector</a></p></li> -<li> -<p><a href="http://plugins.intellij.net/plugin/?id=24"; class="externalLink">IntelliJ IDEA ShowEncodingPlugin</a></p></li> -<li> -<p><a href="http://notepad-plus.sourceforge.net/"; class="externalLink">Notepad++</a></p></li> -</ul></section><section> -<h4>Tools to write a file in a given charset</h4> -<p>Any editor like Notepad++, Eclipse, IntelliJ IDEA, …</p></section><section> -<h4>Tools to convert a file from one encoding to another encoding</h4> +<li>Unix <code>file</code> command</li> +<li><a class="externalLink" href="http://cpdetector.sourceforge.net/";>cpdetector</a></li> +<li><a class="externalLink" href="http://plugins.intellij.net/plugin/?id=24";>IntelliJ IDEA ShowEncodingPlugin</a></li> +<li><a class="externalLink" href="http://notepad-plus.sourceforge.net/";>Notepad++</a></li></ul></section><section> +<h3>Tools to write a file in a given charset</h3> +<p>Any editor like Notepad++, Eclipse, IntelliJ IDEA, ...</p></section><section> +<h3>Tools to convert a file from one encoding to another encoding</h3> <ul> - -<li> -<p>Unix <code>iconv</code> command</p></li> -<li> -<p>Notepad++</p></li> -</ul></section><section> -<h4>IDE plugins</h4> +<li>Unix <code>iconv</code> command</li> +<li>Notepad++</li></ul></section><section> +<h3>IDE plugins</h3> <ul> - -<li><a href="http://propedit.sourceforge.jp/index_en.html"; class="externalLink">Properties Editor Eclipse Plugin</a></li> -</ul></section></section><section> -<h3>References</h3> -<p>Please refer to the <a href="http://java.sun.com/javase/technologies/core/basic/intl/"; class="externalLink">Java Internationalization home page</a> for an introduction to the topic.</p> -<p>You can also refer to this Sun FAQ: <a href="http://developers.sun.com/global/technology/standards/reference/faqs/determining-file-encoding.html"; class="externalLink">How Can I Determine the Encoding of a File?</a></p></section></section></section> +<li><a class="externalLink" href="http://propedit.sourceforge.jp/index_en.html";>Properties Editor Eclipse Plugin</a></li></ul></section></section><section> +<h2>References</h2> +<p>Please refer to the <a class="externalLink" href="http://java.sun.com/javase/technologies/core/basic/intl/";>Java Internationalization home page</a> for an introduction to the topic.</p> +<p>You can also refer to this Sun FAQ: <a class="externalLink" 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> </main> </div> </div>
Modified: maven/website/content/repository/central-index.html ============================================================================== --- maven/website/content/repository/central-index.html (original) +++ maven/website/content/repository/central-index.html Sat Feb 18 20:40:58 2023 @@ -2,7 +2,7 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/markdown/repository/central-index.md at 2023-02-18 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/apt/repository/central-index.apt at 2023-02-18 | Rendered using Apache Maven Fluido Skin 1.11.1 --> <html xmlns="http://www.w3.org/1999/xhtml"; lang=""> @@ -48,7 +48,7 @@ <ul class="breadcrumb"> <li class=""><a href="https://www.apache.org/"; class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li class=""><a href="../index.html" title="Maven">Maven</a><span class="divider">/</span></li> - <li class="active ">Central Index <a href="https://github.com/apache/maven-site/tree/master/content/markdown/repository/central-index.md";><img src="../images/accessories-text-editor.png" title="Edit" /></a></li> + <li class="active ">Central Index <a href="https://github.com/apache/maven-site/tree/master/content/apt/repository/central-index.apt";><img src="../images/accessories-text-editor.png" title="Edit" /></a></li> <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-18</li> <li class="pull-right"><span class="divider">|</span> <a href="../scm.html" title="Get Sources">Get Sources</a></li> @@ -138,48 +138,21 @@ </div> </header> <main id="bodyColumn" class="span10" > -<!-- -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. ---> -<section><section> -<h2>Central Index</h2> -<p>Central repository provides <a href="https://repo.maven.apache.org/maven2/.index/"; class="externalLink">an index</a> that is updated weekly as full (<code>nexus-maven-repository-index.gz</code>) and incremental (<code>nexus-maven-repository-index.<n>.gz</code> + <code>nexus-maven-repository-index.properties</code>).</p> +<section> +<h1>Central Index</h1> +<p>Central repository provides <a class="externalLink" href="https://repo.maven.apache.org/maven2/.index/";>an index</a> that is updated weekly as full (<code>nexus-maven-repository-index.gz</code>) and incremental (<code>nexus-maven-repository-index.<n>.gz</code> + <code>nexus-maven-repository-index.properties</code>).</p> <p>This index is build using <a href="/maven-indexer/">Maven Indexer</a>: see <a href="/maven-indexer-archives/maven-indexer-LATEST/indexer-core/">LATEST indexer-core documentation</a> for more details on the fields that are available.</p> -<p>You can use <a href="/maven-indexer-archives/maven-indexer-LATEST/indexer-core/apidocs/">Maven Indexer API</a> (see <a href="/maven-indexer-archives/maven-indexer-LATEST/indexer-examples/">examples</a>) to use this index with a dedicated API, or use <a href="http://lucene.apache.org/"; class="externalLink">Apache Lucene</a> indexes browsers like <a href="https://github.com/DmitryKey/luke"; class="externalLink">Luke</a> or <a href="https://github.com/flaxsearch/marple"; class="externalLink">Marple</a> after unpacking the index (see <a href="/maven-indexer-archives/maven-indexer-LATEST/indexer-cli/"><code>-u</code> CLI option</a>).</p><section> -<h3>Digging Into Central Index with Luke</h3> +<p>You can use <a href="/maven-indexer-archives/maven-indexer-LATEST/indexer-core/apidocs/">Maven Indexer API</a> (see <a href="/maven-indexer-archives/maven-indexer-LATEST/indexer-examples/">examples</a>) to use this index with a dedicated API, or use <a class="externalLink" href="http://lucene.apache.org/";>Apache Lucene</a> indexes browsers like <a class="externalLink" href="https://github.com/DmitryKey/luke";>Luke</a> or <a class="externalLink" href="https://github.com/flaxsearch/marple";>Marple</a> after unpacking the index (see <a href="/maven-indexer-archives/maven-indexer-LATEST/indexer-cli/"><code>-u</code> CLI option</a>).</p><section> +<h2>Digging Into Central Index with Luke</h2> <ul> - -<li> -<p>download <a href="https://repo.maven.apache.org/maven2/.index/"; class="externalLink">the Central index: <code>nexus-maven-repository-index.gz</code></a></p></li> -<li> -<p>download <a href="https://repo.maven.apache.org/maven2/org/apache/maven/indexer/indexer-cli/5.1.1/indexer-cli-5.1.1.jar"; class="externalLink">Maven Indexer CLI</a> and <a href="/maven-indexer-archives/maven-indexer-LATEST/indexer-cli/">unpack</a> the index to raw Lucene index directory:</p></li> -</ul> - -<div class="source"><pre class="prettyprint linenums"><code>java -jar indexer-cli-5.1.1.jar --unpack nexus-maven-repository-index.gz --destination central-lucene-index --type full -</code></pre></div> -<ul> - -<li>download and extract <a href="https://github.com/DmitryKey/luke/releases/download/luke-4.10.4/luke-with-deps.tar.gz"; class="externalLink">Luke binary tarball</a> and launch it on the Central index with Lucene format:</li> -</ul> - -<div class="source"><pre class="prettyprint linenums"><code class="language-bash">luke.sh -ro -index central-lucene-index -</code></pre></div> -<p>You need an old Luke version using an old Lucene version, since Maven Indexer 5.5.1 uses Lucene 3.6.2: for this tutorial, we chose Luke version 4.10.4, but you may choose another version.</p></section></section></section> +<li>download <a class="externalLink" href="https://repo.maven.apache.org/maven2/.index/";>the Central index: <code>nexus-maven-repository-index.gz</code></a></li> +<li>download <a class="externalLink" href="https://repo.maven.apache.org/maven2/org/apache/maven/indexer/indexer-cli/5.1.1/indexer-cli-5.1.1.jar";>Maven Indexer CLI</a> and <a href="/maven-indexer-archives/maven-indexer-LATEST/indexer-cli/">unpack</a> the index to raw Lucene index directory: +<div> +<pre>java -jar indexer-cli-5.1.1.jar --unpack nexus-maven-repository-index.gz --destination central-lucene-index --type full</pre></div></li> +<li>download and extract <a class="externalLink" href="https://github.com/DmitryKey/luke/releases/download/luke-4.10.4/luke-with-deps.tar.gz";>Luke binary tarball</a> and launch it on the Central index with Lucene format: +<div> +<pre>luke.sh -ro -index central-lucene-index</pre></div> +<p>You need an old Luke version using an old Lucene version, since Maven Indexer 5.5.1 uses Lucene 3.6.2: for this tutorial, we chose Luke version 4.10.4, but you may choose another version.</p></li></ul></section></section> </main> </div> </div> Modified: maven/website/content/repository/central-metadata.html ============================================================================== --- maven/website/content/repository/central-metadata.html (original) +++ maven/website/content/repository/central-metadata.html Sat Feb 18 20:40:58 2023 @@ -2,7 +2,7 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/markdown/repository/central-metadata.md at 2023-02-18 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/apt/repository/central-metadata.apt at 2023-02-18 | Rendered using Apache Maven Fluido Skin 1.11.1 --> <html xmlns="http://www.w3.org/1999/xhtml"; lang=""> @@ -48,7 +48,7 @@ <ul class="breadcrumb"> <li class=""><a href="https://www.apache.org/"; class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li class=""><a href="../index.html" title="Maven">Maven</a><span class="divider">/</span></li> - <li class="active ">Guide to Metadata in Central Maven Repository <a href="https://github.com/apache/maven-site/tree/master/content/markdown/repository/central-metadata.md";><img src="../images/accessories-text-editor.png" title="Edit" /></a></li> + <li class="active ">Guide to Metadata in Central Maven Repository <a href="https://github.com/apache/maven-site/tree/master/content/apt/repository/central-metadata.apt";><img src="../images/accessories-text-editor.png" title="Edit" /></a></li> <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-18</li> <li class="pull-right"><span class="divider">|</span> <a href="../scm.html" title="Get Sources">Get Sources</a></li> @@ -138,34 +138,16 @@ </div> </header> <main id="bodyColumn" class="span10" > -<!-- -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. ---> -<section><section> -<h2>Guide to add, improve or fix metadata in the Central Maven Repository</h2><section> -<h3>POM Metadata</h3> -<p>There are artifacts in the <a href="./">Central Maven repository</a> that don't have POMs. They come from projects with repositories that have been synced into central without extra checks (particularly historical ones that were in <em>Maven 1</em> format). We know about the problems but can't do anything unless you provide a POM for it or you ask the project in question to add the POM when they add the artifacts.</p> +<section> +<h1>Guide to add, improve or fix metadata in the Central Maven Repository</h1><section> +<h2>POM Metadata</h2> +<p>There are artifacts in the <a href="./">Central Maven repository</a> that don't have POMs. They come from projects with repositories that have been synced into central without extra checks (particularly historical ones that were in <i>Maven 1</i> format). We know about the problems but can't do anything unless you provide a POM for it or you ask the project in question to add the POM when they add the artifacts.</p> <p>We don't change dependencies in POMs already in the repository anymore as builds need to be reproducible. Same applies to POMs that don't exist. We can only add a POM with no dependencies, because doing any other way would break previous builds that were using that artifact.</p> -<p>An alternative is to create a new version with the fixes. If the broken artifact is <code>org.foo/bar/1.0</code> you can provide a fixed POM, JAR,… under <code>org.foo/bar/1.0-1</code> (add a comment to the POM explaining what is being fixed and why). See <a href="./guide-central-repository-upload.html">Maven Repository Upload</a> for the instructions to get this new version in the repository.</p> +<p>An alternative is to create a new version with the fixes. If the broken artifact is <code>org.foo/bar/1.0</code> you can provide a fixed POM, JAR,... under <code>org.foo/bar/1.0-1</code> (add a comment to the POM explaining what is being fixed and why). See <a href="./guide-central-repository-upload.html">Maven Repository Upload</a> for the instructions to get this new version in the repository.</p> <p>You need to contact the original publisher of the metadata to make sure in next versions it will be fixed or improved before getting it into the repository.</p></section><section> -<h3>Other Issues</h3> -<p>For any other types of issues related to metadata in the repository (POM related, or <a href="/ref/current/maven-repository-metadata/"><code>maven-metadata.xml</code></a>, or anything else), open an issue at <a href="https://issues.sonatype.org/browse/MVNCENTRAL"; class="externalLink">MVNCENTRAL</a> with the relevant information and explain the reasons why it is an issue.</p> -<p><strong>Important:</strong> by default assume that we won't trust your info, so you must provide all links to the project documentation you can to convince us that your solution is right.</p></section></section></section> +<h2>Other Issues</h2> +<p>For any other types of issues related to metadata in the repository (POM related, or <a href="/ref/current/maven-repository-metadata/"><code>maven-metadata.xml</code></a>, or anything else), open an issue at <a class="externalLink" href="https://issues.sonatype.org/browse/MVNCENTRAL";>MVNCENTRAL</a> with the relevant information and explain the reasons why it is an issue.</p> +<p><b>Important:</b> by default assume that we won't trust your info, so you must provide all links to the project documentation you can to convince us that your solution is right.</p></section></section> </main> </div> </div> Modified: maven/website/content/repository/guide-central-repository-upload.html ============================================================================== --- maven/website/content/repository/guide-central-repository-upload.html (original) +++ maven/website/content/repository/guide-central-repository-upload.html Sat Feb 18 20:40:58 2023 @@ -2,7 +2,7 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/markdown/repository/guide-central-repository-upload.md at 2023-02-18 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/apt/repository/guide-central-repository-upload.apt at 2023-02-18 | Rendered using Apache Maven Fluido Skin 1.11.1 --> <html xmlns="http://www.w3.org/1999/xhtml"; lang=""> @@ -10,7 +10,8 @@ <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M4" /> - <meta name="author" content="Jason van Zyl, Brian Fox" /> + <meta name="author" content="Jason van Zyl +Brian Fox" /> <meta name="date" content="2018-12-31" /> <title>Maven – Guide to uploading artifacts to the Central Repository</title> <link rel="stylesheet" href="../css/apache-maven-fluido-1.11.1.min.css" /> @@ -48,7 +49,7 @@ <ul class="breadcrumb"> <li class=""><a href="https://www.apache.org/"; class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li class=""><a href="../index.html" title="Maven">Maven</a><span class="divider">/</span></li> - <li class="active ">Guide to uploading artifacts to the Central Repository <a href="https://github.com/apache/maven-site/tree/master/content/markdown/repository/guide-central-repository-upload.md";><img src="../images/accessories-text-editor.png" title="Edit" /></a></li> + <li class="active ">Guide to uploading artifacts to the Central Repository <a href="https://github.com/apache/maven-site/tree/master/content/apt/repository/guide-central-repository-upload.apt";><img src="../images/accessories-text-editor.png" title="Edit" /></a></li> <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-18</li> <li class="pull-right"><span class="divider">|</span> <a href="../scm.html" title="Get Sources">Get Sources</a></li> @@ -138,41 +139,23 @@ </div> </header> <main id="bodyColumn" class="span10" > -<!-- -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. ---> -<section><section> -<h2>Guide to uploading artifacts to the Central Repository</h2> +<section> +<h1>Guide to uploading artifacts to the Central Repository</h1> <p>In order for users of Maven to utilize artifacts produced by your project, you must deploy them to a remote repository. Many open source projects want to allow users of their projects who build with Maven to have transparent access to their project's artifacts. In order to allow for this, a project should deploy their artifacts to the <a href="/repository/">Central Repository</a>.</p></section><section> -<h2>Requirements</h2> -<p>1 <strong>releases</strong>: Only <em>releases</em> can be uploaded to the Central Repository, that means files that won't change and that only depend on other files already released and available in the repository,</p> -<p>1 <strong>javadoc and sources</strong> for IDE lookup,</p> -<p>1 <strong>PGP signature</strong>,</p> -<p>1 <strong>minimum POM information</strong>: There are some requirements for the minimal information in the POMs that are in the Central Repository, see <a href="https://central.sonatype.org/pages/requirements.html#sufficient-metadata"; class="externalLink">here</a>,</p> -<p>1 <strong>coordinates</strong>: Picking the appropriate coordinates for your project is important. See the guidelines <a href="https://central.sonatype.org/pages/choosing-your-coordinates.html"; class="externalLink">here</a>, particularly on <a href="https://central.sonatype.org/pages/producers.html#individual-projects-open-source-software-repository-hosting-ossrh"; class="externalLink">groupId and domain ownership</a>.</p> -<p>The updated list of requirements can be found <strong><a href="https://central.sonatype.org/pages/requirements.html"; class="externalLink">here</a></strong>.</p><section> -<h3>Explanation</h3> -<p>Some folks have asked <em>“why do we require all this information in the POM for deployed artifacts?”</em>, so here's a small explanation.</p> +<h1>Requirements</h1> +<ol style="list-style-type: decimal"> +<li><b>releases</b>: Only <i>releases</i> can be uploaded to the Central Repository, that means files that won't change and that only depend on other files already released and available in the repository,</li> +<li><b>javadoc and sources</b> for IDE lookup,</li> +<li><b>PGP signature</b>,</li> +<li><b>minimum POM information</b>: There are some requirements for the minimal information in the POMs that are in the Central Repository, see <a class="externalLink" href="https://central.sonatype.org/pages/requirements.html#sufficient-metadata";>here</a>, </li> +<li><b>coordinates</b>: Picking the appropriate coordinates for your project is important. See the guidelines <a class="externalLink" href="https://central.sonatype.org/pages/choosing-your-coordinates.html";>here</a>, particularly on <a class="externalLink" href="https://central.sonatype.org/pages/producers.html#individual-projects-open-source-software-repository-hosting-ossrh";>groupId and domain ownership</a>.</li></ol> +<p>The updated list of requirements can be found <b><a class="externalLink" href="https://central.sonatype.org/pages/requirements.html";>here</a></b>.</p><section> +<h2>Explanation</h2> +<p>Some folks have asked <i>"why do we require all this information in the POM for deployed artifacts?"</i>, so here's a small explanation.</p> <p>The POM being deployed with the artifact is part of the process to make transitive dependencies a reality in Maven. The logic for getting transitive dependencies working is really not that hard, the problem is getting the data. The other applications that are made possible by having all the POMs available for artifacts are vast, so by placing them into the Central Repository as part of the process we open up the doors to new ideas that involve unified access to project POMs.</p> <p>We ask for the license because it is possible that your project's license may change in the course of its lifetime, and we are trying to create tools to help sort out licensing issues. For example, knowing all the licenses for a particular graph of artifacts, we could have some strategies that would identify potential licensing problems.</p></section><section> -<h3>A basic sample</h3> - -<div class="source"><pre class="prettyprint linenums"><code class="language-xml"> +<h2>A basic sample:</h2> +<div class="source"><pre class="prettyprint linenums"> <project> <modelVersion>4.0.0</modelVersion> <groupId>org.apache.maven</groupId> @@ -211,45 +194,34 @@ under the License. <pluginRepositories></pluginRepositories> --> </project> - -</code></pre></div></section><section> -<h3>PGP Signature</h3> +</pre></div></section><section> +<h2>PGP Signature</h2> <p>When people download artifacts from the Central Repository, they might want to verify these artifacts' PGP signatures against a public key server. If there are no signatures, then users have no guarantee that they are downloading the original artifact.</p> -<p>To improve the quality of the Central Repository, we require you to provide PGP signatures for all your artifacts (all files except checksums), and distribute your public key to a key server like <a href="http://pgp.mit.edu"; class="externalLink">http://pgp.mit.edu</a>. Read <a href="http://central.sonatype.org/pages/working-with-pgp-signatures.html"; class="externalLink">Working with PGP Signatures</a> for more information.</p></section><section> -<h3>FAQ and common mistakes</h3> +<p>To improve the quality of the Central Repository, we require you to provide PGP signatures for all your artifacts (all files except checksums), and distribute your public key to a key server like <a class="externalLink" href="http://pgp.mit.edu";>http://pgp.mit.edu</a>. Read <a class="externalLink" href="http://central.sonatype.org/pages/working-with-pgp-signatures.html";>Working with PGP Signatures</a> for more information.</p></section><section> +<h2>FAQ and common mistakes</h2> <ul> - -<li> -<p>I have other <code>repositories</code> or <code>pluginRepositories</code> listed in my POM, is that a problem?</p> +<li>I have other <code>repositories</code> or <code>pluginRepositories</code> listed in my POM, is that a problem? <p>At present, this won't preclude your project from being included, but we do strongly encourage making sure all your dependencies are included in the Central Repository. If you rely on sketchy repositories that have junk in them or disappear, it just creates havok for downstream users. Try to keep your dependencies among reliable repos like Central, Jboss, etc.</p></li> -<li> -<p>What about artifacts that can't be distributed because of their license?</p> -<p>In that case only the POM for that dependency is required, listing where the dependency can be downloaded from. <a href="https://repo.maven.apache.org/maven2/javax/activation/activation/1.0.2/activation-1.0.2.pom"; class="externalLink">See an example</a>.</p></li> -<li> -<p>I have a patched version of the foo project developed at foo.com, what <code>groupId</code> should I use?</p> +<li>What about artifacts that can't be distributed because of their license? +<p>In that case only the POM for that dependency is required, listing where the dependency can be downloaded from. <a class="externalLink" href="https://repo.maven.apache.org/maven2/javax/activation/activation/1.0.2/activation-1.0.2.pom";>See an example</a>.</p></li> +<li>I have a patched version of the foo project developed at foo.com, what <code>groupId</code> should I use? <p>When you patch / modify a third party project, that patched version becomes your project and therefore should be distributed under a <code>groupId</code> you control as any project you would have developed, never under <code>com.foo</code>. See above considerations about <code>groupId</code>.</p></li> -<li> -<p>My project is hosted at a project hosting service like SourceForge or Github, what should I use as groupId?</p> -<p>If your project name is <code>foo</code> at SourceForge, you can use <code>net.sf.foo</code>. If your username is <code>bar</code> on Github, you can use <code>com.github.bar</code>. You can also use another reversed domain name you control. The group ID does not have to reflect the project host.</p></li> -</ul></section></section><section> -<h2>Publishing your artifacts to the Central Repository</h2><section> -<h3>Approved Repository Hosting</h3> +<li>My project is hosted at a project hosting service like SourceForge or Github, what should I use as groupId? +<p>If your project name is <code>foo</code> at SourceForge, you can use <code>net.sf.foo</code>. If your username is <code>bar</code> on Github, you can use <code>com.github.bar</code>. You can also use another reversed domain name you control. The group ID does not have to reflect the project host.</p></li></ul></section></section><section> +<h1>Publishing your artifacts to the Central Repository</h1><section> +<h2>Approved Repository Hosting</h2> <p>Instead of maintaining repository rsync feeds for each projects, we now encourage projects to use an approved repository hosting location.</p> <p>Currently approved repository hosting locations:</p> <ul> - -<li> -<p><a href="https://repository.apache.org/"; class="externalLink">Apache Software Foundation</a> (for all Apache projects)</p></li> -<li> -<p>see <a href="https://central.sonatype.org/publish/large-orgs/"; class="externalLink">the full list</a></p></li> -</ul> -<p>Automatic publication will be provided for Forges that provide hosting services for OSS projects and other large project repositories that meet certain minimum criteria such as validation of PGP keys and pom contents as defined above. If you are interested in becoming an approved Forge, <a href="https://central.sonatype.org/publish/large-orgs/"; class="externalLink">contact us</a>.</p></section><section> -<h3>Other Projects</h3> -<p>The easiest way to upload another project is to use the <a href="https://central.sonatype.org/pages/ossrh-guide.html"; class="externalLink">Open Source Software Repository Hosting (OSSRH)</a>, which is an approved repository provided by Sonatype for <em>any</em> OSS Project that wants to get its artifacts into the Central Repository.</p></section><section> -<h3>Explanations</h3> +<li><a class="externalLink" href="https://repository.apache.org/";>Apache Software Foundation</a> (for all Apache projects)</li> +<li>see <a class="externalLink" href="https://central.sonatype.org/publish/large-orgs/";>the full list</a></li></ul> +<p>Automatic publication will be provided for Forges that provide hosting services for OSS projects and other large project repositories that meet certain minimum criteria such as validation of PGP keys and pom contents as defined above. If you are interested in becoming an approved Forge, <a class="externalLink" href="https://central.sonatype.org/publish/large-orgs/";>contact us</a>.</p></section><section> +<h2>Other Projects</h2> +<p>The easiest way to upload another project is to use the <a class="externalLink" href="https://central.sonatype.org/pages/ossrh-guide.html";>Open Source Software Repository Hosting (OSSRH)</a>, which is an approved repository provided by Sonatype for <i>any</i> OSS Project that wants to get its artifacts into the Central Repository.</p></section><section> +<h2>Explanations</h2> <p>Having each project maintain its own repository with rsync to the Central Repository was the preferred process until January 2010. However, we are no longer accepting rsync requests on a per project basis.</p> -<p>Over time, we have learned that this process is not scalable. Many of the projects being synced release very infrequently, yet we have to hit hundreds of servers several times a day looking for artifacts that don't change. Additionally, there is no good mechanism currently for validating the incoming data via the rsync, and this leads to bad metadata that affects everyone.</p> -<p>The aggregation of projects into larger feeds allows us to sync faster and more often, and ensuring these locations perform sufficient checks increases the quality of metadata for everyone.</p></section></section></section> +<p>Over time, we have learned that this process is not scalable. Many of the projects being synced release very infrequently, yet we have to hit hundreds of servers several times a day looking for artifacts that don't change. Additionally, there is no good mechanism currently for validating the incoming data via the rsync, and this leads to bad metadata that affects everyone. </p> +<p>The aggregation of projects into larger feeds allows us to sync faster and more often, and ensuring these locations perform sufficient checks increases the quality of metadata for everyone.</p></section></section> </main> </div> </div> Modified: maven/website/content/run-maven/index.html ============================================================================== --- maven/website/content/run-maven/index.html (original) +++ maven/website/content/run-maven/index.html Sat Feb 18 20:40:58 2023 @@ -2,7 +2,7 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/markdown/run-maven/index.md at 2023-02-18 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/apt/run-maven/index.apt at 2023-02-18 | Rendered using Apache Maven Fluido Skin 1.11.1 --> <html xmlns="http://www.w3.org/1999/xhtml"; lang=""> @@ -48,7 +48,7 @@ <ul class="breadcrumb"> <li class=""><a href="https://www.apache.org/"; class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li class=""><a href="../index.html" title="Maven">Maven</a><span class="divider">/</span></li> - <li class="active ">Running Maven <a href="https://github.com/apache/maven-site/tree/master/content/markdown/run-maven/index.md";><img src="../images/accessories-text-editor.png" title="Edit" /></a></li> + <li class="active ">Running Maven <a href="https://github.com/apache/maven-site/tree/master/content/apt/run-maven/index.apt";><img src="../images/accessories-text-editor.png" title="Edit" /></a></li> <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-18</li> <li class="pull-right"><span class="divider">|</span> <a href="../scm.html" title="Get Sources">Get Sources</a></li> @@ -137,42 +137,23 @@ </div> </header> <main id="bodyColumn" class="span10" > -<!-- -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. ---> -<section><section> -<h2>Building a Project with Maven</h2> +<section> +<h1>Building a Project with Maven</h1> <p>The vast majority of Maven-built projects can be built with the following command:</p> - -<div class="source"><pre class="prettyprint linenums"><code>mvn verify -</code></pre></div> +<div> +<pre>mvn verify</pre></div> <p>This command tells Maven to build all the modules, and to check if all integration tests succeeded (when any was defined)</p> <p>That's it! If you look in the <code>target</code> subdirectory, you should find the build output and the final library or application that was being built.</p> -<p><strong>Note:</strong> Some projects have multiple modules, so the library or application you are looking for may be in a module subdirectory.</p> +<p><b>Note:</b> Some projects have multiple modules, so the library or application you are looking for may be in a module subdirectory.</p> <p>While this will build most projects and Maven encourages this standard convention, builds can be customisable. If this does not suffice, please consult the project's documentation.</p><section> -<h3>More than just the Build</h3> +<h2>More than just the Build</h2> <p>Maven can do more than just build software - it can assist with testing, run web applications and produce reports on projects, as well as any number of other tasks provided by plug-ins.</p></section><section> -<h3>When Things go Wrong</h3> +<h2>When Things go Wrong</h2> <p>The following are some common problems when building with Maven, and how to resolve them.</p><section> -<h4>Missing Dependencies</h4> +<h3>Missing Dependencies</h3> <p>A missing dependency presents with an error like the following:</p> - -<div class="source"><pre class="prettyprint linenums"><code>[INFO] Failed to resolve artifact. +<div> +<pre>[INFO] Failed to resolve artifact. Missing: ---------- @@ -195,13 +176,12 @@ for artifact: org.apache.maven:maven:pom:2.1-SNAPSHOT from the specified remote repositories: - central (https://repo.maven.apache.org/maven2) -</code></pre></div> -<p>To resolve this issue, it depends on what the dependency is and why it is missing. The most common cause is because it can not be redistributed from the repository and must be manually installed using the instructions given in the message. This is most common with some older JARs from Sun (usually <code>javax.\*</code> group IDs), and is further documented in the <a href="../guides/mini/guide-coping-with-sun-jars.html">Guide to Coping with Sun JARs</a>.</p> + central (https://repo.maven.apache.org/maven2)</pre></div> +<p>To resolve this issue, it depends on what the dependency is and why it is missing. The most common cause is because it can not be redistributed from the repository and must be manually installed using the instructions given in the message. This is most common with some older JARs from Sun (usually <code>javax.*</code> group IDs), and is further documented in the <a href="../guides/mini/guide-coping-with-sun-jars.html"> Guide to Coping with Sun JARs</a>.</p> <p>You can check the list of repositories at the end of the error to ensure that the expected ones are listed - it may be that the project requires an alternative repository that has not been declared properly or is not accessible with your Maven configuration.</p> <p>In other cases, it may be an incorrectly declared dependency (like the typo in the example above) which the project would need to fix, like a compilation error.</p></section><section> -<h4>Inconsistent output</h4> -<p>Most plugins are optimized to know if they have to execute their task. In some cases, the output can be polluted from a previous build and the end result is not what you expected. In such rare situations, you can call the <code>clean</code> phase which means: remove the output directory. You can also call it as <code>mvn clean verify</code> which means: first clean up the output directory, next build the project and verify the outcome.</p></section></section></section></section> +<h3>Inconsistent output</h3> +<p>Most plugins are optimized to know if they have to execute their task. In some cases, the output can be polluted from a previous build and the end result is not what you expected. In such rare situations, you can call the <code>clean</code> phase which means: remove the output directory. You can also call it as <code>mvn clean verify</code> which means: first clean up the output directory, next build the project and verify the outcome.</p></section></section></section> </main> </div> </div> Modified: maven/website/content/security-plexus-archiver.html ============================================================================== --- maven/website/content/security-plexus-archiver.html (original) +++ maven/website/content/security-plexus-archiver.html Sat Feb 18 20:40:58 2023 @@ -147,7 +147,7 @@ an arbitrary file write generic vulnerab specially crafted zip (or bzip2, gzip, tar, xz, war) archive, that holds path traversal filenames. So when the filename gets concatenated to the target extraction directory, if the extraction tool used does not make -sufficient checks, the final path ends up outside of the target directory.</p> +sufficient checks, the final path ends up outside of the target folder.</p> <p>The Apache Maven team has been informed because the plexus-archiver library did not make sufficient checks and it is a library used by most of the packaging plugins. @@ -200,7 +200,7 @@ which versions contain the fixed and the <td>maven-ear-plugin</td> -<td>(,3.0.0]</td> +<td>(,3.0.0]</td> <td>3.0.1</td> @@ -276,7 +276,7 @@ which versions contain the fixed and the <td></td> <td><a href="https://issues.apache.org/jira/browse/MANTRUN-214"; class="externalLink">MANTRUN-214</a></td> - + <td></td> </tr> @@ -289,7 +289,7 @@ which versions contain the fixed and the <td></td> <td><a href="https://issues.apache.org/jira/browse/MPLUGIN-340"; class="externalLink">MPLUGIN-340</a></td> - + <td><a href="/plugin-tools/maven-plugin-plugin/examples/ant-mojo.html">Ant Mojo Wrapper</a></td> </tr> </table> Modified: maven/website/content/security.html ============================================================================== --- maven/website/content/security.html (original) +++ maven/website/content/security.html Sat Feb 18 20:40:58 2023 @@ -190,7 +190,7 @@ an arbitrary file write generic vulnerab specially crafted zip (or bzip2, gzip, tar, xz, war) archive, that holds path traversal filenames. So when the filename gets concatenated to the target extraction directory, if the extraction tool used does not make -sufficient checks, the final path ends up outside of the target directory. +sufficient checks, the final path ends up outside of the target folder. The affected plugins use plexus-archiver to unpack dependencies to disk and have been identified as potential triggers for exposing the vulnerability if dependencies are compromised.</p> Modified: maven/website/content/settings.html ============================================================================== --- maven/website/content/settings.html (original) +++ maven/website/content/settings.html Sat Feb 18 20:40:58 2023 @@ -158,39 +158,39 @@ under the License. <ol style="list-style-type: decimal"> <li> -<p><a href="#introduction">Introduction</a></p> +<p><a href="#Introduction">Introduction</a></p> <ol style="list-style-type: decimal"> -<li><a href="#quick-overview">Quick Overview</a></li> +<li><a href="#Quick_Overview">Quick Overview</a></li> </ol></li> <li> -<p><a href="#dettings-details">Settings Details</a></p> +<p><a href="#Settings_Details">Settings Details</a></p> <ol style="list-style-type: decimal"> <li> -<p><a href="#simple-values">Simple Values</a></p></li> +<p><a href="#Simple_Values">Simple Values</a></p></li> <li> -<p><a href="#plugin-groups">Plugin Groups</a></p></li> +<p><a href="#Plugin_Groups">Plugin Groups</a></p></li> <li> -<p><a href="#servers">Servers</a></p> +<p><a href="#Servers">Servers</a></p> <ol style="list-style-type: decimal"> -<li><a href="#password-encryption">Password Encryption</a></li> +<li><a href="#Password_Encryption">Password Encryption</a></li> </ol></li> <li> -<p><a href="#mirrors">Mirrors</a></p></li> +<p><a href="#Mirrors">Mirrors</a></p></li> <li> -<p><a href="#proxies">Proxies</a></p></li> +<p><a href="#Proxies">Proxies</a></p></li> <li> -<p><a href="#profiles">Profiles</a></p> +<p><a href="#Profiles">Profiles</a></p> <ol style="list-style-type: decimal"> -<li><a href="#activation">Activation</a></li> -<li><a href="#repositories">Repositories</a></li> -<li><a href="#plugin-repositories">Plugin Repositories</a></li> +<li><a href="#Activation">Activation</a></li> +<li><a href="#Repositories">Repositories</a></li> +<li><a href="#Plugin_Repositories">Plugin Repositories</a></li> </ol></li> <li> -<p><a href="#active-profiles">Active Profiles</a></p></li> +<p><a href="#Active_Profiles">Active Profiles</a></p></li> </ol></li> </ol></section><section> <h2>Introduction</h2><section> @@ -246,13 +246,13 @@ cannot be used for interpolation.</p></s representing a range of values which describe elements of the build system that are active full-time.</p> -<div class="source"><pre class="prettyprint linenums"><code class="language-xml"> <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" - xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 https://maven.apache.org/xsd/settings-1.0.0.xsd"> - <localRepository>${user.home}/.m2/repository</localRepository> - <interactiveMode>true</interactiveMode> - <offline>false</offline> - ... - </settings> +<div class="source"><pre class="prettyprint linenums"><code><settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 https://maven.apache.org/xsd/settings-1.0.0.xsd"> + <localRepository>${user.home}/.m2/repository</localRepository> + <interactiveMode>true</interactiveMode> + <offline>false</offline> + ... +</settings> </code></pre></div> <ul> @@ -359,7 +359,7 @@ page</a></p></section></section><section <li><strong>id</strong>, <strong>name</strong>: The unique identifier and user-friendly name of this mirror. The <code>id</code> is used to differentiate between <code>mirror</code> elements and to pick the corresponding credentials from the -<a href="#servers"><code><servers></code></a> section when connecting to the mirror.</li> +<a href="#Servers"><code><servers></code></a> section when connecting to the mirror.</li> <li><strong>url</strong>: The base URL of this mirror. The build system will use this URL to connect to a repository rather than the original repository URL.</li> @@ -505,7 +505,7 @@ contain the corresponding element's valu <li>Java System Properties: All properties accessible via <code>java.lang.System.getProperties()</code> are available as POM properties, such as <code>${java.home}</code>.</li> -<li><code>x</code>: Set within a <code><properties\></code> element or an external files, the +<li><code>x</code>: Set within a <properties /> element or an external files, the value may be used as <code>${someVar}</code>.</li> </ol><!-- -->
