Pyblosxom for Debian
====================

Pyblosxom comes with extensive sphinx documentation. Please refer to
/usr/share/doc/pyblosxom/html for further information how to setup your weblog
as a CGI or WSGI application or how to compile it statically.

For the impatient
=================

If you are unsure whether pyblosxom is the right weblog system for you, here
are 5 simple steps to create your first blog with Pyblosxom.

 1. pyblosxom-cmd create ~/blog

    This will create an initial blog directory structure with all required files
    and subdirectories in your home directory under /blog.

 2. Configure config.py.

    Modify all variables and configuration options in config.py as you wish.
    Enable "static rendering" by uncommenting py["static_flavours"] = ["html"].
    Point py["static_dir"] to your output directory for your new blog, e.g.
    /home/joe/static.

 3. Load additional global plugins like yeararchives or pyfilenametime with
    py["load_plugins"] = ["Pyblosxom.plugins.yeararchives",
                          "Pyblosxom.plugins.pyfilenamemtime"]
    This ensures that your plugins stay up-to-date after new upstream releases.
    Of course you can use and modify your plugins on a per user basis, too.
    Just copy them from /usr/share/pyshared/Pyblosxom/plugins to your blog
    directory in ~/blog/plugins and use them like this:
    py["load_plugins"] = ["yeararchives", "pyfilenametime"]

 4. Write your first blog entry. Modify ~/blog/entries/firstpost.txt or create a
    second entry in a subdirectory ~/blog/entries/news with a new text file
    named my-first-news-post-2013-06-12.txt. Pyblosxom automatically recognizes
    subdirectories in your entries folder as new categories. The timestamp is
    important for your pyfilenametime plugin because from now on it will assume
    that the post was published on the 12th of June 2013. Usually Pyblosxom
    will use the mtime of your file to determine when the blog post has been
    published for the first time.

 5. Compile your blog.

    pyblosxom staticrender

    This will render your whole blog in your output directory in /home/joe/static.

Please visit http://pyblosxom.github.io/ for additional information and links
to new plugins, flavours or help.

  -- Markus Koschany <apo@gambaru.de>  Fri, 02 Aug 2013 16:03:49 +0200
