This document describes the repository-local configuration and content conventions used by the Lighthouse site.

Table of Contents

Jekyll Config

The canonical site configuration is:

Important settings include:

  • title, description, timezone
  • markdown: kramdown
  • permalink: pretty
  • collection output for photos and automated_posts

Collections

Current collections:

  • photos Source: _photos/ Layout default: photo
  • automated_posts Source: _automated_posts/ Layout default: page

The automated_posts collection is machine-owned and should not be edited manually.

Shared Data

Shared site metadata and navigation live under _data/:

These files feed the site header, footer, and homepage content blocks.

Automation-Owned Paths

The deployment pipeline may rewrite the following paths on every run:

  • _automated_posts/
  • assets/generated/

All other paths are treated as manual source by default.

Build Exclusions

The repository excludes non-public paths from the Jekyll build through _config.yml. That exclusion list currently covers:

  • docs and repo-only notes
  • vendored dependencies
  • Git metadata
  • Bundler local state