Maven Doxia Integration Tools
This shared component has some utilities that are useful when integrating Doxia in Maven, mainly for site generation and report creation.
The main entry point is the SiteTool Plexus component.
Usage
Instructions on how to use the integration of Doxia in Maven can be found here.
site.xml Decoration Model Interpolation
Interpolation of site.xml decoration model injects Maven project's information, replacing ${...} with calculated values like it happens in Maven model interpolation.
Interpolation can be late or early:
- with late interpolation, replacement happens after inheritance. This is the classical behaviour in Maven pom,
- with early interpolation, replacement happens before inheritance: this was the default behaviour for
project.*values until Doxia Sitetools 1.7 (used in Maven Site Plugin 3.5), when these early and late interpolation definitions didn't exist. Since Doxia Sitetools 1.7.1 (used in Maven Site Plugin 3.5.1), early interpolation happens forthis.*values.
Values are evaluated in sequence from different syntaxes:
| late value | early value | evaluation result | common examples |
|---|---|---|---|
project.* |
this.* |
POM content (see POM reference) | ${project.version} ${this.url} |
* |
this.* |
model properties, such as project properties set in the pom | ${any.key} ${this.any.key} |
env.* * |
environment variables | ${env.PATH} |