Author: gk
Date: Mon Jan 6 14:00:51 2014
New Revision: 1555776
URL: http://svn.apache.org/r1555776
Log:
pom used to publish with mvn site:stage scm-publish:publish-scm
Added:
turbine/fulcrum/trunk/security/README (with props)
Modified:
turbine/fulcrum/trunk/security/pom.xml
Added: turbine/fulcrum/trunk/security/README
URL:
http://svn.apache.org/viewvc/turbine/fulcrum/trunk/security/README?rev=1555776&view=auto
==============================================================================
--- turbine/fulcrum/trunk/security/README (added)
+++ turbine/fulcrum/trunk/security/README Mon Jan 6 14:00:51 2014
@@ -0,0 +1,39 @@
+$Id$
+
+The Fulcrum Website Instructions
+--------------------------------
+
+The Fulcrum web site is based on .xml files which are transformed
+into .html files using Maven.
+
+<http://maven.apache.org/>
+
+Using scm-publish Plugin, cft. http://commons.apache.org/site-publish.html for
publishing and turbine-parent plugin check the following list items:
+
+* Verify turbine.site.path is matching pubScmUrl property of goal
scm-publish:publish-scm (e.g. by investigating the result of mvn
help:effective-pom)
+
+* Verify turbine.scmPubCheckoutDirectory is matching property
checkoutDirectory of goal scm-publish:publish-scm.
+
+* Once you have the site checked out locally, cd into your fulcrum-site
directory and execute, if single project
+
+ mvn site
+
+ or if it is multi-module project (with submodules)
+
+ mvn site:stage
+
+This will build the documentation into the target/site/, resp. target/staging/
directory. The output will show you which files got re-generated.
+
+* If you would like to make modifications to the web site documents, you
simply need to edit the files in the xdocs/ directory.
+
+* Once you have built your documentation and confirmed that your changes are
ok, you can check your .xml files back into Subversion.
+
+* To test what files would be added, deleted or updated run:
+
+ mvn site:stage scm-publish:publish-scm -Dscmpublish.dryRun=true
+
+This prints any changes to STDOUT.
+
+* To deploy run (add -Dusername=<username> -Dpassword=<pw>) remove
scmpublish.dryRun or set to false. Check if tryUpdate is set to false to get a
clean working copy again). Alternatively, if you have set
scmpublish.skipCheckin=true in the previous step, you have to do a manual
commit.
+
+
Propchange: turbine/fulcrum/trunk/security/README
------------------------------------------------------------------------------
svn:eol-style = native
Modified: turbine/fulcrum/trunk/security/pom.xml
URL:
http://svn.apache.org/viewvc/turbine/fulcrum/trunk/security/pom.xml?rev=1555776&r1=1555775&r2=1555776&view=diff
==============================================================================
--- turbine/fulcrum/trunk/security/pom.xml (original)
+++ turbine/fulcrum/trunk/security/pom.xml Mon Jan 6 14:00:51 2014
@@ -98,6 +98,16 @@
<build>
<sourceDirectory>${basedir}/src/java</sourceDirectory>
<testSourceDirectory>${basedir}/src/test</testSourceDirectory>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-scm-publish-plugin</artifactId>
+ <configuration>
+ <content>${siteContent.path}</content>
+ <tryUpdate>false</tryUpdate>
+ </configuration>
+ </plugin>
+ </plugins>
</build>
<profiles>
@@ -134,7 +144,9 @@
</profiles>
<properties>
- <turbine.site.path>fulcrum/security</turbine.site.path>
+ <turbine.site.path>fulcrum/fulcrum-security</turbine.site.path>
<turbine.scmPubCheckoutDirectory>${turbine.site.cache}/fulcrum/security</turbine.scmPubCheckoutDirectory>
+ <turbine.site.cache>C:/dc/apache.org/turbine-sites</turbine.site.cache>
+
<siteContent.path>${project.build.directory}/staging</siteContent.path><!--
default stagingSiteURL -->
</properties>
</project>
