svn commit: r1433018 - in /geronimo/site/trunk: README.txt wiki-export/README

[ga...@apache.org]

Author: gawor
Date: Mon Jan 14 18:14:23 2013
New Revision: 1433018

URL: http://svn.apache.org/viewvc?rev=1433018&view=rev
Log:
update readme files

Removed:
    geronimo/site/trunk/wiki-export/README
Modified:
    geronimo/site/trunk/README.txt

Modified: geronimo/site/trunk/README.txt
URL: http://svn.apache.org/viewvc/geronimo/site/trunk/README.txt?rev=1433018&r1=1433017&r2=1433018&view=diff
==============================================================================
--- geronimo/site/trunk/README.txt (original)
+++ geronimo/site/trunk/README.txt Mon Jan 14 18:14:23 2013
@@ -2,29 +2,46 @@
 ## $Id$
 ##
 
-*Most* of the site content is now managed through Confluence in the GMOxSITE
-space (http://cwiki.apache.org/confluence/display/GMOxSITE/).
+The following svn repository (svnpubsub) contains the Geronimo web site:
 
-Some non-html content is still authored here (like for the plugin registry, etc).
+  - https://svn.apache.org/repos/infra/websites/production/geronimo/content
 
-The sync is performed from a `svn co` of this tree using 'bin/sync', which should
-be executed on people.apache.org.
+*Most* of the site content is managed through Confluence in the GMOxSITE and related spaces.
+However, some non-html content is (and should be) checked into directly into the svn.
 
-Currently, this is running automatically (as jdillon) via cron:
+The Confluence spaces are exported and checked into the svn using a BuildBot process.
 
-<snip>
-# Sync cwiki exported content to geronimo.apache.org
-5 * * * *       /home/jdillon/ws/site/bin/sync
-</snip>
 
-This will sync the latest content from SVN *and* from cwiki into /www/geronimo.apache.org/
-at 5 after the hour (every hour).  This is ~6 minutes before the live sync happens, which
-may take 10-20 minutes depending on how much other stuff it has to sync up.
 
-The existing content should remain untouched.  Currently content that exists outside of
-SVN and cwiki control (from this sync) is:
+How to build the site manually
+==============================
 
- * api/     - Ancient Javadocs, need to revisit to use latest maven/* bits
- * xbean/   - Confluence content, but sync not controlled here
- * maven/*  - Contains the maven site:deploy content
- * mail/    - Link to the raw public mail archives for Geronimo
\ No newline at end of file
+1) Checkout the site into a local directory:
+
+   svn co https://svn.apache.org/repos/infra/websites/production/geronimo/content
+
+2) Build wiki exporter code:
+
+   cd wiki-export
+   mvn clean install 
+
+3) Configure wiki exporter code:
+
+   You will need to pass credentials for a valid confluence user.  This can be
+   done in one of two ways:
+
+   a) Command line:
+      -Dconfluence.user=username -Dconfluence.password=password
+
+   b) Profile in .m2/settings.xml
+       <profile>
+            <id>confluence</id>
+            <properties>
+                <confluence.user>user</confluence.user>
+                <confluence.password>passwd</confluence.password>
+            </properties>
+        </profile>
+
+4) Export the Confluence spaces:
+
+   mvn -Pconfluence exec:java -Dgeronimo.site.output=<path to site content directory>