Deploying Pyblosxom with Paste

Summary

Pyblosxom 1.4 and later support Paste. This document covers installing and using Pyblosxom with Paste.

This installation assumes you have some understanding of Python Paste. If this doesn’t sound like you, then you can read up on Paste on the Paste website or the Wikipedia page.

Dependencies

You’ll need:

• Python Paste which can be found at http://pythonpaste.org/

  If you have pip, then do:

  pip install pastescript
  

  Or if you have easy_install, then do:

  easy_install pastescript
  

Deployment for testing

Create a new blog by doing:

pyblosxom-cmd create <BLOG-DIR>

Then do:

cd <BLOG-DIR>
paster serve blog.ini

The paster script will print the URL for your blog on the command line and your blog is now available on your local machine to a browser on your local machine.

This allows you to test your blog and make sure it works.

Paste .ini file configuration

Paste configuration is done in an .ini file.

Edit the blog.ini file that pyblosxom-cmd created for you.

The [server:main] section dictates how Paste is serving your blog. See the Paste documentation for more details on this section.

The [app:main] section specifies the Pyblosxom WSGI application function and the directory your config.py file is in. A sample is here:

[app:main]
paste.app_factory = Pyblosxom.pyblosxom:pyblosxom_app_factory
configpydir = /home/joe/blog/

Additionally, you can override config.py values in your blog.ini. For example, this overrides the blog_title value:

[app:main]
paste.app_factory = Pyblosxom.pyblosxom:pyblosxom_app_factory
configpydir = /home/joe/blog/

# Pyblosxom config here
blog_title = Joe's Blog

This is really handy for testing changes to your blog infrastructure.