view README @ 347:871e9821b5b9

remove python requirement from main page, moving to downloads page

There was some discussion of this on [e-mail], but with no
consensus.  Since none of the leading binary packages on the web site
(unix-like distros excepted) require a separate Python installation, I
preferred the idea of simply not mentioning the requirement at the main
page.  I've moved it to the downloads page, which allows us to explicate
a bit more as well.

-*- markdown -*-

hg-website
==========

This is a fork of the original hg-scm.org website.  It has two goals:

* Instead of using Django to serve the site, use Blatter to generate a static version which can then be served by a normal webserver like Apache or nginx.
* Move all the content into a subrepository so volunteers can just clone that repository if they just want to edit the content.

Setup
-----

To use this version of hg-website you need to install a few things:

Blatter's prerequisites:

    easy_install jinja2
    easy_install werkzeug

My patched version of blatter (adds the ability to ignore files and add custom Jinja2 filters):

    hg clone http://bitbucket.org/sjl/blatter/
    cd blatter
    python setup.py install

The python-markdown module (for rendering the website content):

    easy_install markdown

Usage
-----

To have blatter serve the page dynamically, use:

    blatter serve

You can then visit [http://localhost:8008](http://localhost:8008) to view the site.

To render a static version of the site into the `out/` directory:

    blatter blat

For more information on using blatter, check the README file at [http://bitbucket.org/sjl/blatter/src/](http://bitbucket.org/sjl/blatter/src/)