Archives for p1k3, a website.
HTML Visual Basic Perl TeX CSS Python Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
archives
bin
files
public
templates
.gitignore
Makefile
README.md
wrt.json

README.md

p1k3.com

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.

bin/ contains various utility scripts for manipulating the contents of /archives. (For example, a script to generate the linkdump from a couple of RSS feeds.) They are generally invoked from the Makefile.

templates/ contains template files.

public/ is mostly a target for rendering public files in.

files/ contains large static files, stored with git-annex.

See https://github.com/brennen/wrt for the tools I use to render the entries here.

dependencies

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 Makefile 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

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

gallery-html is a small python script for making HTML image galleries and thumbnails.

git-annex

I'm experimenting with using git-annex to store large files like photos in only some copies of the repository.