> Also can anyone explain how the .mdtext files are eventually converted > into HTML for the current Mahout website? > > I guess there is a static site generator written in Perl ( lib/view.pm > and lib/path.pm ). But what really invokes the site generation in > terms of the entry point?
I was able to find the correct information on buildind Apache CMS sites. Below are the instructions to generate Mahout Website from source on your own machine. Steps to folow: * Checkout Mahout Website source * Setup CMS build tool * Run markdown daemon * Generate and veiw the site This has been checked with Ubuntu 12.04. Other distribution shall work just fine as well. Tools needed are SVN, Perl, Python and some bash commands. Step 1: Checkout Mahout Website source ======================================== Checkout the Apache Mahout website source from SVN: $ svn http://svn.apache.org/repos/asf/mahout/site/mahout_cms/trunk $ cd trunk/ $ export SITE_SOURCE_PATH=`pwd` SITE_SOURCE_PATH is the location where we have Mahout website source ( trunk or other branch ). We also need to setup a location where we would generate the site output. Lets assume it is at /tmp/mahout-website $ export SITE_TARGET_PATH=/tmp/mahout-website Step 2: Setup CMS build tool ======================================== Install the required Perl libraries $ sudo aptitude install libyaml-perl $ sudo perl -MCPAN -e "install Dotiac::DTL" Checkout CMS build tool from SVN: $ svn co https://svn.apache.org/repos/infra/websites/cms/ $ cd cms/build/ $ export CMS_TOOL_PATH=`pwd` Step 3: Run markdownd daemon ======================================== The site source builder needs a markdownd daemon which can be started like this: $ cd $CMS_TOOL_PATH $ export MARKDOWN_SOCKET=`pwd`/markdown.socket PYTHONPATH=`pwd`export $ python markdownd.py Step 4: Generate and veiw the site ======================================== Now generate the site from SITE_SORUCE_PATH to SITE_TARGET_PATH $ cd $CMS_TOOL_PATH $ perl build_site.pl --source-base $SITE_SOURCE_PATH --target-base $SITE_TARGET_PATH We are done with site generation, lets setup a simple web-server to view the generated site. Start a simple web server using python at the location $SITE_TARGET_PATH: $ cd $SITE_TARGET_PATH $ python -m SimpleHTTPServer Finally the site can viewed using this url: http://localhost:8000/ More details are present here [1] and here [2]. I hope this is helpful for website documentation. Regards, Saleem [1] https://svn.apache.org/repos/asf/openjpa/site/trunk/instructions.mdtext [2] https://gist.github.com/tuxdna/11178000
