Author: tchemit Date: 2010-10-03 15:11:53 +0200 (Sun, 03 Oct 2010) New Revision: 988 Url: http://nuiton.org/repositories/revision/mavenpom/988 Log: Evolution #908: Improve documentation Removed: trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/profiles.apt trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/properties.apt trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/en/apt/profiles.apt trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/en/apt/properties.apt Modified: trunk/mavenpom4labs/src/site/apt/index.apt trunk/mavenpom4labs/src/site/en/apt/index.apt trunk/mavenpom4labs/src/site/site_en.xml trunk/mavenpom4labs/src/site/site_fr.xml trunk/mavenpom4redmine/mavenpom4redmineAndCentral/pom.xml trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/index.apt trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/minimalpom.apt trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/release.apt trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/en/apt/index.apt trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/en/apt/minimalpom.apt trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/en/apt/release.apt trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/site_en.xml trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/site_fr.xml trunk/mavenpom4redmine/src/site/apt/index.apt trunk/mavenpom4redmine/src/site/apt/release.apt trunk/mavenpom4redmine/src/site/en/apt/index.apt trunk/mavenpom4redmine/src/site/site_en.xml trunk/mavenpom4redmine/src/site/site_fr.xml trunk/pom.xml trunk/src/site/apt/index.apt trunk/src/site/en/apt/index.apt trunk/src/site/site_en.xml trunk/src/site/site_fr.xml Modified: trunk/mavenpom4labs/src/site/apt/index.apt =================================================================== --- trunk/mavenpom4labs/src/site/apt/index.apt 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/mavenpom4labs/src/site/apt/index.apt 2010-10-03 13:11:53 UTC (rev 988) @@ -83,6 +83,15 @@ Voir la page des {{{./properties.html}propriétés}}. + Voir la page des {{{../../properties.html}propriétés}} de <mavenpom>. + + +Les profiles + + Voir la page des {{{./profiles.html}profiles}} du pom. + + Voir la page des {{{../../profiles.html}profiles}} de <mavenpom>. + Vérification de conformité On effectue sur le pom des contrôles de conformités via le plugin @@ -100,10 +109,6 @@ LICENSE.txt -------------------------------------------------------------------------------- -Les profiles - - Voir la page des {{{./profiles.html}profiles}}. - Configuration des plugins Pour connaître la liste des plugins gérés par <mavenpom4labs>, veuillez vous Modified: trunk/mavenpom4labs/src/site/en/apt/index.apt =================================================================== --- trunk/mavenpom4labs/src/site/en/apt/index.apt 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/mavenpom4labs/src/site/en/apt/index.apt 2010-10-03 13:11:53 UTC (rev 988) @@ -37,8 +37,16 @@ Available properties - See the {{{properties.html}properties}} page. + See the {{{properties.html}properties' page}} of this pom. + See the {{{../../en/properties.html}properties' page}} of <mavenpom>. + +Available profiles + + See the {{{profiles.html}profiles' page}} of this pom. + + See the {{{../../en/profiles.html}profiles' page}} of <mavenpom>. + Conformity checks Some conformity checks are done to make sure we have all necessary files. @@ -55,6 +63,3 @@ LICENSE.txt -------------------------------------------------------------------------------- -Available profiles - - See the {{{profiles.html}profiles}} page. Modified: trunk/mavenpom4labs/src/site/site_en.xml =================================================================== --- trunk/mavenpom4labs/src/site/site_en.xml 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/mavenpom4labs/src/site/site_en.xml 2010-10-03 13:11:53 UTC (rev 988) @@ -24,40 +24,40 @@ --> <project name="${project.name}"> - <bannerLeft> - <name>${project.name}</name> - <href>index.html</href> - </bannerLeft> + <bannerLeft> + <name>${project.name}</name> + <href>index.html</href> + </bannerLeft> - <body> + <body> - <breadcrumbs> - <item name="${project.name}" - href="http://maven-site.nuiton.org/mavenpom/mavenpom4labs/index.html"/> - </breadcrumbs> + <breadcrumbs> + <item name="${project.name}" + href="http://maven-site.nuiton.org/mavenpom/mavenpom4labs/index.html"/> + </breadcrumbs> - <!-- TC-20100117 : ne fonctionne pas sur une langue non principale --> - <!--<menu ref="parent"/>--> - <menu name="Parent Projet"> - <item name="Mavenpom" href="../../en/index.html"/> - </menu> + <!-- TC-20100117 : ne fonctionne pas sur une langue non principale --> + <!--<menu ref="parent"/>--> + <menu name="Parent Projet"> + <item name="Mavenpom" href="../../en/index.html"/> + </menu> - <menu name="Inside mavenpom4labs"> - <item name="Home" href="/index.html"/> - <item name="Properties" href="properties.html"/> - <item name="Profiles" href="profiles.html"/> - </menu> + <menu name="Inside mavenpom4labs"> + <item name="Home" href="/index.html"/> + <item name="Properties" href="properties.html"/> + <item name="Profiles" href="profiles.html"/> + </menu> - <menu name="Use mavenpom4labs"> - <item name="Minimal pom" href="minimalpom.html"/> - <item name="Make a release" href="release.html"/> - </menu> + <menu name="Use mavenpom4labs"> + <item name="Minimal pom" href="minimalpom.html"/> + <item name="Make a release" href="release.html"/> + </menu> - <menu name="Divers"> - <item name="Version française" href="/../index.html"/> - </menu> + <menu name="Divers"> + <item name="Version française" href="/../index.html"/> + </menu> - <menu ref="reports"/> + <menu ref="reports"/> - </body> + </body> </project> Modified: trunk/mavenpom4labs/src/site/site_fr.xml =================================================================== --- trunk/mavenpom4labs/src/site/site_fr.xml 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/mavenpom4labs/src/site/site_fr.xml 2010-10-03 13:11:53 UTC (rev 988) @@ -24,36 +24,36 @@ --> <project name="${project.name}"> - <bannerLeft> - <name>${project.name}</name> - <href>index.html</href> - </bannerLeft> + <bannerLeft> + <name>${project.name}</name> + <href>index.html</href> + </bannerLeft> - <body> + <body> - <breadcrumbs> - <item name="${project.name}" - href="http://maven-site.nuiton.org/mavenpom/mavenpom4labs/index.html"/> - </breadcrumbs> + <breadcrumbs> + <item name="${project.name}" + href="http://maven-site.nuiton.org/mavenpom/mavenpom4labs/index.html"/> + </breadcrumbs> - <menu ref="parent"/> + <menu ref="parent"/> - <menu name="Dissection de mavenpom4labs"> - <item name="Accueil" href="index.html"/> - <item name="Propriétés" href="properties.html"/> - <item name="Profiles" href="profiles.html"/> - </menu> + <menu name="Dissection de mavenpom4labs"> + <item name="Accueil" href="index.html"/> + <item name="Propriétés" href="properties.html"/> + <item name="Profiles" href="profiles.html"/> + </menu> - <menu name="Utiliser mavenpom4labs"> - <item name="Pom minimal" href="minimalpom.html"/> - <item name="Faire une release" href="release.html"/> - </menu> + <menu name="Utiliser mavenpom4labs"> + <item name="Pom minimal" href="minimalpom.html"/> + <item name="Faire une release" href="release.html"/> + </menu> - <!--menu name="Divers"> - <item name="English version" href="/en/index.html"/> - </menu--> + <!--menu name="Divers"> + <item name="English version" href="/en/index.html"/> + </menu--> - <menu ref="reports"/> + <menu ref="reports"/> - </body> + </body> </project> Modified: trunk/mavenpom4redmine/mavenpom4redmineAndCentral/pom.xml =================================================================== --- trunk/mavenpom4redmine/mavenpom4redmineAndCentral/pom.xml 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/mavenpom4redmine/mavenpom4redmineAndCentral/pom.xml 2010-10-03 13:11:53 UTC (rev 988) @@ -62,10 +62,6 @@ <inceptionYear>2010</inceptionYear> <!-- ************************************************************* --> - <!-- *** Build Environment ************************************** --> - <!-- ************************************************************* --> - - <!-- ************************************************************* --> <!-- *** Build Settings ****************************************** --> <!-- ************************************************************* --> @@ -83,6 +79,9 @@ <!-- deploy releases on central-releases repository --> <release.repository>${central.release.repository}</release.repository> + <!-- release repository url (to be used in site.xml) --> + <repository.home.url>${central.release.home.url}</repository.home.url> + </properties> <packaging>pom</packaging> @@ -117,12 +116,11 @@ <properties> <!-- force to use correct site location --> <site.repository> - ${our.site.repository}/mavenpom/mavenpom4redmineAndCentral + ${our.site.repository}/mavenpom/mavenpom4redmine/mavenpom4redmineAndCentral </site.repository> </properties> </profile> - </profiles> </project> Modified: trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/index.apt =================================================================== --- trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/index.apt 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/index.apt 2010-10-03 13:11:53 UTC (rev 988) @@ -24,40 +24,23 @@ ~~~ ------ -Mavenpom4redmine +Mavenpom4redmineAndCentral ------ ------ -2009-08-22 +2010-10-03 ------ Présentation Le projet <mavenpom4redmine> est un pom de type <Corporate> dont héritent - tous les projets {{{http://www.nuiton.org}nuiton}} et - {{{http://www.chorem.org}chorem}}. + tous les projets {{{http://www.nuiton.org}nuiton}} qui sont synchronisés sur - Il étend <<mavenpom>> et ajoute les profiles de release pour redmine. + Il étend <<mavenpom4redmine>> et ajoute la configuration pour synchroniser + sur central. -* Ce qui est géré par mavenpom4redmine +* Ce qui est géré par mavenpom4redmine4Central - Ce pom définit tout ce qui concerne l'environnement, il vous est donc - inutile de les définir dans vos poms, à savoir : - - * intégration continue (hudson) - - * environnement de distribution (deploiement des artifacts et site) - - * gestion des 'issues' (sur redmine) - - * les profiles de release - - * la license LGPL v3 - - * les listes de diffusion <commits>, <devel> et <users> - - * les version des plugins externes - - * la configuration des rapports du site + Tout ce qui est définit par le <<mavenpom4redmine>>. * Ce que vous devez définir dans votre pom @@ -77,37 +60,20 @@ Les propriétés - Voir la page des {{{./properties.html}propriétés}} du pom. + Voir la page des {{{../properties.html}propriétés}} de <mavenpom4redmine>. - Voir la page des {{{../properties.html}propriétés}} du <mavenpom>. + Voir la page des {{{../../properties.html}propriétés}} de <mavenpom>. -Vérification de conformité - - On effectue sur le pom des contrôles de conformités via le plugin - maven-enforcer-plugin. - -* propriétés obligatoires - - Aucune a l'heure actuelle - -* Fichiers obligatoires - --------------------------------------------------------------------------------- -README.txt -changelog.txt -LICENSE.txt --------------------------------------------------------------------------------- - Les profiles - Voir la page des {{{./profiles.html}profiles}}. + Voir la page des {{{../../en/profiles.html}profiles}} de <mavenpom4redmine>. -Configuration des plugins + Voir la page des {{{../../../en/profiles.html}profiles}} de <mavenpom>. - Pour connaître la liste des plugins gérés par <mavenpom4redmine>, veuillez - vous rendre sur la page de - {{{./plugin-management.html}configuration des plugins}}. +Vérification de conformité - Pour mieux comprendre comment utiliser les plugins (et gérer les versions des - plugins) une explication est donnée dans <mavenpom> sur la - {{{../index.html#Configuration des plugins}page suivante}}. + On effectue sur le pom les même contrôles de conformités que + <mavenpom4redmine>. + + On vérifie aussi que tous les artifacts sont bien dans le dépôt central en + activant le profile <central-safe> lors d'un release. Modified: trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/minimalpom.apt =================================================================== --- trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/minimalpom.apt 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/minimalpom.apt 2010-10-03 13:11:53 UTC (rev 988) @@ -24,15 +24,15 @@ ~~~ ------ -Mavenpom4redmine usage +Pom minimale avec Mavenpom4redmineAndCentral ------ ------ -2010-01-22 +2010-10-03 ------ Préambule - Cette page décrit un pom minimal qui utilise correctement <<mavenpom4redmine>>. + Cette page décrit un pom minimal qui utilise correctement <<mavenpom4redmineAndCentral>>. Le pom @@ -51,7 +51,7 @@ <parent> <groupId>org.nuiton</groupId> - <artifactId>mavenpom4redmine</artifactId> + <artifactId>mavenpom4redmineAndCentral</artifactId> <version>2.0.2</version> </parent> Deleted: trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/profiles.apt =================================================================== --- trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/profiles.apt 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/profiles.apt 2010-10-03 13:11:53 UTC (rev 988) @@ -1,137 +0,0 @@ -~~~ -~~ #%L -~~ Mavenpom4redmine -~~ ~~ -~~ $Id$ -~~ $HeadURL$ -~~ %% -~~ Copyright (C) 2010 CodeLutin -~~ %% -~~ This program is free software: you can redistribute it and/or modify -~~ it under the terms of the GNU Lesser General Public License as -~~ published by the Free Software Foundation, either version 3 of the -~~ License, or (at your option) any later version. -~~ -~~ This program is distributed in the hope that it will be useful, -~~ but WITHOUT ANY WARRANTY; without even the implied warranty of -~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -~~ GNU General Lesser Public License for more details. -~~ -~~ You should have received a copy of the GNU General Lesser Public -~~ License along with this program. If not, see -~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. -~~ #L% -~~~ - ------- -Profiles disponibles dans mavenpom4redmine ------- ------- -2009-10-11 ------- - -Abstract - - Cette page décrit l'ensemble des profiles ajoutés (ou surchargés) dans - mavenpom4redmine et disponibles pour tous les projets qui héritent de - mavenpom. - - Reportez vous a cette page pour avoir la liste des profiles de - {{{../profiles.html} mavenpom}}. - -Vue d'ensemble - -*----------------------------------+------------------------------+ -| <<property>> | <<Activation property>> | -*----------------------------------+------------------------------+ -| {{redmine-build-release-profile}}| <<performRelease>> | -*----------------------------------+------------------------------+ -| {{redmine-pre-release-profile}} | <<performRedminePreRelease>> | -*----------------------------------+------------------------------+ -| {{redmine-release-profile}} | <<performRedmineRelease>> | -*----------------------------------+------------------------------+ -| {{redmine-next-version-profile}} | <<redmineNextVersion>> | -*----------------------------------+------------------------------+ - -Détails - - -* {redmine-build-release-profile} - - Ce profile permet pendant la release classique de collecter les fichiers à - publier et de générer le changelog. Il est activable via la propriété - <<performRelease>>. - - Dans ce profile, on lance la collecte des artifacts qui seront déployés - sur le dépôt maven. La liste de ces artifacts sont conservés dans le fichier - défini par la propriété <<redmine.collectedArtifacts>>. - - A noter, que dans le cadre des projets multi-modules, on ne conserve qu'un - seul fichier situé dans le module du pom. - - Dans ce profile, on lance la collecte des fichiers qui seront déployés sur - le serveur redmine. La liste de ces fichiers sont conservés dans le fichier - défini par la propriété <<redmine.collectedAttachments>>. - - A noter, que dans le cadre des projets multi-modules, on ne conserve qu'un - seul fichier situé dans le module du pom. - -* {redmine-pre-release-profile} - - Ce profile permet suite à une release de publier la release sur redmine et est - activable via la propriété <<performRedminePreRelease>>. - - Il faut l'utiliser sur le projet releasé, cela déployera les fichiers attachés - à la release sur redmine et génèrera les contenus d'annonces ici : - --------------------------------------------------------------------------------- -target/generate-sources/announcement/release-news-announcement.vm -target/generate-sources/announcement/release-email-announcement.vm --------------------------------------------------------------------------------- - - Un paramètre supplémentaire <<-DdryRun=false>> est à passer pour confirmer - l'exécution des commandes sur le serveur redmine. - --------------------------------------------------------------------------------- -cd target/checkout; mvn -DperformRedminePreRelease -N --------------------------------------------------------------------------------- - - Une fois que tout à l'air ok : - --------------------------------------------------------------------------------- -cd target/checkout; mvn -DperformRedminePreRelease -N -DdryRun=false --------------------------------------------------------------------------------- - - -* {redmine-release-profile} - - Ce profile permet suite à une release de publier la release sur redmine et est - activable via la propriété <<performRedmineRelease>>. - - Il faut l'utiliser sur le projet releasé (et pas le projet en SNAPSHOT). - --------------------------------------------------------------------------------- -cd target/checkout; mvn -DperformRedmineRelease -N --------------------------------------------------------------------------------- - - Une fois que tout à l'air ok : - --------------------------------------------------------------------------------- -cd target/checkout; mvn -DperformRedmineRelease -N -DdryRun=false --------------------------------------------------------------------------------- - -* {redmine-next-version-profile} - - Ce profile permet de créer la version sur le serveur redmine correspondant à - la version (non snapshot) du pom, est activable par la propriété - <<redmineNextVersion>>. - --------------------------------------------------------------------------------- -mvn -Predmine-next-version-profile -N -Dredmine.previousVersionName=XX --------------------------------------------------------------------------------- - - ou - --------------------------------------------------------------------------------- -mvn -DredmineNextVersion -N -Dredmine.previousVersionName=XX --------------------------------------------------------------------------------- Deleted: trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/properties.apt =================================================================== --- trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/properties.apt 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/properties.apt 2010-10-03 13:11:53 UTC (rev 988) @@ -1,217 +0,0 @@ -~~~ -~~ #%L -~~ Mavenpom4redmine -~~ ~~ -~~ $Id$ -~~ $HeadURL$ -~~ %% -~~ Copyright (C) 2010 CodeLutin -~~ %% -~~ This program is free software: you can redistribute it and/or modify -~~ it under the terms of the GNU Lesser General Public License as -~~ published by the Free Software Foundation, either version 3 of the -~~ License, or (at your option) any later version. -~~ -~~ This program is distributed in the hope that it will be useful, -~~ but WITHOUT ANY WARRANTY; without even the implied warranty of -~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -~~ GNU General Lesser Public License for more details. -~~ -~~ You should have received a copy of the GNU General Lesser Public -~~ License along with this program. If not, see -~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. -~~ #L% -~~~ - ------- -Propriétés disponibles dans mavenpom4redmine ------- ------- -2009-10-11 ------- - -Abstract - - Cette décrit l'ensemble des propriétés ajoutés dans mavenpom et disponibles - pour tous les projets qui héritent de <mavenpom4redmine>. - - Les propriétés définies dans <mavenpom> sont accéssibles {{{../properties.html}ici}} - -Vue d'ensemble - -*----------------------------------------------+--------------------------------------------------------+ -| <<property>> | <<Default- value>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{platform}} | <<nuiton.org>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.url}} | <<http://www.${platform}>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.serverId}} | <<redmine-${platform}>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.projectId}} | <<${projectId}>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.xmlPath}} | <<${maven.gen.dir}/changes/changes.xml>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.issueLinkTemplate}} | <<${redmine.url}/issues/show/%ISSUE%>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.versionLinkTemplate}} | <<${redmine.url}/versions/show/%VERSION%>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.attachmentLinkTemplate}} | <<${redmine.url}/attachments/download/%FILE%>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.collectedAttachments}} | <<target/collect-attachments.txt>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.collectedArtifacts}} | <<target/collect-artifacts.txt>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.releaseFiles}} | - | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.libReleaseFiles}} | target/${project.artifactId}-${project.version}-deps.zip,target/${project.artifactId}-${project.version}-full.zip| -*----------------------------------------------+--------------------------------------------------------+ - -Détails - -* {platform} - - La plateforme redmine utilisée parmi : - --------------------------------------------------------------------------------- -nuiton.org -chorem.org --------------------------------------------------------------------------------- - -* {redmine.url} - - L'url du serveur redmine. - --------------------------------------------------------------------------------- -http://www.${platform} --------------------------------------------------------------------------------- - - <Note:> en théorie, cette propriété ne doit pas être modifiée. - -* {redmine.serverId} - - L'id du serveur (dans votre <<settings.xml>>) pour se logguer sur redmine. - --------------------------------------------------------------------------------- -redmine-${platform} --------------------------------------------------------------------------------- - - Vous devez donc avoir deux serveurs définis : - --------------------------------------------------------------------------------- -redmine-nuiton.org -redmine-chorem.org --------------------------------------------------------------------------------- - - afin de pouvoir faire des releases sur <<nuiton.org>> et <<chorem.org>>. - - <Note:> en théorie, cette propriété ne doit pas être modifiée. - -* {redmine.projectId} - - L'id du projet redmine. Par défaut, il s'agit de la propriété <<projectId>>. - --------------------------------------------------------------------------------- -${projectId} --------------------------------------------------------------------------------- - - <Note:> en théorie, cette propriété ne doit pas être modifiée. - -* {redmine.xmlPath} - - Le chemin du fichier des 'issues' généré. - --------------------------------------------------------------------------------- -${maven.gen.dir}/changes/changes.xml --------------------------------------------------------------------------------- - - Le contenu de ce fichier xml, sera utilisé par le plugin - <<maven-change-plugin>> pour générer le rapport des changements. - - <Note:> en théorie, cette propriété ne doit pas être modifiée. - -* {redmine.issueLinkTemplate} - - L'url des issues sur le serveur redmine. Le pattern <<%ISSUE%>> sera remplacé - dans les rapports par l'id de l'issue. - --------------------------------------------------------------------------------- -${redmine.url}/issues/show/%ISSUE% --------------------------------------------------------------------------------- - - <Note:> en théorie, cette propriété ne doit pas être modifiée. - -* {redmine.versionLinkTemplate} - - L'url des version sur le serveur redmine. Le pattern <<%VERSION%>> sera - remplacé dans les rapport par l'id de la version. - --------------------------------------------------------------------------------- -${redmine.url}/versions/show/%VERSION% --------------------------------------------------------------------------------- - - <Note:> en théorie, cette propriété ne doit pas être modifiée. - -* {redmine.attachmentLinkTemplate} - - L'url des fichiers sur le serveur redmine. Le pattern <<%FILE%>> sera - remplacé dans les rapport par l'id du fichier. - --------------------------------------------------------------------------------- -${redmine.url}/attachments/download/%FILE% --------------------------------------------------------------------------------- - - <Note:> en théorie, cette propriété ne doit pas être modifiée. - -* {redmine.collectedAttachments} - - Le fichier qui contient la liste des fichiers à envoyer sur redmine lors d'une - nouvelle release. - --------------------------------------------------------------------------------- -target/collect-attachments.txt --------------------------------------------------------------------------------- - - Le contenu de ce fichier contient une ligne par fichier et est rempli pendant - la réalisation de la release (<mvn release:perform>) et ceci grâce au profile - <redmine-build-release-profile>. - - <Note:> en théorie, cette propriété ne doit pas être modifiée. - -* {redmine.collectedArtifacts} - - Le fichier qui contient la liste des fichiers à deployer sur le dépôt maven. - --------------------------------------------------------------------------------- -target/collect-artifacts.txt --------------------------------------------------------------------------------- - - Le contenu de ce fichier contient une ligne par fichier et est rempli pendant - la réalisation de la release (<mvn release:perform>) et ceci grâce au profile - <redmine-build-release-profile>. - - <Note:> en théorie, cette propriété ne doit pas être modifiée. - -* {redmine.releaseFiles} - - La liste des fichiers à envoyer sur redmine lors d'une nouvelle release - (séparés par des virgules). - - Mettez dans cette propriété la liste des fichiers que vous voulez déployer - sur redmine lors d'une release. - - Par défaut, vide (i.e rien à deployer sur redmine pour le module courant). - -* {redmine.libReleaseFiles} - - La définition des fichiers à ajouter à une release pour un module de type - <<jar>> qui générè les deux zip deps et full. - - On remplit dans ce cas la propriété <<redmine.releaseFiles>> avec cette - propriété : - --------------------------------------------------------------------------------- -<redmine.releaseFiles>${redmine.libReleaseFiles}</redmine.releaseFiles> --------------------------------------------------------------------------------- - - <Note:> en théorie, cette propriété ne doit pas être modifiée. Modified: trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/release.apt =================================================================== --- trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/release.apt 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/release.apt 2010-10-03 13:11:53 UTC (rev 988) @@ -27,98 +27,14 @@ Effectuer une release ------ ------ -2010-01-10 +2010-10-03 ------ Abstract Cette page décrit la méthode pour effectuer une release d'un projet héritant - de <<mavenpom4redmine>>. + de <<mavenpom4redmineAndCentral>>. - L'opération se déroule en 4 étapes. + La procédure est identique à celle de <<mavenpom4redmine>>. -Etape 1 - - Effectuer une release normal - --------------------------------------------------------------------------------- -mvn release:prepare -mvn release:perform --------------------------------------------------------------------------------- - -Etape 2 - - Dans cette phase, on va : - - * Deployement des fichiers vers redmine - - * Créer les annonces de release - - [] - - On travaille sur la version utilisée pour faire la release. - --------------------------------------------------------------------------------- -cd target/checkout --------------------------------------------------------------------------------- - - La commande suivante simule (sans rien déployer) - --------------------------------------------------------------------------------- -mvn -DperformRedminePreRelease -N [-Pcentral-safe] --------------------------------------------------------------------------------- - - Si aucune erreur lors de l'execution, on lance la commande suivante - --------------------------------------------------------------------------------- -mvn -DperformRedminePreRelease -DdryRun=false -N [-Pcentral-safe] --------------------------------------------------------------------------------- - - A ce stade, les annonces ont été créées ici : - --------------------------------------------------------------------------------- -target/generated-sources/announcement/release-news-announcement.vm -target/generated-sources/announcement/release-email-announcement.vm --------------------------------------------------------------------------------- - - Pour les projets central safe, on doit ajouter le <<-Pcentral-safe>>. - -Etape 3 - - On finalise la release après avoir modifié les annonces (si nécessaire) : - - * Mise à jour de la version sur redmine (on la clôture) - - * Envoie de l'email d'annonce de release - - * Publication de l'annonce de release sur redmine - - [] - - La commande suivante simule (sans rien publier) : - --------------------------------------------------------------------------------- -mvn -DperformRedmineRelease -N --------------------------------------------------------------------------------- - - Si aucune erreur, on peut lancer la commande réelle - --------------------------------------------------------------------------------- -mvn -DperformRedmineRelease -DdryRun=false -N --------------------------------------------------------------------------------- - -Etape 4 - - On revient sur le projet du trunk - --------------------------------------------------------------------------------- -cd ../../ --------------------------------------------------------------------------------- - - On crée la nouvelle version sur redmine (où <XXX> est la version qui vient - d'être releasée) et on déplace les demandes non fermées vers la nouvelle - version. - --------------------------------------------------------------------------------- -mvn -DredmineNextVersion -Dredmine.previousVersionName=XXX -N --------------------------------------------------------------------------------- + Reportez vous à la {{{../release.html}page de release de mavenpom4redmine}}. \ No newline at end of file Modified: trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/en/apt/index.apt =================================================================== --- trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/en/apt/index.apt 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/en/apt/index.apt 2010-10-03 13:11:53 UTC (rev 988) @@ -24,43 +24,39 @@ ~~~ ------ -Maven nuiton pom +Mavenpom4redmineAndCentral ------ ------ -2009-09-01 +2010-10-03 ------ Abstract - Corporate pom of all {{{http://www.nuiton.org}nuiton}} and - {{{http://www.chorem.org}chorem}} projects. + Corporate pom of all {{{http://www.nuiton.org}nuiton}} which are synchronized + on {{{http://repo1.maven.org/maven2/}Maven central repository}}. - the pom heritates from <<mavenpom>> and add full support to make release on redmine server. + The pom heritates from <<mavenpom4redmine>> and add full support to deploy on + central repository. Available properties - See the {{{properties.html}properties}} page. + See the {{{../../en/properties.html}proprerties' page}} of <mavenpom4redmine>. -Conformity checks + See the {{{../../../en/properties.html}proprerties' page}} of <mavenpom>. - Some conformity checks are done to make sure we have all necessary files. +Available profiles -* mandatory properties + See the {{{../../en/profiles.html}profiles' page}} of <mavenpom4redmine>. - None actually + See the {{{../../../en/profiles.html}profiles' page}} of <mavenpom>. -* mandatories files +Conformity checks --------------------------------------------------------------------------------- -README.txt -changelog.txt -LICENSE.txt --------------------------------------------------------------------------------- + Same conformity checks are done from <mavenpom4redmine>. -Available profiles - - See the {{{profiles.html}profiles}} page. - + We also checks that all dependencies are on central repository using the + <<central-safe>> profile. + Plugins configuration See the {{{plugins.html}plugins}} page. Modified: trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/en/apt/minimalpom.apt =================================================================== --- trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/en/apt/minimalpom.apt 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/en/apt/minimalpom.apt 2010-10-03 13:11:53 UTC (rev 988) @@ -24,16 +24,16 @@ ~~~ ------ -Mavenpom4redmine usage +Mavenpom4redmineAndCentral usage ------ ------ -2010-01-22 +2010-10-03 ------ Abstract This page describe a mimimal (but fully functionnal) pom using correctly - <<mavenpom4redmine>>. + <<mavenpom4redmineAndCentral>>. The pom @@ -52,7 +52,7 @@ <parent> <groupId>org.nuiton</groupId> - <artifactId>mavenpom4redmine</artifactId> + <artifactId>mavenpom4redmineAndCentral</artifactId> <version>2.0.2</version> </parent> Deleted: trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/en/apt/profiles.apt =================================================================== --- trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/en/apt/profiles.apt 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/en/apt/profiles.apt 2010-10-03 13:11:53 UTC (rev 988) @@ -1,52 +0,0 @@ -~~~ -~~ #%L -~~ Mavenpom4redmine -~~ ~~ -~~ $Id$ -~~ $HeadURL$ -~~ %% -~~ Copyright (C) 2010 CodeLutin -~~ %% -~~ This program is free software: you can redistribute it and/or modify -~~ it under the terms of the GNU Lesser General Public License as -~~ published by the Free Software Foundation, either version 3 of the -~~ License, or (at your option) any later version. -~~ -~~ This program is distributed in the hope that it will be useful, -~~ but WITHOUT ANY WARRANTY; without even the implied warranty of -~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -~~ GNU General Lesser Public License for more details. -~~ -~~ You should have received a copy of the GNU General Lesser Public -~~ License along with this program. If not, see -~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. -~~ #L% -~~~ - ------- -Available profiles in mavenpom4redmine ------- ------- -2009-10-11 ------- - -Abstract - - - <TODO Translate me... from fr version> - -Overview - -*----------------------------------+---------------------------+ -| <<property>> | <<Activation property>> | -*----------------------------------+---------------------------+ -| {{redmine-build-release-profile}}| <<performRelease>> | -*----------------------------------+---------------------------+ -| {{redmine-pre-release-profile}} | <<performRedminePreRelease>> | -*----------------------------------+---------------------------+ -| {{redmine-release-profile}} | <<performRedmineRelease>> | -*----------------------------------+---------------------------+ -| {{redmine-next-version-profile}} | <<redmineNextVersion>> | -*----------------------------------+---------------------------+ - -Details Deleted: trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/en/apt/properties.apt =================================================================== --- trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/en/apt/properties.apt 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/en/apt/properties.apt 2010-10-03 13:11:53 UTC (rev 988) @@ -1,172 +0,0 @@ -~~~ -~~ #%L -~~ Mavenpom4redmine -~~ ~~ -~~ $Id$ -~~ $HeadURL$ -~~ %% -~~ Copyright (C) 2010 CodeLutin -~~ %% -~~ This program is free software: you can redistribute it and/or modify -~~ it under the terms of the GNU Lesser General Public License as -~~ published by the Free Software Foundation, either version 3 of the -~~ License, or (at your option) any later version. -~~ -~~ This program is distributed in the hope that it will be useful, -~~ but WITHOUT ANY WARRANTY; without even the implied warranty of -~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -~~ GNU General Lesser Public License for more details. -~~ -~~ You should have received a copy of the GNU General Lesser Public -~~ License along with this program. If not, see -~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. -~~ #L% -~~~ - ------- -Available properties in mavenpom4redmine ------- ------- -2009-10-11 ------- - -Abstract - - This page describe all properties defined in <mavenpom4redmine>. - -Overview - -*----------------------------------------------+--------------------------------------------------------+ -| <<property>> | <<Default- value>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{platform}} | <<nuiton.org>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.url}} | <<http://www.${platform}>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.serverId}} | <<redmine-${platform}>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.projectId}} | <<${projectId}>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.xmlPath}} | <<${maven.gen.dir}/changes/changes.xml>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.issueLinkTemplate}} | <<${redmine.url}/issues/show/%ISSUE%>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.versionLinkTemplate}} | <<${redmine.url}/versions/show/%VERSION%>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.attachmentLinkTemplate}} | <<${redmine.url}/attachments/download/%FILE%>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.collectedAttachments}} | <<target/collect-attachements.txt>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.collectedArtifacts}} | <<target/collect-artifacts.txt>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.releaseFiles}} | - | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.libReleaseFiles}} | - | -*----------------------------------------------+--------------------------------------------------------+ - -Details - -* {platform} - - Redmine's platform in - --------------------------------------------------------------------------------- -nuiton.org -chorem.org --------------------------------------------------------------------------------- - -* {redmine.url} - --------------------------------------------------------------------------------- -http://www.${platform} --------------------------------------------------------------------------------- - - Url of the redmine server. - -* {redmine.serverId} - --------------------------------------------------------------------------------- -redmine-${platform} --------------------------------------------------------------------------------- - -* {redmine.projectId} - - Id of the redmine's project. - --------------------------------------------------------------------------------- -${projectId} --------------------------------------------------------------------------------- - -* {redmine.xmlPath} - - Path of the generated issues from redmine and used in reports generation. - --------------------------------------------------------------------------------- -${maven.gen.dir}/changes/changes.xml --------------------------------------------------------------------------------- - -* {redmine.issueLinkTemplate} - - Url of an issue on redmine. The <<%ISSUE%>> pattern will be replaced in reports - by the issue's id. - --------------------------------------------------------------------------------- -${redmine.url}/issues/show/%ISSUE% --------------------------------------------------------------------------------- - -* {redmine.versionLinkTemplate} - - Url of a version on redmine. The <<%VERSION%>> pattern will be replaced in - reports by the version's id. - --------------------------------------------------------------------------------- -${redmine.url}/versions/show/%VERSION% --------------------------------------------------------------------------------- - -* {redmine.attachmentLinkTemplate} - - Url of a attachment on redmine. The <<%FILE%>> pattern will be replaced in - reports by the attachment's id. - --------------------------------------------------------------------------------- -${redmine.url}/attachments/download/%FILE% --------------------------------------------------------------------------------- - -* {redmine.collectedAttachments} - - Path of the file containing the list of files to send to redmine when a new - release is done. - --------------------------------------------------------------------------------- -target/collect-attachements.txt --------------------------------------------------------------------------------- - -* {redmine.collectedArtifacts} - - Path of the file containing the list of collected artifact files to deploy to - maven repository. - --------------------------------------------------------------------------------- -target/collect-artifacts.txt --------------------------------------------------------------------------------- - - -* {redmine.releaseFiles} - - Extra files to send to redmine when a new release is done (separated by comma). - - By default, None. - -* {redmine.libReleaseFiles} - - A convinient property for a <<jar>> module which builds the deps and full zip. - - Use this property in <<redmine.releaseFiles>> : - --------------------------------------------------------------------------------- -<redmine.releaseFiles>${redmine.libReleaseFiles}</redmine.releaseFiles> --------------------------------------------------------------------------------- - -* {redmine.includeAttached} - - To publish in redmine release attached files of the build (pom.xml, jars,...) Modified: trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/en/apt/release.apt =================================================================== --- trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/en/apt/release.apt 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/en/apt/release.apt 2010-10-03 13:11:53 UTC (rev 988) @@ -24,98 +24,17 @@ ~~~ ------ -Make a release from mavenpom4redmine +Make a release from mavenpom4redmineAndCentral ------ ------ -2010-01-10 +2010-10-03 ------ Abstract - This page describe how to make a release of a project which use <<mavenpom4redmine>>. + This page describe how to make a release of a project which use + <<mavenpom4redmineAndCentral>>. - the release takes four stages. + The procedure is exactly the same than a <<mavenpom4redmine>> release. -stage 1 - - Do a normal release - --------------------------------------------------------------------------------- -mvn release:prepare -mvn release:perform --------------------------------------------------------------------------------- - -Stage 2 - - In this stage, we will : - - * Deploy redmine release attachments - - * Create release announcements - - [] - - Go to the release project. - --------------------------------------------------------------------------------- -cd target/checkout --------------------------------------------------------------------------------- - - To try this stage launch this command : - --------------------------------------------------------------------------------- -mvn -DperformRedminePreRelease -N --------------------------------------------------------------------------------- - - If no error occurs here, launch the following command : - --------------------------------------------------------------------------------- -mvn -DperformRedminePreRelease -DdryRun=false -N --------------------------------------------------------------------------------- - - At this point, attachements are published and announcements are created here : - --------------------------------------------------------------------------------- -target/generated-sources/announcement/release-news-announcement.vm -target/generated-sources/announcement/release-email-announcement.vm --------------------------------------------------------------------------------- - - You can customize these announcements. - -Stage 3 - - Finalize the release, after customized announcements (if necessary). - - * Update redmine project version. - - * Send the release announcement email - - * Publish the release announcement on redmine - - [] - - Try the stage by this command : - --------------------------------------------------------------------------------- -mvn -DperformRedmineRelease -N --------------------------------------------------------------------------------- - - If no error occurs, launch the release command : - --------------------------------------------------------------------------------- -mvn -DperformRedmineRelease -DdryRun=false -N --------------------------------------------------------------------------------- - -Stage 4 - - Back to the trunk project - --------------------------------------------------------------------------------- -cd ../../ --------------------------------------------------------------------------------- - - Create the next version of redmine (where XX is the released version) - --------------------------------------------------------------------------------- -mvn -DredmineNextVersion -Dredmine.previousVersionName=XXX -N --------------------------------------------------------------------------------- + See the {{{../../en/release.html}release's page of mavenpom4redmine}}. Modified: trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/site_en.xml =================================================================== --- trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/site_en.xml 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/site_en.xml 2010-10-03 13:11:53 UTC (rev 988) @@ -26,44 +26,42 @@ <project name="${project.name}"> - <bannerLeft> - <name>${project.name}</name> - <href>index.html</href> - </bannerLeft> + <bannerLeft> + <name>${project.name}</name> + <href>index.html</href> + </bannerLeft> - <body> + <body> - <breadcrumbs> - <item name="${project.name}" - href="http://maven-site.nuiton.org/mavenpom/mavenpom4redmine/index.html"/> - </breadcrumbs> + <breadcrumbs> + <item name="${project.name}" + href="http://maven-site.nuiton.org/mavenpom/mavenpom4redmineAndCentral/index.html"/> + </breadcrumbs> - <!-- TC-20100117 : ne fonctionne pas sur une langue non principale --> - <!--<menu ref="parent"/>--> - <menu name="Parent Projet"> - <item name="Mavenpom" href="../../en/index.html"/> - </menu> + <!-- TC-20100117 : ne fonctionne pas sur une langue non principale --> + <!--<menu ref="parent"/>--> + <menu name="Parent Projet"> + <item name="Mavenpom" href="../../en/index.html"/> + </menu> - <menu name="Language"> - <item name="Version française" href="/../index.html"/> - </menu> + <menu name="Language"> + <item name="Version française" href="/../index.html"/> + </menu> - <menu name="Inside mavenpom4redmine"> - <item name="Home" href="/index.html"/> - <item name="Properties" href="properties.html"/> - <item name="Profiles" href="profiles.html"/> - </menu> + <menu name="Inside mavenpom4redmineAndCentral"> + <item name="Home" href="/index.html"/> + </menu> - <menu name="Using mavenpom4redmine"> - <item name="Minimal pom" href="minimalpom.html"/> - <item name="Make a release" href="release.html"/> - </menu> + <menu name="Using mavenpom4redmineAndCentral"> + <item name="Minimal pom" href="minimalpom.html"/> + <item name="Make a release" href="release.html"/> + </menu> - <menu name="Divers"> - <item name="Version française" href="/../index.html"/> - </menu> + <menu name="Divers"> + <item name="Version française" href="/../index.html"/> + </menu> - <menu ref="reports"/> + <menu ref="reports"/> - </body> + </body> </project> Modified: trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/site_fr.xml =================================================================== --- trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/site_fr.xml 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/site_fr.xml 2010-10-03 13:11:53 UTC (rev 988) @@ -34,26 +34,20 @@ <breadcrumbs> <item name="${project.name}" - href="http://maven-site.nuiton.org/mavenpom/mavenpom4redmine/index.html"/> + href="http://maven-site.nuiton.org/mavenpom/mavenpom4redmineAndCentral/index.html"/> </breadcrumbs> <menu ref="parent"/> - <menu name="Dissection de mavenpom4redmine"> + <menu name="Dissection de mavenpom4redmineAndCentral"> <item name="Accueil" href="index.html"/> - <item name="Propriétés" href="properties.html"/> - <item name="Profiles" href="profiles.html"/> </menu> - <menu name="Utiliser mavenpom4redmine"> + <menu name="Utiliser mavenpom4redmineAndCentral"> <item name="Pom minimal" href="minimalpom.html"/> <item name="Faire une release" href="release.html"/> </menu> - <!--menu name="Divers"> - <item name="English version" href="/en/index.html"/> - </menu--> - <menu ref="reports"/> </body> Modified: trunk/mavenpom4redmine/src/site/apt/index.apt =================================================================== --- trunk/mavenpom4redmine/src/site/apt/index.apt 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/mavenpom4redmine/src/site/apt/index.apt 2010-10-03 13:11:53 UTC (rev 988) @@ -58,7 +58,7 @@ * les version des plugins externes * la configuration des rapports du site - + * Ce que vous devez définir dans votre pom * l'url de votre projet @@ -79,8 +79,14 @@ Voir la page des {{{./properties.html}propriétés}} du pom. - Voir la page des {{{../properties.html}propriétés}} du <mavenpom>. + Voir la page des {{{../properties.html}propriétés}} de <mavenpom>. +Les profiles + + Voir la page des {{{./profiles.html}profiles}} du pom. + + Voir la page des {{{../../profiles.html}profiles}} de <mavenpom>. + Vérification de conformité On effectue sur le pom des contrôles de conformités via le plugin @@ -98,14 +104,10 @@ LICENSE.txt -------------------------------------------------------------------------------- -Les profiles - - Voir la page des {{{./profiles.html}profiles}}. - Configuration des plugins Pour connaître la liste des plugins gérés par <mavenpom4redmine>, veuillez - vous rendre sur la page de + vous rendre sur la page de {{{./plugin-management.html}configuration des plugins}}. Pour mieux comprendre comment utiliser les plugins (et gérer les versions des Modified: trunk/mavenpom4redmine/src/site/apt/release.apt =================================================================== --- trunk/mavenpom4redmine/src/site/apt/release.apt 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/mavenpom4redmine/src/site/apt/release.apt 2010-10-03 13:11:53 UTC (rev 988) @@ -71,7 +71,7 @@ Si aucune erreur lors de l'execution, on lance la commande suivante -------------------------------------------------------------------------------- -mvn -DperformRedminePreRelease -DdryRun=false -N [-Pcentral-safe] +mvn -DperformRedminePreRelease -DdryRun=false -N -------------------------------------------------------------------------------- A ce stade, les annonces ont été créées ici : @@ -81,8 +81,6 @@ target/generated-sources/announcement/release-email-announcement.vm -------------------------------------------------------------------------------- - Pour les projets central safe, on doit ajouter le <<-Pcentral-safe>>. - Etape 3 On finalise la release après avoir modifié les annonces (si nécessaire) : Modified: trunk/mavenpom4redmine/src/site/en/apt/index.apt =================================================================== --- trunk/mavenpom4redmine/src/site/en/apt/index.apt 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/mavenpom4redmine/src/site/en/apt/index.apt 2010-10-03 13:11:53 UTC (rev 988) @@ -24,7 +24,7 @@ ~~~ ------ -Maven nuiton pom +Mavenpom4redmineAndCentral ------ ------ 2009-09-01 @@ -32,15 +32,25 @@ Abstract - Corporate pom of all {{{http://www.nuiton.org}nuiton}} and - {{{http://www.chorem.org}chorem}} projects. + Corporate pom of all {{{http://www.nuiton.org}nuiton}} which are synchronized + on {{{http://repo1.maven.org/maven2/}Maven central repository}}. - the pom heritates from <<mavenpom>> and add full support to make release on redmine server. + The pom heritates from <<mavenpom4redmine>> and add full support to deploy on + central repository. Available properties See the {{{properties.html}properties}} page. + See the {{{../../en/properties.html}proprerties' page}} of <mavenpom>. + +Available profiles + + See the {{{profiles.html}profiles}} page. + + + See the {{{../../en/profiles.html}profiles' page}} of <mavenpom>. + Conformity checks Some conformity checks are done to make sure we have all necessary files. @@ -57,10 +67,6 @@ LICENSE.txt -------------------------------------------------------------------------------- -Available profiles - - See the {{{profiles.html}profiles}} page. - Plugins configuration See the {{{plugins.html}plugins}} page. Modified: trunk/mavenpom4redmine/src/site/site_en.xml =================================================================== --- trunk/mavenpom4redmine/src/site/site_en.xml 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/mavenpom4redmine/src/site/site_en.xml 2010-10-03 13:11:53 UTC (rev 988) @@ -26,44 +26,51 @@ <project name="${project.name}"> - <bannerLeft> - <name>${project.name}</name> - <href>index.html</href> - </bannerLeft> + <bannerLeft> + <name>${project.name}</name> + <href>index.html</href> + </bannerLeft> - <body> + <body> - <breadcrumbs> - <item name="${project.name}" - href="http://maven-site.nuiton.org/mavenpom/mavenpom4redmine/index.html"/> - </breadcrumbs> + <!--breadcrumbs> + <item name="${project.name}" + href="http://maven-site.nuiton.org/mavenpom/mavenpom4redmine/index.html"/> + </breadcrumbs--> - <!-- TC-20100117 : ne fonctionne pas sur une langue non principale --> - <!--<menu ref="parent"/>--> - <menu name="Parent Projet"> - <item name="Mavenpom" href="../../en/index.html"/> - </menu> + <!-- TC-20100117 : ne fonctionne pas sur une langue non principale --> + <!--<menu ref="parent"/>--> + <menu name="Parent Projet"> + <item name="Mavenpom" href="../../en/index.html"/> + </menu> - <menu name="Language"> - <item name="Version française" href="/../index.html"/> - </menu> + <!-- TC-20100117 : ne fonctionne pas sur une langue non principale --> + <!--<menu ref="modules"/>--> + <menu name="Modules"> + <item name="Mavenpom4redmineAndCentral" + href="../mavenpom4redmineAndCentral/en/index.html"/> + </menu> - <menu name="Inside mavenpom4redmine"> - <item name="Home" href="/index.html"/> - <item name="Properties" href="properties.html"/> - <item name="Profiles" href="profiles.html"/> - </menu> + <menu name="Language"> + <item name="Version française" href="/../index.html"/> + </menu> - <menu name="Using mavenpom4redmine"> - <item name="Minimal pom" href="minimalpom.html"/> - <item name="Make a release" href="release.html"/> - </menu> + <menu name="Inside mavenpom4redmineAndCentral"> + <item name="Home" href="/index.html"/> + <item name="Properties" href="properties.html"/> + <item name="Profiles" href="profiles.html"/> + </menu> - <menu name="Divers"> - <item name="Version française" href="/../index.html"/> - </menu> + <menu name="Using mavenpom4redmineAndCentral"> + <item name="Minimal pom" href="minimalpom.html"/> + <item name="Make a release" href="release.html"/> + </menu> - <menu ref="reports"/> + <menu name="Divers"> + <item name="Version française" href="/../index.html"/> + </menu> - </body> + <menu ref="reports"/> + + </body> </project> Modified: trunk/mavenpom4redmine/src/site/site_fr.xml =================================================================== --- trunk/mavenpom4redmine/src/site/site_fr.xml 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/mavenpom4redmine/src/site/site_fr.xml 2010-10-03 13:11:53 UTC (rev 988) @@ -32,13 +32,15 @@ <body> - <breadcrumbs> + <!--breadcrumbs> <item name="${project.name}" href="http://maven-site.nuiton.org/mavenpom/mavenpom4redmine/index.html"/> - </breadcrumbs> + </breadcrumbs--> <menu ref="parent"/> + <menu ref="modules"/> + <menu name="Dissection de mavenpom4redmine"> <item name="Accueil" href="index.html"/> <item name="Propriétés" href="properties.html"/> Modified: trunk/pom.xml =================================================================== --- trunk/pom.xml 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/pom.xml 2010-10-03 13:11:53 UTC (rev 988) @@ -867,15 +867,15 @@ <profile> <id>central-safe</id> - <properties> + <!--<properties>--> <!-- deploy releases on central-releases repository --> - <release.repository>${central.release.repository}</release.repository> + <!--<release.repository>${central.release.repository}</release.repository>--> <!-- release repository url (to be used in site.xml, by default use other-release repository) --> - <repository.home.url>${central.release.home.url}</repository.home.url> + <!--<repository.home.url>${central.release.home.url}</repository.home.url>--> - </properties> + <!--</properties>--> <build> <defaultGoal>validate</defaultGoal> @@ -895,7 +895,7 @@ <failIfNotSafe>true</failIfNotSafe> <repositories> <!--http://nexus.nuiton.org/nexus/content/repositories/central-releases--> - <central-releases>${repository.home.url}</central-releases> + <central-releases>${central.release.home.url}</central-releases> </repositories> </configuration> </execution> @@ -1321,6 +1321,13 @@ <!-- activate this profile while doing release:perform --> <releaseProfiles>internal,central-safe</releaseProfiles> + <!-- deploy releases on central-releases repository --> + <release.repository>${central.release.repository}</release.repository> + <!-- release repository url (to be used in site.xml, by default use other-release repository) --> + <repository.home.url>${central.release.home.url}</repository.home.url> + <!-- where to deploy site --> + <site.repository>${our.site.repository}/${projectId}</site.repository> + <!-- must fail if redmine actions failed --> <redmine.safe>true</redmine.safe> @@ -1333,9 +1340,6 @@ <!-- extra files to include in release --> <redmine.releaseFiles/> - <!-- deploy releases on central-releases repository --> - <release.repository>${central.release.repository}</release.repository> - <site.repository>${our.site.repository}/${projectId}</site.repository> </properties> <build> Modified: trunk/src/site/apt/index.apt =================================================================== --- trunk/src/site/apt/index.apt 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/src/site/apt/index.apt 2010-10-03 13:11:53 UTC (rev 988) @@ -35,6 +35,18 @@ Le projet <mavenpom> est un pom de type <Corporate> dont héritent tous les projets {{{http://www.codelutin.com}code Lutin}}. +* Nouveautés de la version 2.3 + + Depuis la version <<2.3>>, un nouveau type de pom nommé + du <<mavenpom4redmineAndCentral>> pour tous les projets déployés sur redmine + et synchronisés sur Maven central. + + Il hérite du <mavenpom4redmine> et rajoute la configuration pour que cela soit + déployé sur maven central. + + Pour plus d'informations, voir la page de + {{{./mavenpom4redmineAndCentral/index.html} de mavenpom4redmineAndCentral}}. + * Nouveautés de la version 2.2.2 ** Simplification des noms de dépôts @@ -44,10 +56,11 @@ ** Configuration central-safe améliorée La configuration <<central-safe>> a été améliorée, il s'agit désormais d'un - {{{./profiles.html#central_safe}profile central-safe}} qui n'est pas activé lors d'une release. + {{{./profiles.html#central_safe}profile central-safe}} qui n'est pas activé + lors d'une release. - Les projets <<central-safe>> modifie la configuration du <<plugin release>> pour inclure explicitement ce profile - et en <<prepare>> et en <<perform>>. + Les projets <<central-safe>> modifie la configuration du <<plugin release>> + pour inclure explicitement ce profile et en <<prepare>> et en <<perform>>. ** Mise à jour plugins @@ -90,6 +103,15 @@ Voir la page des {{{./properties.html}propriétés}}. +Les profiles + + Mavenpom définit un certain nombre de profiles. Certains sont dédiés + exclusivement à la préparation de releases, tandis que d'autres permettent de + réaliser certaines tâches pendant le développement (mise à jour des entêtes + des fichiers sources par exemple). + + La page des {{{./profiles.html}profiles}} décrit l'ensemble des profiles. + Vérification de conformité On effectue sur le pom des contrôles de conformités via le plugin @@ -107,15 +129,6 @@ LICENSE.txt -------------------------------------------------------------------------------- -Les profiles - - Mavenpom définit un certain nombre de profiles. Certains sont dédiés - exclusivement à la préparation de releases, tandis que d'autres permettent de - réaliser certaines tâches pendant le développement (mise à jour des entêtes - des fichiers sources par exemple). - - La page des {{{./profiles.html}profiles}} ressencent l'ensemble des profiles. - Configuration des plugins Mavenpom fixe les versions d'un certain nombre de plugins et ceci pour Modified: trunk/src/site/en/apt/index.apt =================================================================== --- trunk/src/site/en/apt/index.apt 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/src/site/en/apt/index.apt 2010-10-03 13:11:53 UTC (rev 988) @@ -35,7 +35,19 @@ Corporate pom of all {{{http://www.codelutin.com}Code Lutin}} projects. <<This documentation is not up to date (only french version is...)>>. - + +* News in 2.3 + + Since version <<2.3>>, a new pom was introduced named + <<mavenpom4redmineAndCentral>> for all projects deployed on redmine and + syncrhonized on Maven central repository. + + + It extends <mavenpom4redmine> and add the configuration to synchronize with Maven central. + + For more information, see the page of + {{{../mavenpom4redmineAndCentral/en/index.html} mavenpom4redmineAndCentral}}. + * News in 2.2.1 Since version <<2.2.1>> we use @@ -71,6 +83,10 @@ See the {{{properties.html}properties}} page. +Available profiles + + See the {{{profiles.html}profiles}} page. + Conformity checks Some conformity checks are done to make sure we have all necessary files. @@ -87,10 +103,6 @@ LICENSE.txt -------------------------------------------------------------------------------- -Available profiles - - See the {{{profiles.html}profiles}} page. - Plugins configuration See the {{{plugin-management.html}plugins}} page. Modified: trunk/src/site/site_en.xml =================================================================== --- trunk/src/site/site_en.xml 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/src/site/site_en.xml 2010-10-03 13:11:53 UTC (rev 988) @@ -25,68 +25,70 @@ --> <project name="${project.name}"> - <publishDate format="yyyy-MM-dd"/> + <publishDate format="yyyy-MM-dd"/> - <skin> - <groupId>org.nuiton</groupId> - <artifactId>maven-nuiton-skin</artifactId> - <version>${skin.version}</version> - </skin> + <skin> + <groupId>org.nuiton</groupId> + <artifactId>maven-nuiton-skin</artifactId> + <version>${skin.version}</version> + </skin> - <bannerLeft> - <name>${project.name}</name> - <href>index.html</href> - </bannerLeft> + <bannerLeft> + <name>${project.name}</name> + <href>index.html</href> + </bannerLeft> - <bannerRight> - <src>http://www.codelutin.com/images/lutinorange-codelutin.png</src> - <href>${project.organization.url}</href> - </bannerRight> + <bannerRight> + <src>http://www.codelutin.com/images/lutinorange-codelutin.png</src> + <href>${project.organization.url}</href> + </bannerRight> - <body> - <links> - <item name="Chorem" href="http://www.chorem.org"/> - <item name="Nuiton" href="http://www.nuiton.org"/> - <item name="Labs" href="http://labs.libre-entreprise.org/"/> - <item name="${project.organization.name}" href="${project.organization.url}"/> - </links> + <body> + <links> + <item name="Chorem" href="http://www.chorem.org"/> + <item name="Nuiton" href="http://www.nuiton.org"/> + <item name="Labs" href="http://labs.libre-entreprise.org/"/> + <item name="${project.organization.name}" + href="${project.organization.url}"/> + </links> - <!--breadcrumbs> - <item name="${project.name}" href="http://maven-site.nuiton.org/mavenpom/index.html"/> - </breadcrumbs--> + <!--breadcrumbs> + <item name="${project.name}" href="http://maven-site.nuiton.org/mavenpom/index.html"/> + </breadcrumbs--> - <!-- TC-20100117 : ne fonctionne pas sur une langue non principale --> - <!--<menu ref="modules"/>--> - <menu name="Modules"> - <item name="Mavenpom4redmine" href="../mavenpom4redmine/en/index.html"/> - <item name="Mavenpom4labs" href="../mavenpom4labs/en/index.html"/> - </menu> + <!-- TC-20100117 : ne fonctionne pas sur une langue non principale --> + <!--<menu ref="modules"/>--> + <menu name="Modules"> + <item name="Mavenpom4redmine" href="../mavenpom4redmine/en/index.html"/> + <item name="Mavenpom4labs" href="../mavenpom4labs/en/index.html"/> + </menu> - <menu name="Inside mavenpom"> - <item name="Home" href="/index.html"/> - <item name="Properties" href="properties.html"/> - <item name="Profiles" href="profiles.html"/> - <item name="Deploy artifacts" href="repositories.html"/> - </menu> + <menu name="Inside mavenpom"> + <item name="Home" href="/index.html"/> + <item name="Properties" href="properties.html"/> + <item name="Profiles" href="profiles.html"/> + <item name="Deploy artifacts" href="repositories.html"/> + </menu> - <menu name="Dev"> - <item name="Make a mavenpom release" href="release.html"/> - <item name="Maven best pratices" href="MavenProjectBestPratices.html"/> - </menu> + <menu name="Dev"> + <item name="Make a mavenpom release" href="release.html"/> + <item name="Maven best pratices" href="MavenProjectBestPratices.html"/> + </menu> - <menu name="Links"> - <item name="maven-nuiton-skin" href="../../maven-nuiton-skin"/> - <item name="maven-helper-plugin" href="../../maven-helper-plugin"/> - <item name="maven-jredmine-plugin" href="../../jredmine/maven-jredmine-plugin"/> - <item name="maven-license-plugin" href="../../maven-license-plugin"/> - </menu> + <menu name="Links"> + <item name="maven-nuiton-skin" href="../../maven-nuiton-skin"/> + <item name="maven-helper-plugin" href="../../maven-helper-plugin"/> + <item name="maven-jredmine-plugin" + href="../../jredmine/maven-jredmine-plugin"/> + <item name="maven-license-plugin" href="../../maven-license-plugin"/> + </menu> - <menu name="Divers"> - <item name="Version française" href="/../index.html"/> - </menu> + <menu name="Divers"> + <item name="Version française" href="/../index.html"/> + </menu> - <menu ref="reports"/> + <menu ref="reports"/> - </body> + </body> </project> Modified: trunk/src/site/site_fr.xml =================================================================== --- trunk/src/site/site_fr.xml 2010-10-03 11:18:57 UTC (rev 987) +++ trunk/src/site/site_fr.xml 2010-10-03 13:11:53 UTC (rev 988) @@ -25,63 +25,68 @@ --> <project name="${project.name}"> - <publishDate format="dd/MM/yyyy"/> + <publishDate format="dd/MM/yyyy"/> - <skin> - <groupId>org.nuiton</groupId> - <artifactId>maven-nuiton-skin</artifactId> - <version>${skin.version}</version> - </skin> + <skin> + <groupId>org.nuiton</groupId> + <artifactId>maven-nuiton-skin</artifactId> + <version>${skin.version}</version> + </skin> - <bannerLeft> - <name>${project.name}</name> - <href>index.html</href> - </bannerLeft> + <bannerLeft> + <name>${project.name}</name> + <href>index.html</href> + </bannerLeft> - <bannerRight> - <src>http://www.codelutin.com/images/lutinorange-codelutin.png</src> - <href>${project.organization.url}</href> - </bannerRight> + <bannerRight> + <src>http://www.codelutin.com/images/lutinorange-codelutin.png</src> + <href>${project.organization.url}</href> + </bannerRight> - <body> - <links> - <item name="Chorem" href="http://www.chorem.org"/> - <item name="Nuiton" href="http://www.nuiton.org"/> - <item name="Labs" href="http://labs.libre-entreprise.org/"/> - <item name="${project.organization.name}" href="${project.organization.url}"/> - </links> + <body> + <links> + <item name="Chorem" href="http://www.chorem.org"/> + <item name="Nuiton" href="http://www.nuiton.org"/> + <item name="Labs" href="http://labs.libre-entreprise.org/"/> + <item name="${project.organization.name}" + href="${project.organization.url}"/> + </links> - <!--breadcrumbs> - <item name="${project.name}" href="http://maven-site.nuiton.org/mavenpom/index.html"/> - </breadcrumbs--> + <!--breadcrumbs> + <item name="${project.name}" href="http://maven-site.nuiton.org/mavenpom/index.html"/> + </breadcrumbs--> - <menu ref="modules"/> + <menu ref="modules"/> - <menu name="Utiliser mavenpom"> - <item name="Accueil" href="index.html"/> - <item name="Propriétés" href="properties.html"/> - <item name="Profiles" href="profiles.html"/> - <item name="Configuration des serveurs" href="repositories.html"/> - </menu> + <menu name="Utiliser mavenpom"> + <item name="Accueil" href="index.html"/> + <item name="Propriétés" href="properties.html"/> + <item name="Profiles" href="profiles.html"/> + <item name="Configuration des serveurs" href="repositories.html"/> + </menu> - <menu name="Développeur"> - <item name="Faire une release de mavenpom" href="release.html"/> - <item name="Maven best pratices" href="MavenProjectBestPratices.html"/> - </menu> + <menu name="Développeur"> + <item name="Faire une release de mavenpom" href="release.html"/> + <item name="Maven best pratices" href="MavenProjectBestPratices.html"/> + </menu> - <menu name="Liens"> - <item name="maven-nuiton-skin" href="http://maven-site.nuiton.org/maven-nuiton-skin"/> - <item name="maven-helper-plugin" href="http://maven-site.nuiton.org/maven-helper-plugin"/> - <item name="maven-jredmine-plugin" href="http://maven-site.nuiton.org/jredmine/maven-jredmine-plugin"/> - <item name="maven-license-plugin" href="http://maven-site.nuiton.org/maven-license-plugin"/> + <menu name="Liens"> + <item name="maven-nuiton-skin" + href="http://maven-site.nuiton.org/maven-nuiton-skin"/> + <item name="maven-helper-plugin" + href="http://maven-site.nuiton.org/maven-helper-plugin"/> + <item name="maven-jredmine-plugin" + href="http://maven-site.nuiton.org/jredmine/maven-jredmine-plugin"/> + <item name="maven-license-plugin" + href="http://maven-site.nuiton.org/maven-license-plugin"/> - </menu> + </menu> - <!--menu name="Divers"> - <item name="English version" href="/en/index.html"/> - </menu--> + <!--menu name="Divers"> + <item name="English version" href="/en/index.html"/> + </menu--> - <menu ref="reports"/> + <menu ref="reports"/> - </body> + </body> </project>