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

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

Additionally, if you’re using an earlier version of Python than Python 2.5, then you’ll also need:

• wsgiref library from http://svn.eby-sarna.com/wsgiref/

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.

Deployment with mod_wsgi

Paste makes it really easy to use with mod_wsgi.

1. Create a file named something.wsgi like this one:

   # If you're using a virtualenv, uncomment the next two lines and
   # change '/path/to/activate_this.py'.
   # activate_this = '/path/to/activate_this.py'
   # execfile(activate_this, dict(__file__=activate_this))
   
   from Pyblosxom.pyblosxom import pyblosxom_app_factory
   from paste.deploy import loadapp
   
   # Fill in path to Paste .ini config file here
   application = loadapp('config:/path/to/wsgi.ini')
   

2. In the Apache httpd.conf file:

   WSGIScriptAlias /myblog /path/to/something.wsgi
   
   <Directory /path/to>
       Order deny,allow
       Allow from all
   </Directory>

For more details, consult the mod_wsgi documentation at http://code.google.com/p/modwsgi/ .

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.