Mailing-List: contact aries-commits-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: aries-dev@incubator.apache.org
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r1041938 - /incubator/aries/branches/site/README
Date: Fri, 03 Dec 2010 18:03:24 -0000
To: aries-commits@incubator.apache.org
From: zoe@apache.org
Message-Id: <20101203180324.8439F23889E3@eris.apache.org>

Author: zoe
Date: Fri Dec  3 18:03:24 2010
New Revision: 1041938

URL: http://svn.apache.org/viewvc?rev=1041938&view=rev
Log:
ARIES-502 Tidy README a bit more

Modified:
    incubator/aries/branches/site/README

Modified: incubator/aries/branches/site/README
URL: http://svn.apache.org/viewvc/incubator/aries/branches/site/README?rev=1041938&r1=1041937&r2=1041938&view=diff
==============================================================================
--- incubator/aries/branches/site/README (original)
+++ incubator/aries/branches/site/README Fri Dec  3 18:03:24 2010
@@ -5,7 +5,7 @@ Here is what I did to create it. Steps 1
 Go straight to step 3 if you want to build the site and test it.
 
 1) Branched the old site and created the new site structure as specififed on the cms pages:
-http://www.apache.org/dev/cms.html, look under adption constraints.
+http://www.apache.org/dev/cms.html, look under adoption constraints.
 
 2) Extracted the cwiki content using the export-site.pl tool.
  To run this I had to install some extra perl modules:
@@ -14,16 +14,21 @@ http://www.apache.org/dev/cms.html, look
    sudo port install  p5-libwww-perli
    sudo port install  p5-rpc-xml
 
-These are Mac specific Darwin ports commands, could also have installed from CPAN.
+These are Mac specific Darwin ports commands, these could also have been installed from CPAN.
+For referece the CPAN links are here:
 
-This generates the site content as *.mdtext files - but also leaves the cwiki files for reference.
+http://search.cpan.org/search?query=RPC%3AXML&mode=all  (RPC:XML)
+http://search.cpan.org/~nanis/Crypt-SSLeay-0.58/SSLeay.pm (Crypt-SSLeay-0.58)
+http://search.cpan.org/~gaas/libwww-perl-5.837/lib/LWP.pm (libwww-perl-5.837)
+
+This generates the site content as *.mdtext files - but also leaves the *.cwiki files for reference.
 The results of all of this are currently checked in here:
 https://svn.apache.org/repos/asf/incubator/aries/branches/site/.
 
-After the initial creation I had to:
+After the initial creation I had to (ARIES-502):
 (a) Create a site template
-(b) Workout how to fix teh navigation panes (look at the templates directory)
-(c) Fix a lot of places where the wiki conversion had't worked right
+(b) Workout how to fix the navigation panes (look at the templates directory)
+(c) Fix a lot of places where the wiki conversion hadn't worked right
 (d) In particular the downloads page - which we used to handle with a confluenece Macro
 
 There is still more fixing up to be done!
@@ -40,20 +45,21 @@ rm lib/Dotiac/DTL/Addon/markup.pl 
 
 from the build tools directory.
 
-Install two other libraries:
+And install two other libraries:
 sudo perl -MCPAN -e "install Dotiac::DTL"
 sudo cpan Dotiac::DTL::Addon::markup
 
-Then to build the site:
+Then to build the site use this command:
 
 perl build_site.pl --source-base /path/to/newsite/trunk/ --target-base /path/to/output/
 
+which will create *.html in /path/to/output/content
+
 4) Check the site on a local server.
 
-I have a vhost to check the site. On a Mac this means that I add teh following stanza to /etc/apache2/extra/httpd-vhosts.conf
+I use a vhost to check the site. On a Mac this means that I add the following stanza to /etc/apache2/extra/httpd-vhosts.conf
 
 <VirtualHost *:80>
-    ServerAdmin zoe.slattery@googlemail.com
     DocumentRoot "/Users/zoe/Sites/zaries/www"
     ServerName zaries
     ErrorLog "/Users/zoe/Sites/zaries/error.log"