网站维护手册

这个仓库是一个基于 Jekyll 的个人学术主页。日常维护主要改下面这些位置：

站点和个人基础信息：_config.yml
首页内容：_pages/about.md
论文条目：_publications/*.md
PDF 和可下载文件：files/
图片和头像：images/
视觉样式：_sass/
自定义鼠标指针：assets/js/roxy-cursor.js

本地预览

推荐先用轻量预览：

npm run preview

或：

node scripts/live_preview.js

打开：

http://localhost:4000/

这个预览服务器会读取已有的 _site HTML，并在每次请求 main.css 时重新编译 _sass，所以适合检查：

颜色
背景
间距
卡片样式
图片资源
自定义鼠标指针

如果端口 4000 被占用：

PREVIEW_PORT=4001 node scripts/live_preview.js

注意：轻量预览不会重新生成 Markdown / Liquid 页面。如果修改了 _pages/about.md、_publications/*.md 或 _config.yml，需要使用完整 Jekyll 预览：

bundle exec jekyll serve -l -H localhost

如果本机有 Docker，可以运行：

docker compose up

修改个人基础信息

编辑 _config.yml。

常用字段：

title: "Kairong Guo"
name: "Kairong Guo"
description: "PhD Student @ PKU. Research in EDA (Physical & Custom Design)."

author:
  avatar: "profile.jpg"
  name: "Kairong Guo"
  bio: "PhD Student @ PKU. Research in EDA (Physical & Custom Design)."
  location: "Beijing, China"
  employer: "Peking University"
  email: "krguo25@stu.pku.edu.cn"
  googlescholar: "https://scholar.google.com/citations?user=KbXiOSYAAAAJ"
  orcid: "https://orcid.org/0009-0000-1540-4209"
  github: "MaverickGuo"

如果要换头像，把新图片放到 images/，再修改：

author:
  avatar: "new-photo.jpg"

修改首页文字

编辑 _pages/about.md。

首页开头介绍在这里：

<p class="home-intro__kicker">EDA for next-generation integrated-circuit design</p>
<p class="home-intro__lead">
  I am currently a Ph.D. student ...
</p>

研究方向标签在这里：

<div class="research-pills" aria-label="Research areas">
  <span>Standard-cell layout synthesis</span>
  <span>DTCO for emerging devices</span>
</div>

中文名卡片在这里：

<div class="nameplate" aria-label="Chinese name">
  <span class="nameplate__label">My Chinese name is</span>
  <span class="nameplate__romanization">Guo Kairong</span>
  <span class="nameplate__glyphs" lang="zh-Hans">郭铠荣</span>
</div>

添加论文

把 PDF 放到 files/，例如：

files/MyPaper_DAC2027.pdf

在 _publications/ 里新建 Markdown 文件，例如：

_publications/DAC27.md

使用下面模板：

---
title: "Paper Title Here"
collection: publications
category: conferences
permalink: /publication/DAC27-PaperShortName
date: 2027-07-01
venue: "64th Design Automation Conference (DAC), 2027"
paperurl: "/files/MyPaper_DAC2027.pdf"
authors: "First Author, <strong>Kairong Guo</strong>, Other Author"
author_note: "<sup>†</sup> Equal contribution."
---

字段说明：

category: conferences：会议论文
category: journals：期刊论文
date：用于排序
paperurl：PDF 链接
authors：作者列表，可以用 <strong>Kairong Guo</strong> 加粗自己的名字
author_note：作者贡献说明，没有就删掉这一行

首页会从 _publications/ 自动读取论文，并按时间排序。

修改论文显示样式

首页论文列表生成逻辑在：

_pages/about.md

论文卡片样式在：

_sass/layout/_page.scss

常用选择器：

.publication-list
.publication-item
.publication-item__index
.publication-link

修改颜色和背景

亮色主题变量：

_sass/theme/_default_light.scss

暗色主题变量：

_sass/theme/_default_dark.scss

常用变量：

--global-bg-color
--global-surface-color
--global-link-color
--global-accent-color
--global-accent-warm-color
--global-shadow-color

页面基础背景在：

_sass/layout/_base.scss

首页、论文卡片、教育经历卡片、中文名卡片样式在：

_sass/layout/_page.scss

修改自定义鼠标指针

脚本位置：

assets/js/roxy-cursor.js

动画帧目录：

assets/cursors/roxy-pointer/
assets/cursors/roxy-link/
assets/cursors/roxy-text/

脚本提供：

RoxyCursor.init({
  cursorRoot: "/assets/cursors/",
  size: 27,
  frameDelay: 90
});

当前站点在 _includes/footer/custom.html 中自动加载该脚本。

发布到远端

常用流程：

git status
git add path/to/changed-file
git commit -m "Describe the change"
git push origin master

推送后 GitHub Pages 会自动构建线上站点。