Pyblosxom focuses on three things:
Pyblosxom stores all data on the file system in plain text files. This allows you to use any text editor to create, update and manipulate entries. You can also use existing text-manipulation tools, version control, scripts, grep, ... for managing your blog.
Pyblosxom can run as a CGI script, WSGI component or you can use it to statically compile your website into HTML/XML files.
Your workflow is your workflow.
Pyblosxom has a plugin framework enabling you to augment and enhance Pyblosxom’s default behavior. Plugins are written in Python. We maintain a list of plugins in the plugin registry on the website.
Plugins aren’t hard to write. We’re happy to help you write plugins.
There are several hundred Pyblosxom users out there all of whom have different needs. Pyblosxom is used on a variety of operating systems in a variety of environments. We have the standard open source project fare: mailing lists, IRC channel, wiki, ...
Pyblosxom is built to let you use existing text-manipulation tools without having to build the whole ecology from scratch.
Pyblosxom can be run as:
You can learn more about Pyblosxom on the website.
Pyblosxom is a small open source project and while there is a community, it’s pretty small. Pyblosxom’s features are great but make it a niche blog system.
Pyblosxom is a file-based blog system. Each blog entry is a separate file stored in a directory hierarchy on your file system. By default, the hierarchy is a category tree meaning each blog entry belongs in a single category. By default, mtimes are used as the blog entry timestamp. There are plugins that change this behavior, but require extra configuration to use.
There are a lot of other blog systems out there. If it’s apparent that Pyblosxom won’t work for you, don’t force it—use something else.
Entries, categories, storage:
See the website for details on the mailing lists, IRC, source code, issue tracker, and everything else.
If you’re installing for the first time, be sure to read Installing Pyblosxom in the manual (INSTALL if you’re looking at the source).
If you’re upgrading from a previous Pyblosxom version, read Upgrading Pyblosxom in the manual (UPGRADE if you’re looking at the source) as well as What’s New in the manual (WHATSNEW if you’re looking at the source) which covers what’s new in this version and what you’ll need to change in your blog.
The source tarball comes with a docs/ directory which contains the Pyblosxom manual for that version of Pyblosxom.
The manual for the most current version and past versions of Pyblosxom can be found on the website.
Pyblosxom is written for and by people like you. If you’re using Pyblosxom, please contribute something back whether it’s reporting a bug, fixing something, adding a new flavour, blogging about Pyblosxom, telling your friends, writing a plugin, or hanging out with us on IRC.
Details on where we hang out and such are on the website.
If you have a problem with Pyblosxom, please report it!
There are several different ways to report a bug, but all bugs should eventually make their way into our issue tracker.
If you’re able to fix the bug, that helps a ton! Please attach a patch file to the bug report or send the patch as an attachment to the pyblosxom-devel mailing list.
When sending a patch, it helps a lot to know the details of the bug as well as how you fixed it and whether there are outstanding issues.
Tests are written with the Python unittest module and don’t require any additional test frameworks.
To run the tests, do:
python setup.py test
This will build Pyblosxom, then run the tests.
If you would like to add tests to the test suite, please do and send us patches!