You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by hb...@apache.org on 2017/11/17 08:08:28 UTC
svn commit: r1815554 - in /maven/site/trunk/content:
apt/guides/introduction/introduction-to-plugins.apt
apt/guides/plugin/guide-java-plugin-development.apt
apt/plugin-developers/index.apt site.xml
xdoc/developers/mojo-api-specification.xml
Author: hboutemy
Date: Fri Nov 17 08:08:28 2017
New Revision: 1815554
URL: http://svn.apache.org/viewvc?rev=1815554&view=rev
Log:
reworked introduction to plugins development in plugin developers center
Modified:
maven/site/trunk/content/apt/guides/introduction/introduction-to-plugins.apt
maven/site/trunk/content/apt/guides/plugin/guide-java-plugin-development.apt
maven/site/trunk/content/apt/plugin-developers/index.apt
maven/site/trunk/content/site.xml
maven/site/trunk/content/xdoc/developers/mojo-api-specification.xml
Modified: maven/site/trunk/content/apt/guides/introduction/introduction-to-plugins.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/content/apt/guides/introduction/introduction-to-plugins.apt?rev=1815554&r1=1815553&r2=1815554&view=diff
==============================================================================
--- maven/site/trunk/content/apt/guides/introduction/introduction-to-plugins.apt (original)
+++ maven/site/trunk/content/apt/guides/introduction/introduction-to-plugins.apt Fri Nov 17 08:08:28 2017
@@ -1,5 +1,5 @@
------
- Introduction to Maven 2.0 Plugin Development
+ Introduction to Maven Plugin Development
------
John Casey
------
@@ -26,7 +26,7 @@
~~ NOTE: For help with the syntax of this file, see:
~~ http://maven.apache.org/doxia/references/apt-format.html
-Introduction to Maven 2.0 Plugin Development
+Introduction to Maven Plugin Development
Maven consists of a core engine which provides basic project-processing
capabilities and build-process management, and a host of plugins which are
@@ -48,10 +48,10 @@ Introduction to Maven 2.0 Plugin Develop
can be customized through a set of unique parameters which are exposed by a
description of each plugin goal (or Mojo).
- One of the simplest plugins in Maven 2.0 is the Clean Plugin. The
+ One of the simplest plugins in Maven is the Clean Plugin. The
{{{../../plugins/maven-clean-plugin/}Maven
Clean plugin}} (maven-clean-plugin) is responsible for removing the target
- directory of a Maven 2 project. When you run "mvn clean", Maven 2 executes
+ directory of a Maven project. When you run "mvn clean", Maven executes
the "clean" goal as defined in the Clean plug-in, and the target directory
is removed. The Clean plugin
{{{../../plugins/maven-clean-plugin/clean-mojo.html}defines
@@ -60,12 +60,15 @@ Introduction to Maven 2.0 Plugin Develop
* What is a Mojo (<And Why the H--- is it Named 'Mojo'>)?
- A Mojo is really just a goal in Maven 2, and plug-ins consist of
+ A Mojo is really just a goal in Maven, and plug-ins consist of
any number of goals (Mojos). Mojos can be defined as annotated Java classes or
Beanshell script. A Mojo specifies
metadata about a goal: a goal name, which phase of the lifecycle it fits into,
and the parameters it is expecting.
+ Mojo term was introduced in Maven 2 as a complete rework on how to write plugins
+ (see below for more details on Maven 1.x plugins comparison).
+
MOJO is a play on POJO (Plain-old-Java-object), substituting "Maven" for
"Plain". Mojo is also an iteresting word (see {{{http://www.answers.com/mojo&r=67}definition}}).
From {{{http://www.wikipedia.org}Wikipedia}}, a "mojo" is defined as:
@@ -81,7 +84,7 @@ Introduction to Maven 2.0 Plugin Develop
Resources
- [[1]] {{{../plugin/guide-java-plugin-development.html}Plugin development guide}}
+ [[1]] {{{/plugin-developers/index.html}Plugin Development Center}}
[[2]] {{{../mini/guide-configuring-plugins.html}Configuring plugins}}
Modified: maven/site/trunk/content/apt/guides/plugin/guide-java-plugin-development.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/content/apt/guides/plugin/guide-java-plugin-development.apt?rev=1815554&r1=1815553&r2=1815554&view=diff
==============================================================================
--- maven/site/trunk/content/apt/guides/plugin/guide-java-plugin-development.apt (original)
+++ maven/site/trunk/content/apt/guides/plugin/guide-java-plugin-development.apt Fri Nov 17 08:08:28 2017
@@ -177,7 +177,7 @@ public class GreetingMojo extends Abstra
*-------------+----------------------------------------------------+
|<<<compile>>>|Compiles the Java code for the plugin |
*-------------+----------------------------------------------------+
-|<<<process-classes>>>|Extracts data to build the plugin descriptor|
+|<<<process-classes>>>|Extracts data to build the {{{/ref/current/maven-plugin-api/plugin.html}plugin descriptor}}|
*-------------+----------------------------------------------------+
|<<<test>>> |Runs the plugin's unit tests |
*-------------+----------------------------------------------------+
Modified: maven/site/trunk/content/apt/plugin-developers/index.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/content/apt/plugin-developers/index.apt?rev=1815554&r1=1815553&r2=1815554&view=diff
==============================================================================
--- maven/site/trunk/content/apt/plugin-developers/index.apt (original)
+++ maven/site/trunk/content/apt/plugin-developers/index.apt Fri Nov 17 08:08:28 2017
@@ -38,6 +38,8 @@ Plugin Developers Centre
~~TODO: tasks as buttons?
+ * {{{../guides/introduction/introduction-to-plugins.html} Introduction to Plugin Development}} - Introduction to concepts
+
* {{{../guides/plugin/guide-java-plugin-development.html} Your First Mojo}} - Learn how to write your first plugin
* {{{./plugin-testing.html} Testing your Plugin}} - How to write tests for your plugins
Modified: maven/site/trunk/content/site.xml
URL: http://svn.apache.org/viewvc/maven/site/trunk/content/site.xml?rev=1815554&r1=1815553&r2=1815554&view=diff
==============================================================================
--- maven/site/trunk/content/site.xml (original)
+++ maven/site/trunk/content/site.xml Fri Nov 17 08:08:28 2017
@@ -82,6 +82,7 @@ under the License.
<item name="POM Reference" href="/pom.html" />
</item>
<item name="Plugin Developer Centre" href="/plugin-developers/index.html" collapse="true">
+ <item name="Introduction to Plugin Development" href="/guides/introduction/introduction-to-plugins.html" />
<item name="Your First Mojo" href="/guides/plugin/guide-java-plugin-development.html" />
<item name="Mojo API" href="/developers/mojo-api-specification.html" />
<item name="Maven API" href="/ref/current/index.html"/>
Modified: maven/site/trunk/content/xdoc/developers/mojo-api-specification.xml
URL: http://svn.apache.org/viewvc/maven/site/trunk/content/xdoc/developers/mojo-api-specification.xml?rev=1815554&r1=1815553&r2=1815554&view=diff
==============================================================================
--- maven/site/trunk/content/xdoc/developers/mojo-api-specification.xml (original)
+++ maven/site/trunk/content/xdoc/developers/mojo-api-specification.xml Fri Nov 17 08:08:28 2017
@@ -855,7 +855,7 @@ under the License.
]
</li>
<li>Plexus Project (Plexus container) [
- <a href="https://github.com/sonatype/plexus-containers/">link</a>
+ <a href="https://codehaus-plexus.github.io/">link</a>
]
</li>
<li>Maven Plugin API [