Maven: The definitive Guide FR

Maven place tous les documents du site dans le répertoire src/site. Les documents avec des formats similaires sont regroupés dans des sous-répertoires de celui-ci. Ainsi, les fichiers APT se trouvent dans le répertoire src/site/apt, les fichiers FML dans src/site/fml et les documents XDoc dans src/site/xdoc. Le descripteur de site se trouve à l'emplacement src/site/site.xml et toutes les références sont stockées dans le répertoire src/site/resources. Lorsque le plugin Maven Site construit un site web, il copie tout le contenu de ce répertoire à la racine du site. Si vous stockez une image dans src/site/resources/images/test.png, vous pouvez l'utiliser dans votre site en utilisant le chemin relatif images/test.png.

L'exemple suivant récapitule l'emplacement dans un projet de tous les fichiers APT, FML, HTML, XHTML, et XDoc. Notez que le contenu XHTML est simplement stocké dans le répertoire dédié aux ressources. Le fichier architecture.html ne sera donc pas traité par Doxia, mais simplement copié dans le répertoire destination. Vous pouvez utiliser ce principe pour inclure du contenu HTML brut sur lequel vous ne voulez pas appliquer de modèlet ou que vous ne voulez pas formater avec Doxia ou le plugin Maven Site.

sample-project
+- src/
   +- site/
      +- apt/
      |  +- index.apt
      |  +- about.apt
      |  |
      |  +- developer/
      |     +- embedding.apt
      |
      +- fml/
      |  +- faq.fml
      |
      +- resources/
      |  +- images/
      |  |  +- banner-left.png
      |  |  +- banner-right.png
      |  |
      |  +- architecture.html
      |  +- jira-roadmap-export-2007-03-26.html
      |
      +- xdoc/
      |  +- xml-example.xml
      |
      +- site.xml

Notez que la documentation pour les développeurs se trouve dans le fichier src/site/apt/developer/embedding.apt. Celui-ci se trouve dans un sous-répertoire d'apt, il en sera de même pour sa page HTML correspondante. Quand le plugin Site effectue le rendu du répertoire src/site/apt, il génère les fichiers HTML dans des répertoires relatifs à la racine du site. Si un fichier se trouve dans le répertoire apt, son fichier généré se trouvera à la racine du site web. Si un fichier se trouve dans le répertoire apt/developer, son fichier généré se trouvera dans le répertoire developer/ du site web.