About

Clinklog is a static site generator with a couple of quirks:

  • it's optimized for linklogs and microblogs;
  • takes its input from one or more INI files.

Clinklog runs offline and outputs clean web pages you can then publish anywhere, without any more worries about speed or security. For instance, the author's link blog is generated with vanilla Clinklog and uses the default stylesheet.

Credit where credit is due: Clinklog is inspired by BashBlog. The name can be construed to be a pun on Command Line Interface, but I was simply thinking of a nice sound and the software's intended use. Special thanks to Oleo from Mushpark.com for testing, suggestions, patches and overall encouragement.

Download

Clinklog 2.1 (22K) includes the three scripts comprising the application, and the manual page in three different formats.

All of Clinklog is open source under the MIT License. See at the top of each script for details.

Requirements

Starting with release 2.0, Clinklog requires Python 3.7; otherwise it can make do with just the standard library. If you're stuck with an older Python for some reason, use the legacy edition for now. Just beware that it won't receive any more updates.

Status

Clinklog 2.1 was released in August 2020; see the old news for details.

Known bug: in line 106, the date-time format should be %a, %d %b %Y %H:%M:%S %Z i.e. with a short month name.

Usage

Clinklog is a command-line application, so you'll need to be somewhat familiar with that. For a quick start, do this:

  • create a new directory and navigate to it;
  • run clinklog-init.py to create a blog;
  • run clinklog-export.py to generate HTML.

In-between you can edit content/clinklog.ini to your liking. And of course both scripts support various options; run them with a -h argument for details.

See the user guide for an in-depth introduction.