Lighthouse Quickstart

This is the shortest path from a fresh checkout to a local preview of the site.

Table of Contents

• Requirements
• Install Dependencies
• Build
• Serve Locally
• More Reading

Requirements

• Ruby and Bundler
• the dependencies listed in Gemfile
• make4ht and latexmk if you want locally generated resume artifacts

Install Dependencies

From the repository root:

bundle install

If you are preparing an Ubuntu host, see the top-level helper script in ../../ubuntu-install-deps.sh.

Build

Generate the static site into _site/:

bundle exec jekyll build

That direct Jekyll build path works for hand-maintained site pages. If you want the machine-owned _automated_posts/, generated-directories/, generated RSS policy under _data/generated/, or generated resume artifacts refreshed first, run the build through lighthouse-cli instead.

Serve Locally

Run the Jekyll development server:

bundle exec jekyll serve --host 127.0.0.1 --port 4000

Open:

http://127.0.0.1:4000/

More Reading

• docs/design.md
• docs/configuration.md
• ../_config.yml