How to install blaag ==================== To test Blaag, you can simply unpack blaag, and then run it in the folder example_blaag using:: $ python ../blaag.py but you'll need to make sure some Python libraries are available as requirements: * docutils * hgapi * PyRSS2Gen You can also install Blaag by running:: $ python setup.py install in your blaag folder; this will install the 'blaag' script in your Python installation's script folder. To create your own blaag, copy or clone example_blaag, add entries in the '/entries' subfolder, and run blaag to generate html (in a subfolder named '/html'). To configure the Blaag, modify blaag.cfg and/or HTML fragments in the '/custom' folder You could do that using pip or easy_install. You can also use the buildout installation below, which provides a few more goodies. buildout installation --------------------- To automatically install all dependencies and a few other tools locally in the project, you can use buildout. First you need to install buildout using the bootstrap:: $ python bootstrap.py -d (the ``-d`` argument uses distribute instead of setuptools, so you can leave it off) Now you can run buildout:: $ bin/buildout -N (the ``-N`` arguments avoids loading dependencies from PyPI if a version is already there. you can leave it off too but it'll be a bit slower the next time you run it) This will automatically install the dependencies. Now you can run ``blaag`` like this:: $ bin/blaag There's also a ``bin/devpython``:: $ bin/devpython ``bin/devpython`` is a Python interpreter wrapper that has the ``blaag`` dependencies installed so they can be imported, along with ``blaag`` itself. So you could do this too:: $ bin/devpython blaag.py As a bonus you get ``pyflakes`` installed so you can clean up the ``blaag`` source code with it.