~akarle/alexkarle.com

My personal site

d849b56 build: Move generated sed link fixer to its own script

a day ago

4737d3c uses: Update for latest tools and text.alexkarle.com

a day ago

#alexkarle.com

My small corner of the internet.

#www.

A static site comprised of mdoc(7) flavored man pages, built to HTML via mandoc(1) (managed by make(1)).

Currently hosted with OpenBSD's httpd(8), but any web server should be able to serve it up.

The Makefile to build the HTML is portable between gmake and BSD make. On OpenBSD, running make obj is recommended before running make to leverage the out-of-tree build extension (see the bit about .OBJDIR in the man page!).

#text.

A pure ascii dump of the mdoc(7) content of the www site, served over HTTP, HTTPS, and Gopher (by httpd(8) and gophernicus(1) respectively!

Builds via make(1) at the same time as the HTML. See above for instructions.

#git.

I use a simple setup of git-daemon for anonymous (read-only) downloads, ssh+git for read+write access (limited to myself) and stagit(1) to host static views into the diffs and files of each repo.

I like the stagit approach in that it is simple, modular, and emphasizes the use of regular git for larger operations (i.e. diff between refs, etc).

I use the default post-receive and create scripts that ship with the tool (with small modifications for the installation). The logo is in this repo as logo.png.

The content, being static, is served up with httpd(8) as well.

I also discuss the setup in my blog posts self-hosted(7) and my-old-man(7).