CLAUDE.md — champost.github.io

Project Overview

Personal website for ambre-loiseau.fr hosted on GitHub Pages using the Minimal Mistakes Jekyll theme (remote theme method).

• Repository: champost/champost.github.io (user GitHub Pages site)
• Custom domain: www.ambre-loiseau.fr (primary), ambre-loiseau.fr (redirects to www)
• Redirect: loisambre.fr and www.loisambre.fr → 301 redirect to www.ambre-loiseau.fr
• Branch: master (deploy from branch, root)
• Theme: Minimal Mistakes v4.28.0 via jekyll-remote-theme
• Aesthetic inspiration: Quinn Daedal’s site (https://quinndaedal.com/)

DNS & Domain (completed)

• 4 A records → GitHub Pages IPs (185.199.108–111.153)
• CNAME www → champost.github.io
• Domain verification TXT record (_github-pages-challenge-champost) in place
• Enforce HTTPS: enabled
• CNAME file contains www.ambre-loiseau.fr

Architecture

GitHub Pages natively builds Jekyll on push — no GitHub Actions workflow needed. The remote theme method pulls Minimal Mistakes layouts/includes/assets at build time.

Key files

_config.yml          # Jekyll + Minimal Mistakes configuration
Gemfile              # Ruby dependencies (github-pages gem)
index.html           # Home page (splash layout with feature_row)
CNAME                # Custom domain pointer
.gitignore           # Ignore _site, .sass-cache, Gemfile.lock
_data/
  navigation.yml     # Top nav bar links (About, CV, Projects, Blog)
_pages/
  about.md           # About page
  cv.md              # CV page (with table of contents)
  projects.md        # Projects listing (collection grid)
  blog.md            # Blog listing (paginated posts)
  404.md             # Custom 404 page
_posts/              # Blog posts (YYYY-MM-DD-title.md)
_projects/           # Project collection items
assets/images/       # Images (bio photo, header, teasers, etc.)

Site Structure (modeled after quinndaedal.com)

Navigation

About | CV | Projects | Blog

Home page (index.html)

• Splash layout with header image + tagline
• Feature row: 3 image cards linking to About, Projects, Blog
• Recent Posts list (latest 3)

Pages

• About — Single page bio
• CV — Detailed CV with sticky table of contents (Education, Work, Publications, Talks, Awards, Languages)
• Projects — Grid layout showing _projects collection items with teaser images
• Blog — Paginated list of _posts

Content to replace

All placeholder text is marked with [brackets]. Replace with your own:

• [Your tagline here] — in _config.yml (author.bio) and index.html (excerpt)
• [Write your bio here] — in _pages/about.md
• CV sections — in _pages/cv.md
• Project descriptions — in _projects/*.md
• Blog posts — in _posts/*.md
• Images — add to assets/images/ (see list below)

Images needed

assets/images/bio-photo.jpg          # Author avatar (used in sidebar if enabled)
assets/images/header-home.jpg        # Home page splash header
assets/images/frontpage-about.jpg    # Feature row card: About
assets/images/frontpage-projects.jpg # Feature row card: Projects
assets/images/frontpage-blog.jpg     # Feature row card: Blog
assets/images/project-one-teaser.jpg # Project grid teaser
assets/images/project-two-teaser.jpg # Project grid teaser

Setup Plan

1. Fix HTML structure → replaced with Jekyll/MM scaffold
2. Create _config.yml with remote_theme: mmistakes/minimal-mistakes@4.28.0
3. Create Gemfile for github-pages gem
4. Create .gitignore
5. Create index.html (splash layout with feature_row + recent posts)
6. Create _data/navigation.yml (About, CV, Projects, Blog)
7. Create _pages/about.md, _pages/cv.md, _pages/projects.md, _pages/blog.md, _pages/404.md
8. Create _projects/ collection with sample items
9. Create _posts/ with sample blog posts
10. Replace placeholder content with your own text
11. Add images to assets/images/
12. Choose MM skin (default, dark, air, dirt, mint, sunrise, etc.)
13. Local testing with bundle exec jekyll serve
14. Push and verify live site

Local Development

Only dependency: Podman (rootless). No Ruby/Node.js on the host.

bash dev.sh

• Builds container image from .devcontainer/Dockerfile (cached after first run)
• Gems are pre-installed in the image via COPY Gemfile + bundle install
• Jekyll serves on http://localhost:4000 with live reload (port 35729)
• _config.yml changes require restarting dev.sh
• If Gemfile changes, podman build detects the changed layer and re-runs bundle install

Dev workflow (single VS Code window)

1. Terminal: bash dev.sh — shows Jekyll build/serve log
2. Integrated browser: http://localhost:4000 — live preview
3. Editor: workspace files for manual edits
4. GitHub Copilot chat: AI-assisted changes

Alternative: VS Code Dev Container

Use “Reopen in Container” from Command Palette. Uses same .devcontainer/ config. Note: Copilot chat history does not carry over between host and container sessions.

Useful References

• Minimal Mistakes docs: https://mmistakes.github.io/minimal-mistakes/docs/quick-start-guide/
• MM configuration: https://mmistakes.github.io/minimal-mistakes/docs/configuration/
• MM layouts: https://mmistakes.github.io/minimal-mistakes/docs/layouts/
• MM starter repo: https://github.com/mmistakes/mm-github-pages-starter
• GitHub Pages + Jekyll: https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll