This repository is most of p1k3.com, a blog.
archives/ contains the actual entries. Layout is generally something like:
2009/ `-1/ |+27/ |+3/ |-cart_small.jpg `-index
2009 is a year, 1 is the month of January, and everything below that level is a day. Some days are simple blobs of markup, others are directories which may contain an index file with the main text of entry, binaries like images, and one or more sub-entries.
public/ contains public files, including
templates/ contains template files.
See https://github.com/brennen/display for the blog rendering engine invoked by
You can read these files without any special tools, but rendering or publishing
the full site requires a few things. As a baseline, it expects a GNU/Linux
system; Debian or a derivative will probably work best. There's a
with a bunch of little commands, and the
bin/ directory contains various
small utilities for generating different kinds of files.
It also uses some other projects.
wrt is a mostly-Perl static site generator, formerly known as Display.pm. This is the main thing, since it builds almost the entire site.
galleryhtml is a small python script for making HTML image galleries and thumbnails.
I'm experimenting with using git-annex to store large files like photos in only some copies of the repository.