Maven: The definitive Guide FR

En plus de ces fonctionnalités avancées de rendu, Doxia fournit également un moteur de macros. Celui-ci permet de déclencher l'injection de contenu dynamique pour chaque entrée. Prenons un exemple pour illuster l'utilisation de ce moteur, la macro snipet qui permet à un document de récupérer un extrait de code depuis un fichier disponible via HTTP. En utilisant cette macro, un petit morceau d'APT peut etre transformé en XHTML. Le morceau de code APT suivant appelle la macro snipet. Notez que ce code doit être sur une seule ligne, un antislash peut tout de même être inséré pour faire des retours à la ligne lors de son affichage.

%{snippet|id=modello-model|url=http://svn.apache.org/repos/asf/maven/\
archetype/trunk/maven-archetype/maven-archetype-model/src/main/\
mdo/archetype.mdo}

<div class="source"><pre>

<model>
  <id>archetype</id>
  <name>Archetype</name>
  <description><![CDATA[Maven's model for the archetype descriptor.
  ]]></description>
  <defaults>
    <default>
      <key>package</key>
      <value>org.apache.maven.archetype.model</value>
    </default>
  </defaults>
  <classes>
    <class rootElement="true" xml.tagName="archetype">
      <name>ArchetypeModel</name>
      <description>Describes the assembly layout and packaging.</description>
      <version>1.0.0</version>
      <fields>
        <field>
          <name>id</name>
          <version>1.0.0</version>
          <required>true</required>
          <type>String</type>
        </field>
        ...
      </fields>
    </class>
  </classes>
</model>

</pre></div>

Pour plus d'information sur l'utilisation de la macro snipet, référez-vous au guide de cette macro sur le Site Maven à l'adresse suivante http://maven.apache.org/guides/mini/guide-snippet-macro.html.