Hakyll Website Manual

◀ ▶

Build

To build and run:

  • stack build Build the site generator
  • stack exec site build Generate the website (stored in _site)
  • stack exec site watch Dev server with live reload

After changes to Site.hs:

  • stack exec site rebuild

The site generator compiles Markdown posts and pages with Pandoc, applies templates, and outputs static HTML to _site/. Posts are dated by filename (YYYY-MM-DD-slug.md) and automatically sorted by date on the index and archive pages.

File Wathers

  • Check if running: ps aux | grep watch_and_deploy | grep -v grep
  • View log: tail -f /tmp/watch_and_deploy.log
  • Start watcher: vr watch
  • Stop watcher: vr kill

Older info

  1. refresh.sh - builds and starts Hakyll’s watch server on port 8000
  2. watch-archive.sh - watches /Users/carlson/Desktop/ARCHIVE and runs refresh.sh on changes

To run them:

Terminal 1: Start the site watcher

sh refresh.sh

Terminal 2: Start the archive watcher (watches Desktop/ARCHIVE)

sh watch-archive.sh

Note: watch-archive.sh watches /Users/carlson/Desktop/ARCHIVE. This is where the app The Archive stores its files.

For the website

If one of the tags #post, #diary, #memoir is present in a document, it is published to the blog, diary, or memoirs section of the web site. These three routes are protected by Cloudflare …