Modified: websites/staging/maven/trunk/content/plugin-developers/cookbook/generate-assembly.html ============================================================================== --- websites/staging/maven/trunk/content/plugin-developers/cookbook/generate-assembly.html (original) +++ websites/staging/maven/trunk/content/plugin-developers/cookbook/generate-assembly.html Fri Jul 11 05:10:35 2014 @@ -1,11 +1,11 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <!-- - | Generated by Apache Maven Doxia at 2014-07-01 + | Generated by Apache Maven Doxia at 2014-07-11 | Rendered using Apache Maven Stylus Skin 1.5 --> <html xmlns="http://www.w3.org/1999/xhtml"> <head> - <title>Maven - Cookbook - How To Generate Assembly</title> + <title>Maven – Cookbook - How To Generate Assembly</title> <style type="text/css" media="all"> @import url("../../css/maven-base.css"); @import url("../../css/maven-theme.css"); @@ -13,7 +13,7 @@ </style> <link rel="stylesheet" href="../../css/print.css" type="text/css" media="print" /> <meta name="author" content="Vincent Siveton" /> - <meta name="Date-Revision-yyyymmdd" content="20140701" /> + <meta name="Date-Revision-yyyymmdd" content="20140711" /> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script> @@ -43,7 +43,7 @@ Cookbook - How To Generate Assembly </div> <div class="xright"> - Last Published: 2014-07-01 + Last Published: 2014-07-11 </div> <div class="clear"> <hr/> @@ -241,12 +241,12 @@ <div id="bodyColumn"> <div id="contentBox"> <div class="section"> -<h2>Cookbook: How To Generate Assembly?<a name="Cookbook:_How_To_Generate_Assembly"></a></h2> +<h2><a name="Cookbook:_How_To_Generate_Assembly"></a>Cookbook: How To Generate Assembly?</h2> <div class="section"> -<h3>Summary<a name="Summary"></a></h3> +<h3><a name="Summary"></a>Summary</h3> <p>This recipe describes how to generate assembly like zip, tar.gz or tar.bz2.</p></div> <div class="section"> -<h3>Prerequisite Plugins<a name="Prerequisite_Plugins"></a></h3> +<h3><a name="Prerequisite_Plugins"></a>Prerequisite Plugins</h3> <p>Here is the list of the plugins used:</p> <table border="1" class="bodyTable"> <tr class="a"> @@ -256,7 +256,7 @@ <td align="left"><a href="../../plugins/maven-assembly-plugin/"> <tt>assembly</tt></a></td> <td align="left">2.2-beta-1</td></tr></table></div> <div class="section"> -<h3>Sample Generated Output<a name="Sample_Generated_Output"></a></h3> +<h3><a name="Sample_Generated_Output"></a>Sample Generated Output</h3> <div class="source"> <pre> attach-source-javadoc @@ -269,9 +269,9 @@ attach-source-javadoc `-- apache-maven-cookbook-1.0-SNAPSHOT-bin.zip </pre></div></div> <div class="section"> -<h3>Recipe<a name="Recipe"></a></h3> +<h3><a name="Recipe"></a>Recipe</h3> <div class="section"> -<h4>Configuring Assembly Descriptor<a name="Configuring_Assembly_Descriptor"></a></h4> +<h4><a name="Configuring_Assembly_Descriptor"></a>Configuring Assembly Descriptor</h4> <p>To generate an assembly, we need to configure an assembly descriptor called <tt>bin.xml</tt> in the <tt>src/assembly</tt> directory. Firstly, we specify the wanted formats, i.e.</p> <div class="source"> <pre><formats> @@ -315,7 +315,7 @@ attach-source-javadoc </fileSets> </pre></div></div> <div class="section"> -<h4>Configuring Maven Assembly Plugin<a name="Configuring_Maven_Assembly_Plugin"></a></h4> +<h4><a name="Configuring_Maven_Assembly_Plugin"></a>Configuring Maven Assembly Plugin</h4> <p>We execute the <tt><a href="../../plugins/maven-assembly-plugin/single-mojo.html">assembly:single</a></tt> goal from the Assembly plugin during the <tt>package</tt> phase.</p> <div class="source"> <pre><plugin> @@ -336,12 +336,12 @@ attach-source-javadoc </plugin> </pre></div></div> <div class="section"> -<h4>Running Maven<a name="Running_Maven"></a></h4> +<h4><a name="Running_Maven"></a>Running Maven</h4> <p>Just call Maven to generate the packages:</p> <div class="source"> <pre>mvn package</pre></div></div></div> <div class="section"> -<h3>Resources<a name="Resources"></a></h3> +<h3><a name="Resources"></a>Resources</h3> <ul> <li>Source code: <a class="externalLink" href="http://svn.apache.org/repos/asf/maven/sandbox/trunk/site/cookbook/generate-assembly">http://svn.apache.org/repos/asf/maven/sandbox/trunk/site/cookbook/generate-assembly</a></li> <li><a href="../../plugins/maven-assembly-plugin/">Maven Assembly Plugin </a></li></ul></div></div>
Modified: websites/staging/maven/trunk/content/plugin-developers/cookbook/index.html ============================================================================== --- websites/staging/maven/trunk/content/plugin-developers/cookbook/index.html (original) +++ websites/staging/maven/trunk/content/plugin-developers/cookbook/index.html Fri Jul 11 05:10:35 2014 @@ -1,11 +1,11 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <!-- - | Generated by Apache Maven Doxia at 2014-07-01 + | Generated by Apache Maven Doxia at 2014-07-11 | Rendered using Apache Maven Stylus Skin 1.5 --> <html xmlns="http://www.w3.org/1999/xhtml"> <head> - <title>Maven - Plugins Cookbook</title> + <title>Maven – Plugins Cookbook</title> <style type="text/css" media="all"> @import url("../../css/maven-base.css"); @import url("../../css/maven-theme.css"); @@ -15,7 +15,7 @@ <meta name="author" content="Brett Porter Vincent Siveton" /> <meta name="Date-Creation-yyyymmdd" content="20090802" /> - <meta name="Date-Revision-yyyymmdd" content="20140701" /> + <meta name="Date-Revision-yyyymmdd" content="20140711" /> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script> @@ -45,7 +45,7 @@ Vincent Siveton" /> Plugins Cookbook </div> <div class="xright"> - Last Published: 2014-07-01 + Last Published: 2014-07-11 </div> <div class="clear"> <hr/> @@ -243,11 +243,11 @@ Vincent Siveton" /> <div id="bodyColumn"> <div id="contentBox"> <!-- 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. --><!-- NOTE: For help with the syntax of this file, see: --><!-- http://maven.apache.org/doxia/references/apt- format.html --><div class="section"> -<h2>Maven Plugins Cookbook<a name="Maven_Plugins_Cookbook"></a></h2> +<h2><a name="Maven_Plugins_Cookbook"></a>Maven Plugins Cookbook</h2> <p>A set of small complete working examples projects that demonstrate how to use Maven Plugins. It is based on commons how-to questions from the <a href="../../mail-lists.html">Maven User Mailing List</a>.</p> <p><i>(Like to add more cookbooks? See <a href="../../guides/development/guide-helping.html"> How to Contribute</a> page)</i></p> <div class="section"> -<h3>How To/Recipes<a name="How_ToRecipes"></a></h3> +<h3><a name="How_ToRecipes"></a>How To/Recipes</h3> <ul> <li><a href="./add-build-time-to-manifest.html">How to add build time to a JAR manifest?</a></li> <li><a href="./add-svn-revision-to-manifest.html">How to add SVN revision to a JAR manifest?</a></li> @@ -255,7 +255,7 @@ Vincent Siveton" /> <li><a href="./generate-assembly.html">How to generate assembly?</a></li> <li><a href="./plexus-plugin-upgrade.html">How to upgrade from Plexus javadoc tags to Plexus Java annotations?</a></li></ul></div> <div class="section"> -<h3>Other Resources<a name="Other_Resources"></a></h3> +<h3><a name="Other_Resources"></a>Other Resources</h3> <ul> <li><a class="externalLink" href="http://docs.codehaus.org/display/MAVENUSER/Mojo+Developer+Cookbook">Mojo Developer Cookbook</a></li></ul></div></div> </div> Modified: websites/staging/maven/trunk/content/plugin-developers/cookbook/plexus-plugin-upgrade.html ============================================================================== --- websites/staging/maven/trunk/content/plugin-developers/cookbook/plexus-plugin-upgrade.html (original) +++ websites/staging/maven/trunk/content/plugin-developers/cookbook/plexus-plugin-upgrade.html Fri Jul 11 05:10:35 2014 @@ -1,11 +1,11 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <!-- - | Generated by Apache Maven Doxia at 2014-07-01 + | Generated by Apache Maven Doxia at 2014-07-11 | Rendered using Apache Maven Stylus Skin 1.5 --> <html xmlns="http://www.w3.org/1999/xhtml"> <head> - <title>Maven - Cookbook - How To Upgrade from Plexus Javadoc Tags to Plexus Java Annotations</title> + <title>Maven – Cookbook - How To Upgrade from Plexus Javadoc Tags to Plexus Java Annotations</title> <style type="text/css" media="all"> @import url("../../css/maven-base.css"); @import url("../../css/maven-theme.css"); @@ -14,7 +14,7 @@ <link rel="stylesheet" href="../../css/print.css" type="text/css" media="print" /> <meta name="author" content="Hervé Boutemy" /> <meta name="Date-Creation-yyyymmdd" content="20120602" /> - <meta name="Date-Revision-yyyymmdd" content="20140701" /> + <meta name="Date-Revision-yyyymmdd" content="20140711" /> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script> @@ -44,7 +44,7 @@ Cookbook - How To Upgrade from Plexus Javadoc Tags to Plexus Java Annotations </div> <div class="xright"> - Last Published: 2014-07-01 + Last Published: 2014-07-11 </div> <div class="clear"> <hr/> @@ -242,15 +242,15 @@ <div id="bodyColumn"> <div id="contentBox"> <div class="section"> -<h2>Cookbook: How To Upgrade from Plexus Javadoc Tags to Plexus Java Annotations?<a name="Cookbook:_How_To_Upgrade_from_Plexus_Javadoc_Tags_to_Plexus_Java_Annotations"></a></h2> +<h2><a name="Cookbook:_How_To_Upgrade_from_Plexus_Javadoc_Tags_to_Plexus_Java_Annotations"></a>Cookbook: How To Upgrade from Plexus Javadoc Tags to Plexus Java Annotations?</h2> <div class="section"> -<h3>Summary<a name="Summary"></a></h3> +<h3><a name="Summary"></a>Summary</h3> <p>This recipe describes how to upgrade from Plexus Javadoc Tags to Plexus Java Annotations, in 2 steps:</p> <ol style="list-style-type: decimal"> <li>replace the deprecated <a class="externalLink" href="http://plexus.codehaus.org/plexus-maven-plugin/"><tt>plexus-maven-plugin</tt></a>, which only supports Plexus Javadoc Tags, with its successor: <a class="externalLink" href="http://plexus.codehaus.org/plexus-containers/plexus-component-metadata/"><tt>plexus-component-metadata</tt></a>, which support both Plexus Javadoc Tags and Plexus Java Annotations,</li> <li>update sources with <a class="externalLink" href="http://plexus.codehaus.org/plexus-containers/plexus-component-annotations/">Java Annotations for Plexus</a>.</li></ol></div> <div class="section"> -<h3>Prerequisite Plugins<a name="Prerequisite_Plugins"></a></h3> +<h3><a name="Prerequisite_Plugins"></a>Prerequisite Plugins</h3> <p>Here is the list of the plugins used:</p> <table border="1" class="bodyTable"> <tr class="a"> @@ -263,7 +263,7 @@ <td align="left"><a class="externalLink" href="http://plexus.codehaus.org/plexus-containers/plexus-component-metadata/"><tt>plexus-component-metadata</tt></a></td> <td align="left">1.5.5</td></tr></table></div> <div class="section"> -<h3>Equivalence Table<a name="Equivalence_Table"></a></h3> +<h3><a name="Equivalence_Table"></a>Equivalence Table</h3> <table border="1" class="bodyTable"> <tr class="a"> <td align="center"></td> @@ -302,9 +302,9 @@ <td align="left">javadoc tags:  <br /><tt>@plexus.component</tt>, <tt>@plexus.requirement</tt>, <tt>@plexus.configuration</tt>  </td> <td align="left">javadoc tags + <a class="externalLink" href="http://plexus.codehaus.org/plexus-containers/plexus-component-annotations/"><tt>plexus-component-annotations</tt></a> Java 5 annotations: <br /><a class="externalLink" href="http://plexus.codehaus.org/plexus-containers/plexus-component-annotations/apidocs/org/codehaus/plexus/component/annotations/Component.html"><tt>@Component</tt></a>, <a class="externalLink" href="http://plexus.codehaus.org/plexus-containers/plexus-component-annotations/apidocs/org/codehaus/plexus/component/annotations/Requirement.html"><tt>@Requirement</tt></a>, <a class="externalLink" href="http://plexus.codehaus.org/plexus-containers/plexus-component-annotations/apidocs/org/codehaus/plexus/component/annotations/Configuration.html"><tt>@Configuration</tt></a>,</td></tr></table></div> <div class="section"> -<h3>Recipe<a name="Recipe"></a></h3> +<h3><a name="Recipe"></a>Recipe</h3> <div class="section"> -<h4>Plugin Configuration<a name="Plugin_Configuration"></a></h4> +<h4><a name="Plugin_Configuration"></a>Plugin Configuration</h4> <p>In your <tt>pom.xml</tt>, replace <tt>plexus-maven-plugin</tt> configuration:</p> <div class="source"> <pre><project> @@ -345,7 +345,7 @@ </project></pre></div> <p>If <tt>merge-descriptors</tt> is used, move the handwritten xml file to <tt>${basedir}/src/main/resources/META-INF/plexus</tt>.</p></div> <div class="section"> -<h4>Replacing Plexus Javadoc Tags with Plexus Java 5 Annotations<a name="Replacing_Plexus_Javadoc_Tags_with_Plexus_Java_5_Annotations"></a></h4> +<h4><a name="Replacing_Plexus_Javadoc_Tags_with_Plexus_Java_5_Annotations"></a>Replacing Plexus Javadoc Tags with Plexus Java 5 Annotations</h4> <p>In your <tt>pom.xml</tt>, add <tt>plexus-component-annotations</tt> dependency:</p> <div class="source"> <pre><project> Modified: websites/staging/maven/trunk/content/plugin-developers/index.html ============================================================================== --- websites/staging/maven/trunk/content/plugin-developers/index.html (original) +++ websites/staging/maven/trunk/content/plugin-developers/index.html Fri Jul 11 05:10:35 2014 @@ -1,11 +1,11 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <!-- - | Generated by Apache Maven Doxia at 2014-07-01 + | Generated by Apache Maven Doxia at 2014-07-11 | Rendered using Apache Maven Stylus Skin 1.5 --> <html xmlns="http://www.w3.org/1999/xhtml"> <head> - <title>Maven - Plugin Developers Centre</title> + <title>Maven – Plugin Developers Centre</title> <style type="text/css" media="all"> @import url("../css/maven-base.css"); @import url("../css/maven-theme.css"); @@ -13,7 +13,7 @@ </style> <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> <meta name="author" content="Brett Porter" /> - <meta name="Date-Revision-yyyymmdd" content="20140701" /> + <meta name="Date-Revision-yyyymmdd" content="20140711" /> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script> @@ -43,7 +43,7 @@ Plugin Developers Centre </div> <div class="xright"> - Last Published: 2014-07-01 + Last Published: 2014-07-11 </div> <div class="clear"> <hr/> @@ -252,7 +252,7 @@ <div id="bodyColumn"> <div id="contentBox"> <div class="section"> -<h2>Plugin Developers Centre<a name="Plugin_Developers_Centre"></a></h2> +<h2><a name="Plugin_Developers_Centre"></a>Plugin Developers Centre</h2> <p>This documentation centre is for those that are developing Maven plugins. This might be for your own build, or as an accompaniment to your third party tool.</p><!-- TODO: callout --> <p><b>What is a Mojo?</b> A mojo is a <b>M</b>aven plain <b>O</b>ld <b>J</b>ava <b>O</b>bject. Each mojo is an executable <i>goal</i> in Maven, and a plugin is a distribution of one or more related mojos.</p><!-- TODO: tasks as buttons? --> <ul> @@ -262,13 +262,13 @@ <li><a href="./cookbook/index.html"> Plugins Cookbook</a> - Examples for how to perform common tasks in plugins</li> <li><a href="./common-bugs.html"> Common Bugs and Pitfalls</a> - Overview of problematic coding patterns</li></ul><!-- TODO: trails --> <div class="section"> -<h3>Reference<a name="Reference"></a></h3> +<h3><a name="Reference"></a>Reference</h3> <ul> <li><a href="../developers/mojo-api-specification.html"> Mojo API and Annotation Reference</a></li> <li><a href="../ref/current/index.html"> Maven API Reference</a></li> <li><a href="../guides/mini/guide-maven-classloading.html"> Maven Class Loading</a></li></ul></div> <div class="section"> -<h3>Examples<a name="Examples"></a></h3> +<h3><a name="Examples"></a>Examples</h3> <ul> <li><a href="../examples/injecting-properties-via-settings.html">Injecting POM Properties via settings.xml</a></li> <li><a href="../examples/maven-3-lifecycle-extensions.html">Maven 3 lifecycle extensions</a></li></ul></div></div> Modified: websites/staging/maven/trunk/content/plugin-developers/plugin-documenting.html ============================================================================== --- websites/staging/maven/trunk/content/plugin-developers/plugin-documenting.html (original) +++ websites/staging/maven/trunk/content/plugin-developers/plugin-documenting.html Fri Jul 11 05:10:35 2014 @@ -1,11 +1,11 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <!-- - | Generated by Apache Maven Doxia at 2014-07-01 + | Generated by Apache Maven Doxia at 2014-07-11 | Rendered using Apache Maven Stylus Skin 1.5 --> <html xmlns="http://www.w3.org/1999/xhtml"> <head> - <title>Maven - Developers centre - Documentation Plugins Strategies</title> + <title>Maven – Developers centre - Documentation Plugins Strategies</title> <style type="text/css" media="all"> @import url("../css/maven-base.css"); @import url("../css/maven-theme.css"); @@ -13,7 +13,7 @@ </style> <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> <meta name="author" content="Vincent Siveton" /> - <meta name="Date-Revision-yyyymmdd" content="20140701" /> + <meta name="Date-Revision-yyyymmdd" content="20140711" /> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script> @@ -43,7 +43,7 @@ Developers centre - Documentation Plugins Strategies </div> <div class="xright"> - Last Published: 2014-07-01 + Last Published: 2014-07-11 </div> <div class="clear"> <hr/> @@ -241,16 +241,16 @@ <div id="bodyColumn"> <div id="contentBox"> <!-- 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. --><!-- NOTE: For help with the syntax of this file, see: --><!-- http://maven.apache.org/doxia/references/apt- format.html --><div class="section"> -<h2>Introduction<a name="Introduction"></a></h2> +<h2><a name="Introduction"></a>Introduction</h2> <p>A <a href="../guides/development/guide-plugin-documentation.html">Guide to the Plugin Documentation Standard</a> was created. This document is intended to verify it during the Plugins development.</p></div> <div class="section"> -<h2>Verify Plugin Documentation<a name="Verify_Plugin_Documentation"></a></h2> +<h2><a name="Verify_Plugin_Documentation"></a>Verify Plugin Documentation</h2> <p>The <a href="../plugins/maven-docck-plugin">maven-docck-plugin</a> checks that a project complies with the Plugin Documentation Standard.</p> <p>You <b>should</b> verify that all Plugin documentation respects this standard. The maven-docck-plugin can be run:</p> <div class="source"> <pre>mvn docck:check</pre></div></div> <div class="section"> -<h2>References<a name="References"></a></h2> +<h2><a name="References"></a>References</h2> <ul> <li><a class="externalLink" href="http://cwiki.apache.org/confluence/display/MAVENOLD/Maven+Plugin+Documentation">Maven Plugin Documentation</a></li></ul></div> </div> Modified: websites/staging/maven/trunk/content/plugin-developers/plugin-testing.html ============================================================================== --- websites/staging/maven/trunk/content/plugin-developers/plugin-testing.html (original) +++ websites/staging/maven/trunk/content/plugin-developers/plugin-testing.html Fri Jul 11 05:10:35 2014 @@ -1,11 +1,11 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <!-- - | Generated by Apache Maven Doxia at 2014-07-01 + | Generated by Apache Maven Doxia at 2014-07-11 | Rendered using Apache Maven Stylus Skin 1.5 --> <html xmlns="http://www.w3.org/1999/xhtml"> <head> - <title>Maven - Developers centre - Testing Plugins Strategies</title> + <title>Maven – Developers centre - Testing Plugins Strategies</title> <style type="text/css" media="all"> @import url("../css/maven-base.css"); @import url("../css/maven-theme.css"); @@ -13,7 +13,7 @@ </style> <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> <meta name="author" content="Vincent Siveton" /> - <meta name="Date-Revision-yyyymmdd" content="20140701" /> + <meta name="Date-Revision-yyyymmdd" content="20140711" /> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script> @@ -43,7 +43,7 @@ Developers centre - Testing Plugins Strategies </div> <div class="xright"> - Last Published: 2014-07-01 + Last Published: 2014-07-11 </div> <div class="clear"> <hr/> @@ -241,27 +241,27 @@ <div id="bodyColumn"> <div id="contentBox"> <!-- 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. --><!-- NOTE: For help with the syntax of this file, see: --><!-- http://maven.apache.org/doxia/references/apt- format.html --><div class="section"> -<h2>Introduction<a name="Introduction"></a></h2> +<h2><a name="Introduction"></a>Introduction</h2> <p>Currently, Maven only supports unit testing out of the box. This document is intended to help Maven Developers to test Plugins with Unit Tests, Integration Tests or Functional tests.</p> <p><b>Note: There are a lot of different ways to test a Maven plugin.</b> For a review of different strategies and tools, please refer to <a class="externalLink" href="http://docs.codehaus.org/display/MAVENUSER/Review+of+Plugin+Testing+Strategies">Review of Plugin Testing Strategies</a></p></div> <div class="section"> -<h2>Testing Styles: Unit Testing vs. Functional/Integration Testing<a name="Testing_Styles:_Unit_Testing_vs._FunctionalIntegration_Testing"></a></h2> +<h2><a name="Testing_Styles:_Unit_Testing_vs._FunctionalIntegration_Testing"></a>Testing Styles: Unit Testing vs. Functional/Integration Testing</h2> <p>A unit test attempts to verify a mojo as an isolated unit, by mocking out the rest of the Maven environment. A mojo unit test does not attempt to run your plugin in the context of a real Maven build. Unit tests are designed to be fast.</p> <p>A functional/integration test attempts to use a mojo in a real Maven build, by launching a real instance of Maven in a real project. Normally this requires you to construct special dummy Maven projects with real POM files. Often this requires you to have already installed your plugin into your local repository so it can be used in a real Maven build. Functional tests run much more slowly than unit tests, but they can catch bugs that you may not catch with unit tests.</p> <p>The general wisdom is that your code should be mostly tested with unit tests, but should also have some functional tests.</p></div> <div class="section"> -<h2>Unit Tests<a name="Unit_Tests"></a></h2> +<h2><a name="Unit_Tests"></a>Unit Tests</h2> <div class="section"> -<h3>Using JUnit alone<a name="Using_JUnit_alone"></a></h3> +<h3><a name="Using_JUnit_alone"></a>Using JUnit alone</h3> <p>In principle, you can write a unit test of a plugin Mojo the same way you'd write any other JUnit test case, by writing a class that <tt>extends TestCase</tt>.</p> <p>However, most mojos need more information to work properly. For example, you'll probably need to inject a reference to a MavenProject, so your mojo can query project variables.</p></div> <div class="section"> -<h3>Using PlexusTestCase<a name="Using_PlexusTestCase"></a></h3> +<h3><a name="Using_PlexusTestCase"></a>Using PlexusTestCase</h3> <p>Mojo variables are injected using Plexus, and many Mojos are written to take specific advantage of the Plexus container (by executing a lifecycle or having various injected dependencies).</p> <p>If you all you need is Plexus container services, you can write your class with <tt>extends PlexusTestCase</tt> instead of TestCase.</p> <p>With that said, if you need to inject Maven objects into your mojo, you'll probably prefer to use the maven-plugin-testing-harness.</p></div> <div class="section"> -<h3>maven-plugin-testing-harness<a name="maven-plugin-testing-harness"></a></h3> +<h3><a name="maven-plugin-testing-harness"></a>maven-plugin-testing-harness</h3> <p>The <a href="/plugin-testing/maven-plugin-testing-harness/">maven-plugin-testing-harness</a> is explicitly intended to test the <tt>org.apache.maven.reporting.AbstractMavenReport#execute()</tt> implementation.</p> <p>In general, you need to include <tt>maven-plugin-testing-harness</tt> as dependency, and create a *MojoTest (by convention) class which <tt>extends AbstractMojoTestCase</tt>.</p> <div class="source"> @@ -305,9 +305,9 @@ }</pre></div> <p>For more information, please refer to <a class="externalLink" href="http://cwiki.apache.org/confluence/display/MAVENOLD/Maven+Plugin+Harness">Maven Plugin Harness Wiki</a></p></div></div> <div class="section"> -<h2>Integration/Functional testing<a name="IntegrationFunctional_testing"></a></h2> +<h2><a name="IntegrationFunctional_testing"></a>Integration/Functional testing</h2> <div class="section"> -<h3>maven-verifier<a name="maven-verifier"></a></h3> +<h3><a name="maven-verifier"></a>maven-verifier</h3> <p>maven-verifier tests are run using JUnit or TestNG, and provide a simple class allowing you to launch Maven and assert on its log file and built artifacts. It also provides a ResourceExtractor, which extracts a Maven project from your src/test/resources directory into a temporary working directory where you can do tricky stuff with it.</p> <p>Maven itself uses maven-verifier to run its core integration tests. For more information, please refer to <a class="externalLink" href="http://cwiki.apache.org/confluence/display/MAVENOLD/Creating+a+Maven+Integration+Test">Creating a Maven Integration Test</a>.</p> <div class="source"> @@ -373,7 +373,7 @@ }</pre></div> <p><b>Note</b>: maven-verifier and maven-verifier-plugin sound similar, but are totally different unrelated pieces of code. maven-verifier-plugin simply verifies the existence/absence of files on the filesystem. You could use it for functional testing, but you may need more features than maven-verifier-plugin provides.</p></div> <div class="section"> -<h3>maven-invoker-plugin<a name="maven-invoker-plugin"></a></h3> +<h3><a name="maven-invoker-plugin"></a>maven-invoker-plugin</h3> <p>You can use <a class="externalLink" href="https://svn.apache.org/repos/asf/maven/plugins/trunk/maven-invoker-plugin/">maven-invoker-plugin</a> to invoke Maven and to provide some BeanShell tests. Tests written in this way don't run under JUnit/TestNG; instead, they're run by Maven itself.</p> <div class="source"> <pre><project @@ -411,11 +411,11 @@ ... </project></pre></div></div> <div class="section"> -<h3>shitty-maven-plugin<a name="shitty-maven-plugin"></a></h3> +<h3><a name="shitty-maven-plugin"></a>shitty-maven-plugin</h3> <p>The <a class="externalLink" href="http://mojo.codehaus.org/shitty-maven-plugin/">shitty-maven-plugin</a> (Super Helpful Integration Testing ThingY) provides a simple way to run integration tests for a project (single module or multi-module).</p> <p>shitty-maven-plugin does many of the same things as the maven-invoker-plugin (it supports Groovy tests instead of BeanShell tests), though it has some features that aren't available in maven-invoker-plugin. Notably, it provides some advanced setup steps to automatically install your plugin using a special version name ("TESTING"), so your dummy projects can depend on that version explicitly.</p></div> <div class="section"> -<h3>maven-it-plugin<a name="maven-it-plugin"></a></h3> +<h3><a name="maven-it-plugin"></a>maven-it-plugin</h3> <p><b>Note</b>: maven-it-plugin is not at 1.0 yet. Use it at your own risk.</p> <p>The <a class="externalLink" href="https://svn.apache.org/repos/asf/maven/sandbox/trunk/plugins/maven-it-plugin/">maven-it-plugin</a> is used directly in the <tt>integration-test</tt> phase.</p> <p><b>Note</b>: this it plugin can not be used to test a plugin that is being built for the first time (i.e. with no release). In this case, you could, for instance, defined an it-snapshot of the plugin with <tt>maven-install-plugin</tt>. during the <tt>pre-integration-test</tt> phase.</p> @@ -525,7 +525,7 @@ ... </project></pre></div></div> <div class="section"> -<h3>maven-plugin-management-plugin<a name="maven-plugin-management-plugin"></a></h3> +<h3><a name="maven-plugin-management-plugin"></a>maven-plugin-management-plugin</h3> <p>The <a class="externalLink" href="https://svn.apache.org/repos/asf/maven/sandbox/trunk/plugins/maven-plugin-management-plugin/">maven-plugin-management-plugin</a> is to stage/unstage a plugin into the local repository for pre/post-integration-test.</p> <p>You need to configure the <tt>maven-plugin-test-plugin</tt> and the <tt>maven-surefire-plugin</tt>:</p> <div class="source"> Modified: websites/staging/maven/trunk/content/plugin-management.html ============================================================================== --- websites/staging/maven/trunk/content/plugin-management.html (original) +++ websites/staging/maven/trunk/content/plugin-management.html Fri Jul 11 05:10:35 2014 @@ -1,18 +1,18 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <!-- - | Generated by Apache Maven Doxia at 2014-07-01 + | Generated by Apache Maven Doxia at 2014-07-11 | Rendered using Apache Maven Stylus Skin 1.5 --> <html xmlns="http://www.w3.org/1999/xhtml"> <head> - <title>Maven - Project Plugin Management</title> + <title>Maven – Project Plugin Management</title> <style type="text/css" media="all"> @import url("./css/maven-base.css"); @import url("./css/maven-theme.css"); @import url("./css/site.css"); </style> <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" /> - <meta name="Date-Revision-yyyymmdd" content="20140701" /> + <meta name="Date-Revision-yyyymmdd" content="20140711" /> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script> @@ -42,7 +42,7 @@ Project Plugin Management </div> <div class="xright"> - Last Published: 2014-07-01 + Last Published: 2014-07-11 </div> <div class="clear"> <hr/> @@ -284,7 +284,7 @@ <div id="bodyColumn"> <div id="contentBox"> <div class="section"> -<h2>Project Plugin Management<a name="Project_Plugin_Management"></a></h2><a name="Project_Plugin_Management"></a> +<h2><a name="Project_Plugin_Management"></a>Project Plugin Management</h2><a name="Project_Plugin_Management"></a> <table border="0" class="bodyTable"> <tr class="a"> <th>GroupId</th> @@ -377,7 +377,7 @@ <tr class="a"> <td>org.apache.maven.plugins</td> <td><a class="externalLink" href="http://maven.apache.org/plugins/maven-site-plugin/">maven-site-plugin</a></td> -<td>3.3</td></tr> +<td>3.4</td></tr> <tr class="b"> <td>org.apache.maven.plugins</td> <td><a class="externalLink" href="http://maven.apache.org/plugins/maven-source-plugin/">maven-source-plugin</a></td> Modified: websites/staging/maven/trunk/content/plugins.html ============================================================================== --- websites/staging/maven/trunk/content/plugins.html (original) +++ websites/staging/maven/trunk/content/plugins.html Fri Jul 11 05:10:35 2014 @@ -1,18 +1,18 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <!-- - | Generated by Apache Maven Doxia at 2014-07-01 + | Generated by Apache Maven Doxia at 2014-07-11 | Rendered using Apache Maven Stylus Skin 1.5 --> <html xmlns="http://www.w3.org/1999/xhtml"> <head> - <title>Maven - Project Build Plugins</title> + <title>Maven – Project Build Plugins</title> <style type="text/css" media="all"> @import url("./css/maven-base.css"); @import url("./css/maven-theme.css"); @import url("./css/site.css"); </style> <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" /> - <meta name="Date-Revision-yyyymmdd" content="20140701" /> + <meta name="Date-Revision-yyyymmdd" content="20140711" /> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script> @@ -42,7 +42,7 @@ Project Build Plugins </div> <div class="xright"> - Last Published: 2014-07-01 + Last Published: 2014-07-11 </div> <div class="clear"> <hr/> @@ -284,7 +284,7 @@ <div id="bodyColumn"> <div id="contentBox"> <div class="section"> -<h2>Project Build Plugins<a name="Project_Build_Plugins"></a></h2><a name="Project_Build_Plugins"></a> +<h2><a name="Project_Build_Plugins"></a>Project Build Plugins</h2><a name="Project_Build_Plugins"></a> <table border="0" class="bodyTable"> <tr class="a"> <th>GroupId</th> @@ -317,13 +317,13 @@ <tr class="b"> <td>org.apache.maven.plugins</td> <td><a class="externalLink" href="http://maven.apache.org/plugins/maven-site-plugin/">maven-site-plugin</a></td> -<td>3.3</td></tr> +<td>3.4</td></tr> <tr class="a"> <td>org.apache.rat</td> <td><a class="externalLink" href="http://creadur.apache.org/rat/apache-rat-plugin/">apache-rat-plugin</a></td> <td>0.10</td></tr></table></div> <div class="section"> -<h2>Project Report Plugins<a name="Project_Report_Plugins"></a></h2><a name="Project_Report_Plugins"></a> +<h2><a name="Project_Report_Plugins"></a>Project Report Plugins</h2><a name="Project_Report_Plugins"></a> <table border="0" class="bodyTable"> <tr class="a"> <th>GroupId</th> Modified: websites/staging/maven/trunk/content/plugins/index.html ============================================================================== --- websites/staging/maven/trunk/content/plugins/index.html (original) +++ websites/staging/maven/trunk/content/plugins/index.html Fri Jul 11 05:10:35 2014 @@ -1,11 +1,11 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <!-- - | Generated by Apache Maven Doxia at 2014-07-01 + | Generated by Apache Maven Doxia at 2014-07-11 | Rendered using Apache Maven Stylus Skin 1.5 --> <html xmlns="http://www.w3.org/1999/xhtml"> <head> - <title>Maven - Available Plugins</title> + <title>Maven – Available Plugins</title> <style type="text/css" media="all"> @import url("../css/maven-base.css"); @import url("../css/maven-theme.css"); @@ -18,7 +18,7 @@ Dennis Lundberg Olivier Lamy Benson Margulies" /> <meta name="Date-Creation-yyyymmdd" content="20140419" /> - <meta name="Date-Revision-yyyymmdd" content="20140701" /> + <meta name="Date-Revision-yyyymmdd" content="20140711" /> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script> @@ -48,7 +48,7 @@ Benson Margulies" /> Available Plugins </div> <div class="xright"> - Last Published: 2014-07-01 + Last Published: 2014-07-11 </div> <div class="clear"> <hr/> @@ -246,13 +246,13 @@ Benson Margulies" /> <div id="bodyColumn"> <div id="contentBox"> <!-- 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. --><!-- NOTE: For help with the syntax of this file, see: --><!-- http://maven.apache.org/doxia/references/apt- format.html --><div class="section"> -<h2>Available Plugins<a name="Available_Plugins"></a></h2> +<h2><a name="Available_Plugins"></a>Available Plugins</h2> <p>Maven is - at its heart - a plugin execution framework; all work is done by plugins. Looking for a specific goal to execute? This page lists the core plugins and others. There are the build and the reporting plugins:</p> <ul> <li><b>Build plugins</b> will be executed during the build and they should be configured in the <tt><build/></tt> element from the POM.</li> <li><b>Reporting plugins</b> will be executed during the site generation and they should be configured in the <tt><reporting/></tt> element from the POM. Because the result of a Reporting plugin is part of the generated site, Reporting plugins should be both internationalized and localized. You can read more about the <a href="./localization.html">localization of our plugins</a> and how you can help.</li></ul> <div class="section"> -<h3>Supported By The Maven Project<a name="Supported_By_The_Maven_Project"></a></h3> +<h3><a name="Supported_By_The_Maven_Project"></a>Supported By The Maven Project</h3> <p>To see the most up-to-date list browse the Maven repository, specifically the <a class="externalLink" href="http://repo.maven.apache.org/maven2/org/apache/maven/plugins/"> <tt>org/apache/maven/plugins</tt></a> subfolder. <i>(Plugins are organized according to a directory structure that resembles the standard Java package naming convention)</i></p><!-- TODO: the repository manager should be able to produce a page like this. Ensure all descriptions are in the POM of these plugins. --><!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --><!-- The release dates in this table must follow the ISO-8601 standard: yyyy-MM-dd --><!-- See http://maven.apache.org/guides/development/guide-documentation-style.html --><!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> <table border="1" class="bodyTable"> <tr class="a"> @@ -699,7 +699,7 @@ Benson Margulies" /> <p>There are also some sandbox plugins into our <a class="externalLink" href="http://svn.apache.org/repos/asf/maven/sandbox/trunk/plugins">source repository</a>.</p> <p>Previous archived versions of plugins reference documentations are <a href="../plugins-archives/">located here</a>. </p></div> <div class="section"> -<h3>Retired<a name="Retired"></a></h3> +<h3><a name="Retired"></a>Retired</h3> <table border="1" class="bodyTable"> <tr class="a"> <th align="left"><b>Plugin</b></th> @@ -726,9 +726,9 @@ Benson Margulies" /> <td align="left">2014-03-24</td> <td align="left">Build a subset of interdependent projects in a reactor (Maven 2 only).</td></tr></table></div> <div class="section"> -<h3>Outside The Maven Land<a name="Outside_The_Maven_Land"></a></h3> +<h3><a name="Outside_The_Maven_Land"></a>Outside The Maven Land</h3> <div class="section"> -<h4>At codehaus.org<a name="At_codehaus.org"></a></h4> +<h4><a name="At_codehaus.org"></a>At codehaus.org</h4> <p>There are also <a class="externalLink" href="http://mojo.codehaus.org/plugins.html">many plug-ins</a> available at the <a class="externalLink" href="http://mojo.codehaus.org"> Mojo</a> project at Codehaus.</p> <p>To see the most up-to-date list, browse the Codehaus repository at <a class="externalLink" href="http://nexus.codehaus.org/">http://nexus.codehaus.org/</a>, specifically the <a class="externalLink" href="http://nexus.codehaus.org/content/repositories/releases/org/codehaus/mojo/"><tt>org/codehaus/mojo</tt></a> subfolder of the releases-repository. Here are a few common ones:</p> <table border="1" class="bodyTable"> @@ -766,10 +766,10 @@ Benson Margulies" /> <td align="left"><a class="externalLink" href="http://mojo.codehaus.org/versions-maven-plugin/"> <tt>versions</tt></a></td> <td align="left">Manage versions of your project, its modules, dependencies and plugins.</td></tr></table></div> <div class="section"> -<h4>At code.google.com<a name="At_code.google.com"></a></h4> +<h4><a name="At_code.google.com"></a>At code.google.com</h4> <p>There are also <a class="externalLink" href="http://code.google.com/hosting/search?q=maven+plugin+label%3Amaven&projectsearch=Search+Projects">many plug-ins</a> available at the <a class="externalLink" href="http://code.google.com"> Google Code</a>.</p></div> <div class="section"> -<h4>Misc<a name="Misc"></a></h4> +<h4><a name="Misc"></a>Misc</h4> <p>A number of other projects provide their own Maven plugins. This includes:</p> <table border="1" class="bodyTable"> <tr class="a"> @@ -805,7 +805,7 @@ Benson Margulies" /> <td align="left"><a class="externalLink" href="http://tomcat.apache.org/maven-plugin.html">Apache Tomcat Project</a></td> <td align="left">Run an Apache Tomcat container for rapid webapp development.</td></tr></table></div></div> <div class="section"> -<h3>Resources<a name="Resources"></a></h3> +<h3><a name="Resources"></a>Resources</h3> <ol style="list-style-type: decimal"> <li><a href="../guides/mini/guide-configuring-plugins.html">Guide to Configuring Plugins</a></li></ol></div></div> </div> Modified: websites/staging/maven/trunk/content/plugins/localization.html ============================================================================== --- websites/staging/maven/trunk/content/plugins/localization.html (original) +++ websites/staging/maven/trunk/content/plugins/localization.html Fri Jul 11 05:10:35 2014 @@ -1,11 +1,11 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <!-- - | Generated by Apache Maven Doxia at 2014-07-01 + | Generated by Apache Maven Doxia at 2014-07-11 | Rendered using Apache Maven Stylus Skin 1.5 --> <html xmlns="http://www.w3.org/1999/xhtml"> <head> - <title>Maven - Localization of Plugins</title> + <title>Maven – Localization of Plugins</title> <style type="text/css" media="all"> @import url("../css/maven-base.css"); @import url("../css/maven-theme.css"); @@ -15,7 +15,7 @@ <meta name="author" content="Dennis Lundberg Vincent Siveton" /> <meta name="Date-Creation-yyyymmdd" content="20120312" /> - <meta name="Date-Revision-yyyymmdd" content="20140701" /> + <meta name="Date-Revision-yyyymmdd" content="20140711" /> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script> @@ -45,7 +45,7 @@ Vincent Siveton" /> Localization of Plugins </div> <div class="xright"> - Last Published: 2014-07-01 + Last Published: 2014-07-11 </div> <div class="clear"> <hr/> @@ -243,7 +243,7 @@ Vincent Siveton" /> <div id="bodyColumn"> <div id="contentBox"> <div class="section"> -<h2>Localization of Plugins<a name="Localization_of_Plugins"></a></h2> +<h2><a name="Localization_of_Plugins"></a>Localization of Plugins</h2> <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><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> @@ -629,7 +629,7 @@ Vincent Siveton" /> <td align="left"><a class="externalLink" href="http://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> <div class="section"> -<h3>Localizing a Plugin<a name="Localizing_a_Plugin"></a></h3> +<h3><a name="Localizing_a_Plugin"></a>Localizing a Plugin</h3> <ul> <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 <tt>src/main/resources</tt> folder.</li> @@ -657,31 +657,31 @@ Vincent Siveton" /> <pre>svn diff > MYISSUE-123.patch</pre></div></li> <li>Attach your patch file to the issue in JIRA.</li></ul></div> <div class="section"> -<h3>Tools<a name="Tools"></a></h3> +<h3><a name="Tools"></a>Tools</h3> <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 class="source"> <pre>native2ascii checkstyle-report_es.properties checkstyle-report_es-encoded.properties</pre></div> <div class="section"> -<h4>Tools to find out the charset of a file<a name="Tools_to_find_out_the_charset_of_a_file"></a></h4> +<h4><a name="Tools_to_find_out_the_charset_of_a_file"></a>Tools to find out the charset of a file</h4> <ul> <li>Unix <tt>file</tt> 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></div> <div class="section"> -<h4>Tools to write a file in a given charset<a name="Tools_to_write_a_file_in_a_given_charset"></a></h4> +<h4><a name="Tools_to_write_a_file_in_a_given_charset"></a>Tools to write a file in a given charset</h4> <p>Any editor like Notepad++, Eclipse, IntelliJ IDEA, ...</p></div> <div class="section"> -<h4>Tools to convert a file from one encoding to another encoding<a name="Tools_to_convert_a_file_from_one_encoding_to_another_encoding"></a></h4> +<h4><a name="Tools_to_convert_a_file_from_one_encoding_to_another_encoding"></a>Tools to convert a file from one encoding to another encoding</h4> <ul> <li>Unix <tt>iconv</tt> command</li> <li>Notepad++</li></ul></div> <div class="section"> -<h4>IDE plugins<a name="IDE_plugins"></a></h4> +<h4><a name="IDE_plugins"></a>IDE plugins</h4> <ul> <li><a class="externalLink" href="http://propedit.sourceforge.jp/index_en.html">Properties Editor Eclipse Plugin</a></li></ul></div></div> <div class="section"> -<h3>References<a name="References"></a></h3> +<h3><a name="References"></a>References</h3> <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></div></div> </div>