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


    16.3. Personnaliser le descripteur de site

    Quand vous ajoutez du contenu à votre site, vous allez vouloir modifier le menu gauche de navigation qui est généré avec votre site. Le descripteur suivant personnalise le logo affiché dans le coin en haut à gauche de votre site. En plus de personnaliser l'entête de votre site, ce même descripteur ajoute une entrée dans le menu de navigation : un simple lien vers une page de présentation générale.

    Exemple 16.1. Descripteur de site initial

    <project name="Sample Project">
      <bannerLeft>
        <name>Sonatype</name>
        <src>images/logo.png</src>
        <href>http://www.sonatype.com</href>
      </bannerLeft>
      <body>
        <menu name="Sample Project">
          <item name="Overview" href="index.html"/>      
        </menu>
        <menu ref="reports"/>
      </body>
    </project>
    


    Ce descripteur référence une image, logo.png. Celle-ci doit être placée dans le répertoire ${basedir}/src/site/resources/images. En plus des changements du descripteur de site, vous voudrez créer une page index.apt à placer dans le répertoire ${basedir}/src/site/apt. Éditez ce fichier pour lui donner le contenu suivant. Ce fichier sera transformé en index.html et servira de page d'accueil à votre site.

      Welcome to the Sample Project, we hope you enjoy your time
      on this project site.  We've tried to assemble some 
      great user documentation and developer information, and 
      we're really excited that you've taken the time to visit
      this site.
    
    What is Sample Project
    
      Well, it's easy enough to explain.   This sample project is 
      a sample of a project with a Maven-generated site from
      Maven: The Definitive	Guide.   A dedicated team of volunteers
      help maintain this sample site, and so on and so forth.
    

    Pour visualiser votre site, exécutez les commandes mvn clean site et mvn site:run :

    $ mvn clean site
    $ mvn site:run

    Une fois cela fait, ouvez un navigateur et rendez-vous à l'adresse http://localhost:8080. La page affichée devrait ressembler à la caputure d'écran de la Figure 16.2, « Site web personnalisé du projet  ».

    Site web personnalisé du projet

    Figure 16.2. Site web personnalisé du projet


    16.3.1. Personnaliser les images des en-têtes du site

    Pour personnaliser les éléments graphiques qui apparaissent dans les coins en haut à gauche et en haut à droite de la page, vous pouvez utiliser les balises bannerLeft et bannerRight du descripteur de site.

    Exemple 16.2. Descripteur avec ajout d'images en haut à gauche et à droite du site

    <project name="Sample Project">
    
      <bannerLeft>
        <name>Left Banner</name>
        <src>images/banner-left.png</src>
        <href>http://www.google.com</href>
      </bannerLeft>
      
      <bannerRight>
        <name>Right Banner</name>
        <src>images/banner-right.png</src>
        <href>http://www.yahoo.com</href>
      </bannerRight>
      ...
    </project>
    


    Les deux balises bannerLeft et bannerRight sont configurées avec : un nom (name), un empalcement d'image (src) et un lien (href). Dans le descripteur de site ci-dessus, le plugin Maven Site utilisera les images banner-left.png et banner-right.png pour le coins en haut à gauche et en haut à droite du site. Maven recherchera ces images dans le répertoire ${basedir}/src/site/resources/images.