blog is a tiny tool that generates your (link)blog.
It takes a YAML file as input, and produces
a single HTML file on stdout, which you could then upload to your
server, place on your Desktop, or pass along to friends.
blog is not meant to be a feature-rich program. It does the
bare minimum necessary to host a blog with different post types,
and not more. Whichever additional features you need you can
add to your version of it.
How to use it
All posts are written in a single file
blog.yaml, which contains
a list of entries.
The most basic post type is
text, written as follows:
- title: An example post content: You can use *Markdown* here...
Optionally you can specify a
content starts with a non-alphabetic character, you need to
start the value with a vertical bar
- title: Special characters... content: | *This* post starts with a special character.
There are a few other types of posts:
shell, similar to text, but
titleis a shell command
link, with an additional
urlis the source of an image
urlis the source of the song
With the exception of the