Installing PyBlosxom with WSGI

Author: PyBlosxom Development Team
Version: advanced_installation.txt 1029 2007-06-07 02:33:12Z willhelm
Copyright: This document is distributed under the MIT license.

Contents

Summary

As of PyBlosxom 1.2, PyBlosxom has support for WSGI.

As of PyBlosxom 1.4, WSGI support has been folded into the main codebase (as opposed to being a separate wsgi_app.py file). But it's broken until 1.4.2.

There are a bunch of ways to set up PyBlosxom with WSGI. These instructions aren't as mature as other instructions.

If you find any issues, please let us know.

If you can help with the documentation efforts, please let us know.

Dependencies

Setup

Setup depends on what you're using.

mod_wsgi

If you're using mod_wsgi from http://code.google.com/p/modwsgi/ then do the following:

  1. Make sure mod_wsgi is installed correctly and working.

  2. Either:

    2.1. Add a WSGIScriptAlias to your Apache configuration that points to

    pyblosxom.wsgi, OR

    2.2. Verify that your WSGIScriptAlias points to a valid directory on

    your file system that stores WSGI scripts.

  3. Create a blog--see the instructions for the blog directories, config.py setup and other bits of Setting up a blog in install_cgi.

  4. Create a pyblosxom.wsgi script that looks something like this:

    # This is the pyblosxom.wsgi script that powers the _______ blog.
    import sys
    
    def add_to_path(d):
       if d not in sys.path:
          sys.path.insert(0, d)
    
    # call add_to_path with the directory that your config.py lives in.
    add_to_path("/home/joe/blog")
    
    # if you have PyBlosxom installed in a directory and NOT as a Python
    # library, then call add_to_path with the directory that PyBlosxom
    # lives in.  For example, if I untar'd pyblosxom-1.4.1.tar.gz into
    # /home/joe/, then add like this:
    # add_to_path("/home/joe/pyblosxom-1.4.1/")
    
    import Pyblosxom.pyblosxom
    application = Pyblosxom.pyblosxom.PyBlosxomWSGIApp()
    

mod_python

FIXME - need to add instructions here

other situations

FIXME - need to add instructions here