This repository contains the source for my personal academic website, built with Jekyll and GitHub Pages. It customizes the Minimal Light theme with a new layout and visual system while keeping content in Markdown/HTML includes.
- Jekyll (GitHub Pages compatible)
- Remote theme:
yaoyao-liu/minimal-light - Custom layout:
_layouts/default.html - Styling:
_sass/minimal-light.scsscompiled viaassets/css/style.scss - Content:
index.mdwith section includes under_includes/
- Install Ruby (with Bundler) and Jekyll.
- Install dependencies:
bundle install - Run locally:
bundle exec jekyll serve --livereload - Build:
bundle exec jekyll build(output in_site/)
index.md— landing page content and section ordering_layouts/default.html— page shell, navigation, and theme toggle_sass/minimal-light.scss— design tokens, layout, and component styles_includes/— section content (publications, teaching, talks, etc.)assets/— images, downloads, and JS (assets/js/theme.jsfor theme toggle)_config.yml— site metadata and links
- Update site metadata in
_config.yml(title, role, links, analytics). - Tweak colors, typography, and spacing in
_sass/minimal-light.scss(seeDESIGN_NOTES.md). - Edit content directly in
index.mdor the partials in_includes/.
The site is set up for GitHub Pages. Pushing to main will trigger the Pages build using the remote theme and this repository’s overrides.
- Primary check:
bundle exec jekyll build - Manual: open
_site/index.htmlor runbundle exec jekyll serveand verify navigation, links, and responsive layout.