|
253
|
1 -*- markdown -*-
|
|
|
2
|
|
|
3 hg-website
|
|
|
4 ==========
|
|
|
5
|
|
|
6 This is a fork of the original hg-scm.org website. It has two goals:
|
|
|
7
|
|
|
8 * 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.
|
|
|
9 * Move all the content into a subrepository so volunteers can just clone that repository if they just want to edit the content.
|
|
|
10
|
|
|
11 Setup
|
|
|
12 -----
|
|
|
13
|
|
|
14 To use this version of hg-website you need to install a few things:
|
|
|
15
|
|
|
16 Blatter's prerequisites:
|
|
|
17
|
|
|
18 easy_install jinja2
|
|
|
19 easy_install werkzeug
|
|
|
20
|
|
|
21 My patched version of blatter (adds the ability to ignore files and add custom Jinja2 filters):
|
|
|
22
|
|
|
23 hg clone http://bitbucket.org/sjl/blatter/
|
|
|
24 cd blatter
|
|
|
25 python setup.py install
|
|
|
26
|
|
|
27 Usage
|
|
|
28 -----
|
|
|
29
|
|
|
30 To have blatter serve the page dynamically, use:
|
|
|
31
|
|
|
32 blatter serve
|
|
|
33
|
|
|
34 You can then visit [http://localhost:8008](http://localhost:8008) to view the site.
|
|
|
35
|
|
|
36 To render a static version of the site into the `out/` directory:
|
|
|
37
|
|
|
38 blatter blat
|
|
|
39
|
|
|
40 For more information on using blatter, check the README file at [http://bitbucket.org/sjl/blatter/src/](http://bitbucket.org/sjl/blatter/src/) |
