Descriptor ID

Provide the artifact coordinates in the colon-separated short format.

The format is groupId:artifactId:type:version:classifier, where type and classifier are optional.

Here are two examples:

commons-lang:commons-lang:2.6

commons-lang:commons-lang:jar:2.6:sources

Dependency XML

Provide the artifact coordinates in the Maven Dependency XML format. Here are two examples:

<dependency>
  <groupId>commons-lang</groupId>
  <artifactId>commons-lang</artifactId>
  <version>2.6</version>
</dependency>

<dependency>
  <groupId>commons-lang</groupId>
  <artifactId>commons-lang</artifactId>
  <type>jar</type>
  <version>2.6</version>
  <classifier>sources</code>
</dependency>

System Identifier

The system identifier references the connection information to the server. The information is either specified via Confluence's Shortcut Links or via Space Properties.

Nexus Repository ID

Identifies the repository within the Nexus server to reference the artifact.

Please note that this value is not used, if the space property Nexus Service is specified. The value may be left blank. In this case the value of the space property Nexus Default Repo ID is used. If the value is not set, the default central is assumed.

There are special identifiers that control the way the URL to the artifact is constructed.

Render Link

Check to render a simple link to the artifact on the Nexus server. If unchecked the link is not rendered.

Label

The label to be rendered for the link. If Render Link is unchecked, the label is not used.

If the label starts with a question mark ('?'), the label is considered to be a pattern. The five coordinates are recognized and translated to their artifact property values.The values are separated by colons (':').

All other characters are ignored.

Render XML Snippet

Check to render the reference as a Maven XML dependency. If unchecked this information is not rendered.

Plain XML

If unchecked, the XML is rendered within the Code Block Macro (only then do the code attributes apply). Otherwise it is rendered as plain XML fragment.

If Render XML Snippet is unchecked, this value is not used.

Is Library

If selected the reference links to a library, otherwise a plugin is assumed. This selection makes a difference if an XML fragment is rendered.

If the option is checked, the XML block for the artifact coordinates will be rendered as

<dependency>
  <groupId>de.smartics.maven.plugin</groupId>
  <artifactId>smartics-jboss-modules-maven-plugin</artifactId>
  <version>2.0.0</version>
</dependency>

If unchecked, the result is rendered as follows:

<plugin>
  <groupId>de.smartics.maven.plugin</groupId>
  <artifactId>smartics-jboss-modules-maven-plugin</artifactId>
  <version>2.0.0</version>
</plugin>

Code Title

If XML is rendered not in plain text, this value is passed to the Code Block Macro.

Also allows the pattern syntax for the label (e.g. "?gav") to be passed as title to the code macro. See Label for details.

Additionally the title may be enclosed in square brackets. In this case the title is rendered as a link. This may be combined with the GAV pattern (e.g. "[?gav]").

Code Theme

If XML is rendered not in plain text, this value is passed to the Code Block Macro.

Code Line Numbers

If XML is rendered not in plain text, this value is passed to the Code Block Macro.

Code First Line

If XML is rendered not in plain text, this value is passed to the Code Block Macro.

Code Collapse

If XML is rendered not in plain text, this value is passed to the Code Block Macro.

Space Properties

The macro uses the following Space Properties:

Autoconvert

To create the macro authors may simply paste the URI to the artifact on a Nexus server to the editor.

All is needed is a configuration of the Nexus base URI. For more information on this topic, please refer to Autoconvert Information System URIs.