antora:help Goal

Displays help information about the goals and parameters of the Antora Maven plugin.

Plugin artifact

org.antora/antora-maven-plugin

Fully-qualified name

org.antora:antora-maven-plugin:1.0.0-alpha.4:help

Default phase

none

Requirements
  • Does not require a project

  • Does not require dependency resolution or collection

  • Does not require online

  • Is thread safe

Summary

The help information for the Antora Maven plugin can be displayed before or after the plugin has been added to the project.

To display the help before adding the plugin to your project, you must reference the plugin using its fully qualified artifact name (i.e., <groupId>:<artifactId> or <groupId>:<artifactId>:<version>). If no version is specified, Maven will select the latest version.

$ mvn org.antora:antora-maven-plugin:help

The plugin will be downloaded and installed into your local Maven repository on demand.

If the plugin is added to the project, you can reference the plugin using the goal prefix, which is antora.

$ mvn antora:help

The output generated by the help goal can be configured using its optional parameters.

You can also use the Maven help:describe goal to display goals and available parameters or check phases for any plugin. The equivalent to the antora:help goal is:

$ mvn help:describe -Dplugin=org.antora:antora-maven-plugin

To check whether the antora phase is configured in your project, you can ask the help plugin to describe it:

$ mvn help:describe -Dcmd=antora

Refer to the Maven help:describe documentation for more information about usage and available parameters.

Configuration parameters

The parameters listed below are optional.

<detail>

If set, displays all available parameters for each goal or the specified goal.

$ mvn antora:help -Ddetail=true
Type

boolean

Default value

false

User property

detail

<goal>

The name of the goal for which you want help displayed. If the parameter is unspecified, the help for all goals is displayed.

$ mvn antora:help -Ddetail=true -Dgoal=antora
Type

String

User property

goal

<indentSize>

Specifies the number of spaces per indentation level in the help output. The value of the parameter should be positive (otherwise it’s ignored).

Type

int

Default value

2

User property

indentSize

<lineLength>

Specifies the preferred maximum length of a display line. The value of the parameter should be positive (otherwise it’s ignored).

Type

int

Default value

80

User property

lineLength