CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is Yujie Guo’s academic personal homepage, built on the AcadHomepage Jekyll template and hosted via GitHub Pages at guoyujie.cn (custom domain).

Common Commands

  • bash run_server.sh — Start the local Jekyll dev server with livereload
  • bundle exec jekyll serve — Alternative if run_server.sh isn’t available

Architecture

_pages/about.md       # Main page content (the homepage body)
_pages/about.css      # Custom CSS for logo grids and layout
_config.yml           # Site config (author info, social links, analytics, Google Scholar)
_data/navigation.yml  # Top nav bar links
_layouts/default.html # Main HTML layout
_includes/            # Reusable HTML partials (sidebar, head, nav, seo, analytics)
_sass/                # SCSS partials (Susy grid, Breakpoint, Font Awesome)
assets/               # Compiled CSS, JS, fonts
images/               # Profile photo, logos, favicon icons
files/                # Static files (video, template backup)

Key Configuration Details

  • The site uses the github-pages ~> 228 gem (Gemfile) — production dependencies match GitHub Pages’ environment
  • MathJax 2.7.4 is loaded in _includes/head/custom.html for LaTeX rendering
  • HTML compression is enabled in production via compress_html in _config.yml
  • Timezone is Asia/Shanghai
  • Google Analytics tracking ID is in _config.yml under analytics.google.tracking_id
  • The Google Scholar crawler (google_scholar_crawler/) is present but not configured — the googlescholar URL and GitHub repo fields in _config.yml are empty
  • _site/ (built output) is committed to the repo — it’s the deployed artifact on GitHub Pages

Editing Content

  • Page sections: Edit _pages/about.md (Markdown + HTML)
  • Navigation: Edit _data/navigation.yml — currently Publications and News are commented out
  • Author/social info: Edit _config.yml under the author section
  • Styling: Edit _pages/about.css for page-specific styles, or _sass/ for global styles