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.2. Contruire le site d'un projet avec Maven

    Pour illustrer le processus de construction du site web d'un projet, créons un projet en utilisant le plugin Archetype :

    $ mvn archetype:create -DgroupId=org.sonatype.mavenbook -DartifactId=sample-project
    

    Cette commande crée un projet Maven minimaliste qui contient une classe Java dans le répertoire src/main/java et un simple POM. Ensuite, vous pouvez construire le site en exécutant la commande mvn site. Pour construire le site et afficher le résultat dans un navigateur web, vous pouvez utiliser la commande mvn site:run. Celle-ci construira le site et démarrera une instance de Jetty.

    $ cd sample-project
    $ mvn site:run
    [INFO] Scanning for projects...
    [INFO] Searching repository for plugin with prefix: 'site'.
    [INFO] ------------------------------------------------------------------------
    [INFO] Building sample-project
    [INFO]    task-segment: [site:run] (aggregator-style)
    [INFO] ------------------------------------------------------------------------
    [INFO] Setting property: classpath.resource.loader.class => 
           'org.codehaus.plexus.velocity.ContextClassLoaderResourceLoader'.
    [INFO] Setting property: velocimacro.messages.on => 'false'.
    [INFO] Setting property: resource.loader => 'classpath'.
    [INFO] Setting property: resource.manager.logwhenfound => 'false'.
    [INFO] [site:run]
    2008-04-26 11:52:26.981::INFO:  Logging to STDERR via org.mortbay.log.StdErrLog
    [INFO] Starting Jetty on http://localhost:8080/
    2008-04-26 11:52:26.046::INFO:  jetty-6.1.5
    2008-04-26 11:52:26.156::INFO:  NO JSP Support for /, did not find 
             org.apache.jasper.servlet.JspServlet
    2008-04-26 11:52:26.244::INFO:  Started SelectChannelConnector@0.0.0.0:8080
    

    Une fois Jetty démarré sur le port 8080, le site du projet est disponible à l'adresse http://localhost:8080/ à partir de votre navigateur web. Vous devriez y découvrir un résultat similaire à la Figure 16.1, « Site généré par Maven ».

    Site généré par Maven

    Figure 16.1. Site généré par Maven


    Si vous cliquez sur ce site web, vous constaterez qu'il n'est pas très pratique comme véritable site de projet. Il ne contient aucne information (et n'est pas très joli). Tant que le projet sample-project n'est pas configuré pour afficher la liste des développeurs, le gestionnaire d'anomalies ou le code source, toutes les pages du projet ne contiendront aucune information intéressante. Même la page d'index du site est vide de contenu, elle affiche un message indiquant qu'aucune description n'a été associée à ce projet. Pour personnaliser ce site, vous devez commencer par ajouter du contenu à votre projet et dans votre POM.

    Si vous décidez d'utiliser le plugin Maven Site pour construire le site de votre projet, vous voudrez donc le personnaliser. Vous voudrez renseigner les champs du POM qui permettent de lister les personnes participant au projet. Vous voudrez personnaliser également le menu gauche du site et les liens affichés en haut de la page. Pour personnaliser le contenu de ce site, dont le menu de navigation, vous devez éditer le descripteur de site.