Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Current »

Guide to Doxia Macros

Out of Date


This page is out-of-date. Please see the Doxia Macros Guide.

The Doxia Core module includes the Echo and Snippet macros, and you can create your own.

Macros are Plexus components with a role of org.apache.macro.doxia.macro.Macro.

The role-hint is the macro name.

For example:

is called with

and will output

  param ---> value
  param2 ---> value2

(The echo macro simply prints out the key and value of any parameters that you supply.)

Note that macros must not be indented in your apt source document.

In the execute method, TODO

The following plugin config can be used to generate the Plexus component.xml file for the module containing your macro:

Using Doxia Macros by samples


For instance, in apt file:

And in xdoc file:

Table Of Content (toc)

For instance, in APT file:

And in Xdoc file:

From Javadoc:


Display the specificated section number or all sections if 0 (in this case, other paramaters are ignored).
Positive int, not mandatory, 0 by default.


Display the depth starting for the given section number.
Positive int, not mandatory, 0 by default.


Display the depth ending for the given section number.
Positive int, not mandatory, 5 by default.

  • No labels