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.