JoelDueck.com Source: Top-level Files of tip

Files in the top-level directory from the latest check-in

.fossil-settings
static
web-pages
writing
feed.rkt
info.rkt
main.rkt
makefile
publish_excludes.txt
README.md
render-page.rkt
start-server
tools.rkt

This repo contains the source code for the site published at https://joeldueck.com.

Tour

This site uses Punct along with a few tricks and tools to make a very pleasant, snappy little blog.

main.rkt contains custom elements for this site.
feed.rkt builds the Atom feed.
render-page.rkt provides a script/template for rendering pages to HTML.
*.page.rkt — individual page sources.

Racket setup

Install Punct, Splitflap, HTML5 Printer and raco-static-web.

The info.rkt file allows me to install the project as a Racket package:

❯ raco pkg install --link .

This makes this folder’s main.rkt accessible via the jdcom module path. So Punct files starting with #lang punct jdcom will bring in the bindings provided by main.rkt.

Makefile

The makefile provides a nice interface to the project:

❯ make
help            Displays this help screen
publish         Sync all content to the web server (does not rebuild any files)
web             Rebuild all web pages
zap             Clear Racket compile cache, and remove all HTML output

On my M1 Mac, make zap && make web -j 8 does a complete rebuild in a couple of seconds.

Local web server

The start_server script starts up a local web server, while also spawning a background process that runs make web every time a file in the project folder is edited.

To make use of this script, you’ll need to have fswatch and raco-static-web installed.