last updated: 2016.03.05
wlog 1.0.2

minimalist blog engine

This is a simple web log that reads MarkDown text files to produce pages in HTML, with templates. Themeing is very easy. Categorization is supported by placing text files in subdirectories. "RSS" (ATOM) feed support. There is also a page 0 (index). It's inspired by Blosxom, an old perl blog engine.

You're viewing a slightly hacked version of wlog right now, in fact.


To install:

  1. Confirm that you have a web server, python3, and get Mistune - Python Markdown Converter.
  2. place wlog.py3 in a directory, and make it accessible via the web server.
  3. create a directory called "pages" in wlog's directory, and add head.wlog and post.wlog
  4. confirm that the variables at the top of wlog.py3 are correct, and modify head.wlog and post.wlog as desired
  5. By default, wlog takes arguments as wlog.py3?title=ARGUMENT .
  6. For cooler URIs, try calling it index.py3 and do a rewrite similar to this:
    (lighttpd) "/wlog/(.*)?" => "/wlog/index.py3?title=$1"

To add blog entries:

  1. Upload a text file with the extension you select to the pages directory (./pages/*.md is the default blog entry location)
  2. Format it with "date: y-m-d" on the first line, and the title you want for the entry on the second line.
  3. Write the rest of your blog post in Markdown.
  4. Begin a line with <...>, followed by a space, to cut the blog entry short at that line in the index.
  5. Place the file in a subdirectory of ./pages/ to give it a category.

To theme/configure further:

  1. Copy head.wlog and post.wlog and change the extension (example: head.mytheme post.mytheme)
  2. Modify as desired, change the theme setting in the script, and modify the script further as needed.
  3. Place new CSS/JS files outside of the wlog directory, if special rewrite rules are used to hide files.
  4. Submit your custom themeing / features to the project to help the project and participate in the public domain :)