Apache CMS FAQ

This space is intended to list frequently asked questions and their answers for the Apache CMS.

Question/Answers

What is the Apache CMS?

See http://www.apache.org/dev/cms.html

How do we get started for our project?

Where do I get help?

Send questions via email to site-dev@a.o

How do I run the cms build scripts?

You can check out the scripts which can from be used to build your site here: https://svn.apache.org/repos/infra/websites/cms/build/. The perl script that generates the *.html site files from *.mdtext is build_site.pl. The build_site.pl script has some Python dependencies. The easiest easiest way to install these is to use the Python setuptools. First check your version of Python (python --version) and follow the instructions to install the appropriate set of tools from here http://pypi.python.org/pypi/setuptools

After the python setuptools are installed other python dependencies can be installed as follows:

How do I publish generated docs (eg. doxygen)?

First place all your generated docs into a local directory, let's call it foo/. Next create a compressed archive of foo/ by running

Then in the CMS navigate to the directory you'd like to add that directory to. Pull up the Edit screen and type "foo/" into the form field. Then hit <return>. Fill in the file upload widget by pointing it at foo.tar.gz, click on "Quick Commit", add a log message, and hit Submit. Wait while the staging site builds the docs, and when that process is completed click "Publish Site" and Submit. Please note that the name of the local directory must match the name of the directory to be added to the CMS.

The way to maintain this setup is to use the CMS to delete stale doc trees and replace them with fresh versions. By doing this using the web interface you will not need to fuss with the staging repo at all (unlike what happens when you try to do this using svn directly). It will just work.

More sophisticated projects should be capable of scripting this into their release packaging process. The requests to the CMS would look something like this (in perl):

ApacheCMSFAQ (last edited 2011-03-03 16:22:31 by BrettPorter)