svn commit: r1189640 - /openejb/site/trunk/content/dev/website-dev.mdtext

[db...@apache.org]

Author: dblevins
Date: Thu Oct 27 07:05:42 2011
New Revision: 1189640

URL: http://svn.apache.org/viewvc?rev=1189640&view=rev
Log:
Basic info on how to work with the cms

Added:
    openejb/site/trunk/content/dev/website-dev.mdtext

Added: openejb/site/trunk/content/dev/website-dev.mdtext
URL: http://svn.apache.org/viewvc/openejb/site/trunk/content/dev/website-dev.mdtext?rev=1189640&view=auto
==============================================================================
--- openejb/site/trunk/content/dev/website-dev.mdtext (added)
+++ openejb/site/trunk/content/dev/website-dev.mdtext Thu Oct 27 07:05:42 2011
@@ -0,0 +1,39 @@
+Title: Working on the Website
+
+# Editing
+
+Easiest is to check out the site source from svn:
+
+    svn co https://svn.apache.org/repos/asf/openejb/site/trunk website-source
+
+All the important source is in the `content` directory.  Just edit
+and check in the `.mdtext` files and they will appear in the staging
+site within seconds.
+
+For example, `documentation.mdtext` shows up as:
+
+[http://openejb.staging.apache.org/documentation.html]
+
+# Building Locally <small>optional</small>
+
+Should you want to build the site locally, you can do so pretty easily with the right perl modules installed.
+
+First check out the CMS source:
+
+    svn co https://svn.apache.org/repos/infra/websites/cms/build apache-cms-source
+
+The cpan modules you have to install may vary.  Here are the ones I installed:
+
+    sudo cpan XML::RSS::Parser::Lite
+    sudo cpan XML::RSS::Parser
+    sudo cpan XML::Parser::Lite
+    sudo cpan XML::Atom::Feed
+
+What you need to install may be different, so perhaps just skip to the part
+where we attempt to run the build locally and see what shows up missing and
+install just those things.
+
+    cd apache-cms-source
+    ./build_site.pl  --source-base ~/path/to/website-source --target-base /tmp/site
+
+All the generated html content will be under `/tmp/site/content`
\ No newline at end of file