Archives for p1k3, a website.
Brennen Bearnes ad8d5cce81 glitter positioning system 1 week ago
archives glitter positioning system 1 week ago
bin expand linkdump to 20 items 5 months ago
code.p1k3.com fiddle with code.p1k3.com index, putting some stuff in a list 3 months ago
files last night's doomed rss politicking 2 months ago
includes add includes/, includes/shortlinks.md 8 months ago
public fix .gitignore up for new public layout; add public/files symlink 2 years ago
templates link code in template 3 months ago
topics link code in template 3 months ago
.gitignore a config file & make target for building a previewable-in-lynx p1k3 8 months ago
Makefile update profile target 6 months ago
README.md add code.p1k3.com/ with some stub stuff for code listing 3 months ago
wrt-lynx-preview.json accumulate some changes from the last couple of weeks 4 months ago
wrt.json accumulate some changes from the last couple of weeks 4 months ago

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. (These will not be available unless they’ve been copied to the current clone of the repository.)

includes/ is for things that are reused in entries or templates with the <include> tag.

topics/ contains vimwiki pages which are used to describe various topics covered in the entries; these are combined with an automatically rendered list of tagged entries.

See https://code.p1k3.com/gitea/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 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.