Lighthouse

Lighthouse is the Jekyll source repository for peisongxiao.com. It contains the manually curated site pages, the photo collection, shared layouts, and the automation-owned _automated_posts/ area populated by the deployment pipeline.

Table of Contents

• Docs
• Repository Layout
• Local Development
• Automation Boundary

Docs

• Start here: docs/quickstart.md The shortest path to install dependencies, build the site, and preview it locally.
• Design: docs/design.md Site architecture, content model, and the boundary between hand-authored and automated content.
• Configuration: docs/configuration.md Jekyll configuration, collections, shared data files, and build exclusions.

Repository Layout

• _layouts/: shared Jekyll layouts
• _includes/: shared partials
• _data/: navigation and site metadata
• _photos/: hand-authored photo entries
• _automated_posts/: machine-owned blog content
• assets/: site CSS, JS, imported media, and generated assets

Local Development

Install gems and serve locally:

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

Build once without serving:

bundle exec jekyll build

The generated site is written into _site/.

Automation Boundary

Lighthouse is intentionally split between:

• manually curated content and layout files stored directly in this repository
• deployment-managed content generated into _automated_posts/ and assets/generated/

The deployment pipeline lives in the separate ../lighthouse-cli/ project and owns the automation-managed directories.