CarmaBlog

Agilité, Développement Java, Nouvelles technologies et plus…
  • rss
  • Accueil
  • Management
  • Programmation agile
  • Technologie
  • Linux
  • Evénement
  • App Android
  • Contact
  • A propos de l'auteur
  • English
  • Francais

Plus loin avec le Maven Site

Fabian Piau | dimanche 4 avril 2010 - 22:29
  • Imprimer
  • Twitter
  • LinkedIn
  • Facebook
  • Pocket

 English version available

Introduction

Si votre projet est mavenisé (comprenez sous Maven), il serait vraiment dommage de ne pas utiliser toutes les possibilités du Maven Site.

Bien configuré, il peut devenir rapidement la « vitrine » de votre projet en centralisant ses informations les plus utiles tout en gardant un effort de maintenance très faible. Les sites Maven sont de plus en plus utilisés dans les projets open source.

Cela peut être des informations générales sur le projet (description, équipe, dépendances…), des sous-rapports spécifiques (Checkstyle, PMD, Javadoc, SureFire, Cobertura…), une FAQ (Frequently Asked Questions) sur le projet, bref ce que vous voulez…

Ce tutoriel va vous apprendre à personnaliser le site de base généré par Maven.


Prérequis : Maven doit être installé sur votre machine.

Version utilisée : 2.0.9. Suivant les versions, les commandes peuvent être différentes.


Création du projet

Tout au long du tutoriel, nous allons utiliser un projet Maven 2 de test généré grâce au plugin Archetype.

Dans un terminal, tapez :

mvn archetype:generate

Choisissez le modèle « maven-archetype-site ». Il permet de générer une structure complète de site.

17

Archetype vous demande plusieurs informations :

  • Le groupId du projet : demo.mavensite.personalization;
  • L’artifactId : maven-site-personalization;
  • La version : Appuyez directement sur Entrée, la version 1.0-SNAPSHOT nous convient;
  • Le package où mettre les classes : Par défaut, il reprend l’artifactId. C’est parfait, appuyez donc sur Entrée.

Maven-archetype-plugin

Un récapitulatif s’affiche, validez vos choix en appuyant sur Entrée une dernière fois.

Le projet est maintenant créé.


Parcours rapide du projet créé

Un dossier a été créé portant le nom « maven-site-personalization » .

Voici son architecture :

Architecture du projet

Un dossier « fr »? Et oui! Le Maven Site supporte l’internationalisation. Par défaut, celui généré par Archetype est disponible en anglais (langue par défaut) et en français.

Voici une description des différents fichiers créés.

  • site.xml : Le descripteur de site. Il définit le site dans son ensemble (la bannière, le menu à gauche, les liens disponibles). C’est en quelque sorte le point d’entrée de la génération;
  • site_fr.xml : Le descripteur pour la version française;
  • Tous les autres fichiers représentent une page du site. Pas d’HTML ici, les pages sont écrites dans des formats spécifiques à Maven qui serviront ensuite à générer du HTML.

Le site d’exemple reprend les 3 différents formats possibles (APT, Xdoc et FML).

  • Format Xdoc : C’est un format XML, ce format est disponible depuis les versions 1.x de Maven;
  • Format APT « Almost Plain Text » : Désigné remplaçant du Xdoc, ce format de type wiki est beaucoup moins verbeux;
  • Format FML : C’est le format utilisé pour créer des FAQ.


Génération du site

Après cette analyse de structure, nous allons générer le site à l’aide de la commande :

mvn site

ou

mvn site:run

pour le lancer en local avec le serveur Jetty.

Le site généré est disponible dans /target/site/index.html (ou http://localhost:8080 si vous avez choisi Jetty)

Le Maven Site généré

Le Maven Site généré

Il s’agit du site par défaut. Pour accéder à la version française modifiez le chemin par /site/fr/index.html (ou http://localhost:8080/fr).

Un peu contraignant ce changement de langue, n’est-ce pas?

Nous allons voir juste après comment ajouter des liens pour naviguer facilement entre les 2 langues.


Ajout d’une page

Pour ajouter une nouvelle page au site, il suffit d’ajouter un fichier dans un des 3 dossiers

( « apt », « fml » ou « xdoc » ).

Par exemple, j’ai ajouté le fichier « my_new_category.apt » contenant un texte bien formaté dans le dossier « apt ».

Il faut ensuite le référencer dans le descripteur de site.

<?xml version='1.0' encoding='ISO-8859-1'?>
<project name='Maven'>
  <bannerLeft>
    <name>Maven</name>
    <src>http://maven.apache.org/images/apache-maven-project.png</src>
    <href>http://maven.apache.org/</href>
  </bannerLeft>
  <bannerRight>
    <src>http://maven.apache.org/images/maven-small.gif</src>
  </bannerRight>
  <body>
    <links>
      <item name='Apache' href='http://www.apache.org/' />
      <item name='Maven 1.0' href='http://maven.apache.org/'/>
      <item name='Maven 2' href='http://maven.apache.org/maven2/'/>
    </links>
    <menu name='Maven 2.0'>
      <item name='APT Format' href='format.html'/>
      <item name='FAQ' href='faq.html'/>
      <item name='Xdoc Example' href='xdoc.html'/>
      <item name='My new category' href='my_new_category.html'/>	  
    </menu>
  </body>
</project>

Relancez la génération du site

mvn clean site

et un nouvel item apparait dans le menu dirigeant vers votre nouvelle page.

Ajout d'une nouvelle page

Ajout d'une nouvelle page

J’en ai profité pour vous montrer les différentes fonctionnalités d’ATP (tableaux, liste, titres, formatage de texte…)


Internationaliser son site facilement

Nous allons ajouter des liens pour changer la langue.

Dans site.xml :

<project name='Maven'>
  [...]
  <body>
    [...]
    <menu name='Other languages'>
      <item name='Français' href='/fr/index.html'/> 
    </menu>
  </body>
</project>

Dans site_fr.xml :

<project name='Maven'>
  [...]
  <body>
    [...]
    <menu name='Autres langues'>
      <item name='English' href='../index.html'/> 
    </menu>
  </body>
</project>
Internationalisation du site

Internationalisation du site

Par défaut, l’anglais est la langue principale. Pour modifier cela, il faut modifier le POM du projet.

fr

Le français est la seule langue disponible.

en,fr

L’anglais est la langue par défaut, le français est disponible.

fr,en

Le français est la langue par défaut, l’anglais est disponible.

fr,en,es,de

Le site est multilingue, disponible également en espagnol et en allemand.


Ajouter les rapports par défaut

Comme on peut le constater, il est très simple d’ajouter des pages et de modifier la structure du site.

Vous remarquerez que les différents rapports Maven par défaut (informations générales sur le projet) ne sont pas inclus dans le site.

Il vous suffit d’ajouter la balise :

<project>
  [...]
  <body>
    [...]
    <menu ref='reports'/>
  </body>
</project>
Les rapports par défaut

Les rapports par défaut


Autres modifications du contenu

Il existe d’autres possibilités de personnalisation en modifiant uniquement le descripteur :

  • Ajouter des liens dans la bannière;
  • Changer le titre de la fenêtre;
  • Modifier la position de la date de publication;
  • Modifier le logo « Built by Maven », les images dans la bannière…;
  • Afficher la version du logiciel (dans notre cas, la 1.0-SNAPSHOT);
  • etc.

Vous pouvez consulter toutes les informations sur le descripteur de site.


Changer le design du site avec des « skins »

Il est également possible de changer l’interface graphique générale du site.

Pour cela, il suffit (une fois de plus) de modifier le descripteur du projet (pas le POM) en ajoutant :

<project>
  [...]
  <skin>
    <groupId>org.apache.maven.skins</groupId>
    <artifactId>maven-stylus-skin</artifactId>
    <version>1.2</version>
  </skin>
  [...]
</project>

Malheureusement, peu de thèmes sont disponibles. A l’heure où j’écris cet article, 3 thèmes officiels seulement existent.

  • maven-classic-skin (ancien thème, version 1.0);
  • maven-default-skin (thème par défaut, version 1.0);
  • maven-stylus-skin (thème utilisé par le site officiel, version 1.2).
Classic-site-skin

Classic-site-skin

Default-site-skin

Default-site-skin

Stylus-site-skin

Stylus-site-skin

En recherchant un peu sur internet, vous réussirez à en trouver quelques autres.

En plus du contenu, il est tout à fait possible d’avoir des skins différents pour les versions française et anglaise (car 2 descripteurs de site différent).


Aller plus loin dans la personnalisation

Pour obtenir un site à votre image, il est possible d’aller encore plus loin en modifiant soit même le design.

Il est possible d’ajouter vos propres images, vos fichiers de style CSS respectant votre charte graphique, vos liens spécifiques sur le projet… et ainsi à ne pas vous limiter aux fonctions de base.

Ensuite et si le résultat vous convient, vous pourrez packager vos modifications et les rendre disponibles sous forme de skin.

Voici une sélection de designs que j’ai pu apprécier. Il faut dire que le résultat est plutôt réussi pour certains. On en oublierait presque qu’il s’agit d’un Maven Site…

Cecilia-site-skin Embedchat-site-skin
Fluido-site-skin Wicket-site-skin
James-site-skin Mydoggy-site-skin
Lift-site-skin Netapsys-site-skin


Ressources

Le site officiel du plugin « Maven-site » :

http://maven.apache.org/plugins/maven-site-plugin/

Les skins officiels :

http://repo1.maven.org/maven2/org/apache/maven/skins/

La référence pour le langage ATP :

http://maven.apache.org/doxia/references/apt-format.html

La référence pour le langage FML :

http://maven.apache.org/doxia/references/fml-format.html

Articles similaires

WordPress qTranslateRendre son site WordPress multilingue avec qTranslate printerOptimiser votre site web pour l’impression en 5 minutes Progress barBarre de progression sur des dates avec JQuery web-analyticsMesurer et analyser l’audience de votre site avec Matomo
Commentaires
Pas de Commentaires »
Catégories
Programmation agile
Tags
java, maven, maven-site
Flux rss des commentaires Flux rss des commentaires
Page 1 sur 11
Télécharger l'app CarmaBlog

Articles les plus vus

  • Changer la langue de Firefox - 114 302 vues
  • Réaliser un sondage en ligne avec Google Forms / Drive / Docs - 60 260 vues
  • Personnaliser Gnome 3 (Shell) - 28 279 vues
  • FAQ – Sondage en ligne avec Google Forms / Drive / Docs - 26 258 vues
  • Java EE & CDI vs. Spring - 14 265 vues
  • La signification d’URL, URI et URN - 14 093 vues
  • Comparaison NoSQL: Couchbase et MongoDB - 13 083 vues
  • Open Street Map, une meilleure carte que Google Maps? - 12 969 vues
  • Firefox Nightly, Aurora, Beta, Desktop, Mobile, ESR & Co. - 12 481 vues
  • Extensions WordPress de CarmaBlog - 11 111 vues

Commentaires récents

  • User AvatarFabian Piau Je ne peux pas vraiment répondre. Techniquement, il est possible... – FAQ - Sondage en ligne avec Google Forms / Drive / Docs – Il y a 7 mois et 4 semaines
  • User AvatarTinoubi Bonjour J'ai un souci j'ai répondu hâtivement a une enquête... – FAQ - Sondage en ligne avec Google Forms / Drive / Docs – Il y a 8 mois et 1 jour
  • User AvatarLaurent Ah oui effectivement.... cette configuration n'est disponible que si la... – FAQ - Sondage en ligne avec Google Forms / Drive / Docs – Il y a 8 mois et 1 semaine
  • User AvatarFabian Piau Oui, vous pouvez ajouter une validation sur la question. A... – FAQ - Sondage en ligne avec Google Forms / Drive / Docs – Il y a 8 mois et 1 semaine
  • User AvatarLaurent Je découvre... article vraiment intéressant... Merci J'ai une question concernant... – FAQ - Sondage en ligne avec Google Forms / Drive / Docs – Il y a 8 mois et 1 semaine

Twitter

Mes Tweets

Articles récents

  • Une migration Java 11 réussie - Il y a 1 mois et 3 semaines
  • Conseils pour sécuriser votre site WordPress - Il y a 4 mois et 1 semaine
  • Devoxx UK 2018 – Jour 2 - Il y a 8 mois et 2 semaines
  • Devoxx UK 2018 – Jour 1 - Il y a 9 mois et 2 jours
  • TransferWise, Revolut et Monzo, une petite révolution pour les voyageurs et les expats - Il y a 1 an et 1 mois
  • Autocomplétion pour Git - Il y a 1 an et 9 mois
  • Swagger, la documentation API automatisée - Il y a 1 an et 11 mois
  • Architecture Microservices – Les bonnes pratiques - Il y a 2 ans et 4 mois
  • FAQ – Sondage en ligne avec Google Forms / Drive / Docs - Il y a 2 ans et 9 mois
  • QCon London 2016 – Projet Jigsaw dans JDK 9 – La modularité arrive sur Java - Il y a 2 ans et 10 mois
  • QCon London 2016 – Spring Framework 5 – Preview et Roadmap - Il y a 2 ans et 11 mois
  • Les meilleurs outils gratuits pour tester et optimiser une application ou un site web - Il y a 3 ans et 3 mois
  • Faut-il se méfier de Google? - Il y a 3 ans et 8 mois
  • Création de tweets à partir d’un flux RSS - Il y a 4 ans et 3 jours
  • Booster votre blog WordPress: W3 Total Cache + CloudFlare - Il y a 4 ans et 1 mois

Langue

  • Français
  • English

Flux RSS

  • RSS Feed RSS - Articles
  • RSS Feed RSS - Commentaires

Suivez-moi!

Suivez-moi sur Twitter
Suivez-moi sur Linkedin
Suivez-moi sur Stackoverflow
Suivez-moi sur Google
Suivez-moi sur Rss
Link to my Contact

Abonnement email

Saisissez votre adresse email pour être informé des nouveaux articles.

Étiquettes

.net agile agilité android app stores astuce bash blog bonnes pratiques cache chrome cloud conférence css eclipse extreme programming firefox formation fosdem google hibernate intégration continue java javascript jquery jug microsoft mobilité informatique mongodb nantes nosql outil partage performance plugin script société sondage spring tdd test test unitaire ubuntu windows wordpress

Liens

  • Agile Nantes
  • Blog Ippon Technologies
  • Blog Netapsys
  • Blog Xebia France
  • Blog Zenika
  • CommitStrip
  • Coursera
  • Developpef
  • Le Touilleur Express
  • Les Cast Codeurs Podcast
  • new Blog( perso );
  • OCTO talks !
  • Open2Study
  • The Coder's Breakfast

Catégories

  • Evénement (13)
  • Linux (3)
  • Management (7)
  • Programmation agile (26)
  • Technologie (44)

Archives

  • décembre 2018 (1)
  • octobre 2018 (1)
  • juin 2018 (1)
  • mai 2018 (1)
  • janvier 2018 (1)
  • mai 2017 (1)
  • mars 2017 (1)
  • octobre 2016 (1)
  • avril 2016 (2)
  • mars 2016 (1)
  • novembre 2015 (1)
  • mai 2015 (1)
  • février 2015 (1)
  • décembre 2014 (1)
  • novembre 2014 (1)
  • septembre 2014 (2)
  • août 2014 (1)
  • juillet 2014 (2)
  • juin 2014 (1)
  • avril 2014 (1)
  • mars 2014 (1)
  • février 2014 (2)
  • janvier 2014 (1)
  • décembre 2013 (1)
  • novembre 2013 (1)
  • octobre 2013 (3)
  • septembre 2013 (5)
  • juillet 2013 (1)
  • juin 2013 (1)
  • mai 2013 (1)
  • avril 2013 (1)
  • mars 2013 (2)
  • février 2013 (1)
  • janvier 2013 (2)
  • décembre 2012 (2)
  • octobre 2012 (1)
  • septembre 2012 (1)
  • juillet 2012 (1)
  • mai 2012 (1)
  • avril 2012 (1)
  • mars 2012 (1)
  • février 2012 (1)
  • janvier 2012 (2)
  • décembre 2011 (1)
  • novembre 2011 (2)
  • octobre 2011 (2)
  • septembre 2011 (1)
  • juillet 2011 (1)
  • juin 2011 (2)
  • avril 2011 (1)
  • mars 2011 (1)
  • février 2011 (1)
  • janvier 2011 (2)
  • novembre 2010 (2)
  • septembre 2010 (1)
  • août 2010 (1)
  • juillet 2010 (1)
  • juin 2010 (1)
  • mai 2010 (1)
  • avril 2010 (1)
  • mars 2010 (1)
  • février 2010 (1)
  • décembre 2009 (1)
  • novembre 2009 (1)
  • octobre 2009 (2)
  • septembre 2009 (2)
  • août 2009 (3)
  • juillet 2009 (1)
  • juin 2009 (2)
Suivez-moi sur Twitter
Suivez-moi sur Linkedin
Suivez-moi sur Stackoverflow
Suivez-moi sur Google
Suivez-moi sur Rss
Link to my Contact
rss Flux rss des commentaires powered by Wordpress get firefox
Fabian Piau | Copyright © 2009 - 2019
Tous droits réservés | Haut ↑