Welcome to PyBlosxom!

What is PyBlosxom?

PyBlosxom is:

  • File-Based: In PyBlosxom everything is a text file. Entries are files, configuration is a file, plugins are files, etc... This makes PyBlosxom easily extensible in whatever environment you choose to work in and instantly compatable with command line scripting.
  • Extensible: Pyblosxom has a plugin framework which allows you to customize and extend PyBlosxom in almost every way.
  • Standards-compliant: PyBlosxom supports RSS 2.0 and Atom syndication feeds.
  • Customizeable: PyBlosxom has a simple templating engine to make it easy to design your own themes with a minimum of development knowlage.
  • Community-oriented: We pride ourselves in being a nice, open and friendly community. PyBlosxom has hundreds of active users, each of them running PyBlosxom in different ways and on different operating systems. As a result, there is usually someone on the IRC channel or mailing lists who has encountered your problem before and who would be willing to lend a hand. If you don't get a satisfactory response, take that as motivation to figure it out and help add to our extensive documentation!

Pyblosxom allows you to use your favorite editor, toolset and workflow to maintain your blog without forcing you to build it all from scratch.

Latest News

Quickstart

This is generally how you install and test out Pyblosxom. There are other ways to install it and other ways to deploy your blog. See the documentation for more details.

 $ pip install pyblosxom
 $ pyblosxom-cmd create ./blog
 $ cd blog
 [ edit config.py ]
 $ paster serve blog.ini

Project information

Source code

Source code is located at https://github.com/pyblosxom/pyblosxom.

You can clone the PyBlosxom repository with:

 $ git clone https://github.com/pyblosxom/pyblosxom.git

PyBlosxom is written in Python. PyBlosxom is distributed under the MIT license.

Join In!

We are always happy to see new faces on the mailing lists or IRC channel. If you have any questions about PyBlosxom or you are interested in contributing by helping new users, adding to the documentation, or contributing a patch or plugin, see how you can connect with us below.

We could use help with the following things:

  • hanging out with us -- pyblosxom is a social community
  • testing pyblosxom and plugins
  • fixing and updating documentation
  • writing new plugins; enhancing existing plugins; fixing bugs in plugins

If you're interested in contributing, but don't know where to start, join the devel mailing list and ask!

Please note that our code is under the MIT licence and our documentation is under the CC0 licence and all contributing code will be licenced under those licences. If that isn't OK with you, please say so before contributing.

IRC

A bunch of us hang out on #pyblosxom on irc.freenode.net. (webchat) If you want to socialize with other PyBlosxom users or have a question you think is too minor for the users list, look for us here.

Mailing lists

pyblosxom-users

pyblosxom-users at lists dot sourceforge dot net (subscribe/unsubscribe) (archives)

This mailing list is for users who are having problems installing or configuring Pyblosxom. It can also be used for questions, comments, bugs, ideas, and things of that nature as well.

pyblosxom-devel

pyblosxom-devel at lists dot sourceforge dot net (subscribe/unsubscribe) (archives)

This mailing list is for developers who want to add/modify/delete functionality in Pyblosxom. Since it revolves around Pyblosxom development, it's also a good place to ask questions about how to build plugins and for advice on working around various plugin development issues.

Bugs/Features

Please file bugs and feature requests in our issue tracker.

Send in patches

Want to share your changes? Check out our docs on hacking and sending in patches.

Built with pyblosxom 1.5.2. Website content and documentation is released under the CC0 Licence.