1. Fredrik Håård
  2. blaag


blaag / INSTALL.txt

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

* 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.