How to update the Marmotta website
---------------------------------

INTRO
-----
The http://marmotta.apache.org web site is managed by the ASF CMS
(https://cms.apache.org).

All Marmotta committers have read-write access to the website content,
but it's good practice to discuss big changes on the dev list in advance.

Build is done with the Maven Site Plugin:
  http://maven.apache.org/plugins/maven-site-plugin/

Content is provided in markdown structured text format, see: 
  http://www.apache.org/dev/cmsref.html#markdown
for pointers to syntax and conventions.

For help see also:
  http://www.apache.org/dev/cmsref
  http://www.apache.org/dev/cms
  http://www.apache.org/dev/cmsadoption

WORKING IN SVN
--------------
Committing content under
  https://svn.apache.org/repos/asf/marmotta/site/trunk
causes a staging build of the website to be executed.

The staged content becomes available under 
  http://marmotta.staging.apache.org/

The build process can be followed at 
  http://ci.apache.org/builders/marmotta-site-staging

See the existing content for how to add images and additional files.

To push the changes in production, connect to
  https://cms.apache.org/marmotta/publish 
with your LDAP credentials (as set on people.apache.org).

Non-committers could generate anonymous patches via the CMS UI.

BROWSER-BASED EDITING AND PUBLISHING
------------------------------------
Starting at https://cms.apache.org/marmotta/ , one can get a working copy, 
edit it if needed (with simple preview) and publish it to the live site.

ACKNOWLEDGMENTS
---------------
Thanks the Stanbol team, particulary Bertrand Delacretaz and Rupert 
Westenthaler, for providing the original content for this brief HowTo.

THAT'S IT
---------
The Apache CMS is a simple tool compared to some of the CMS we're used to.

The nice thing is that the workflow happens in svn, so it's no different
than what we do for code.

Enjoy!