Ce site met a disposition le build journalier de la traduction francaise du Maven: The Definitive Guide
Consultez :
  • Les documents de reference sur le projet original
  • Les sources de la traduction fr sur GitHub
  • maven


    10.8.6. Utiliser des macros Doxia

    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}
    

    Exemple 10.19. Résultat de la macro snippet en XHTML

    <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>
    


    Avertissement

    Les macros Doxia NE DOIVENT PAS être indentées dans les documents APT. Si vous le faites, le parseur APT ignorera ces macros complètement.

    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.