Permalink
Browse files

The publication magic only works when the output of mvn site:deploy i…

…s set to the input of scmpublish

git-svn-id: https://svn.apache.org/repos/asf/creadur/rat/trunk@1411835 13f79535-47bb-0310-9956-ffa450edef68
  • Loading branch information...
1 parent cfa7a84 commit c778d1d7e5dcef067f08cddf87aa66519dccb967 @itstechupnorth itstechupnorth committed Nov 20, 2012
Showing with 25 additions and 22 deletions.
  1. +16 −22 pom.xml
  2. +9 −0 src/site/apt/site-publish.apt
View
38 pom.xml
@@ -52,28 +52,24 @@ agnostic home for software distribution comprehension and audit tools.
<mavenVersion>2.2.1</mavenVersion>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<!--
- These properties are to allow deployment to another target than
- the Apache repositories. The default settings are expected to
- match the settings from the parent POM.
+ Publication to the website is a two phase operation:
+
+ 1. Deploy to local stage: mvn site:deploy
+ 2. Publish to Apache CMS: mvn scm-publish:publish-scm
+
+ This will only work when the origin for scm-publish:publish-scm
+ is the target for site:deploy.
+
+ SO MAKE SURE THAT THE FOLLOWING PROPERTIES RESOLVE TO THE SAME
+ DIRECTORY:
+
+ * scmpublish.content
+ * rat.site.url
- To override these properties, use something like the following
- in your settings.xml:
- <profiles>
- <profile>
- <activation>
- <activeByDefault>true</activeByDefault>
- </activation>
- <properties>
- <rat.site.url>file:///C:/temp/my.rat.site</rat.site.url>
- ...
- </properties>
- </profile>
- </profiles>
- -->
- <!--
- For the moment, deploy to stage directory only.
-->
- <rat.site.url>file:stage</rat.site.url>
+ <rat.LocalSiteStaging>stage</rat.LocalSiteStaging>
+ <scmpublish.content>${rat.LocalSiteStaging}</scmpublish.content>
+ <rat.site.url>file:${rat.LocalSiteStaging}</rat.site.url>
<rat.site.name>Apache Rat Website</rat.site.name>
<rat.site.id>org.apache.rat.site</rat.site.id>
<rat.releases.id>apache.releases.https</rat.releases.id>
@@ -83,8 +79,6 @@ agnostic home for software distribution comprehension and audit tools.
<rat.snapshots.name>${distMgmtSnapshotsName}</rat.snapshots.name> <!-- Parent POM uses these properties -->
<rat.snapshots.url>${distMgmtSnapshotsUrl}</rat.snapshots.url>
- <scmpublish.content>stage</scmpublish.content>
-
<!-- maven plugin versions -->
<surefire.version>2.12.3</surefire.version>
</properties>
@@ -62,6 +62,15 @@ mvn clean install site
Publishing updates the main site with changes committed since the last
time the site was published.
+** Publish to Local Stage
+
+ Rat declares a local staging directory (<<<stage>>>) for Maven
+ site deployments. To avoid excessive numbers of commits, the
+ local staging directory needs to remain ignored by <<<subversion>>>.
+ As well as being the target for <<<mvn site:deploy>>>, this is also
+ the origin for publication.
+
+
Troubleshooting

0 comments on commit c778d1d

Please sign in to comment.