Homepage Editing Guide

这个首页现在主要靠一个文件维护：

/_data/homepage.yml

如果你以后要更新内容，优先只改这个文件。绝大多数情况下，你不需要改 HTML、CSS 或 Jekyll 模板。

你以后修改首页，最推荐的实际流程

每次都按下面做：

打开 /_data/homepage.yml
修改你要更新的文字、链接、论文或新闻
如果有新图片，把图片放进 /images/
如果有新 CV，把文件替换成 /files/CV_en.pdf
运行本地预览：

./scripts/preview-local.sh

打开 http://127.0.0.1:4000/ 检查页面
如果效果正确，再提交或推送到 GitHub

如果你只是更新内容，通常不需要改这些文件：

/_includes/homepage.html
/_layouts/homepage.html
scripts/preview-local.sh

最常见的更新

1. 改个人简介

找到：

about:
  paragraphs:
    - "第一段"
    - "第二段"

直接修改引号里的文字即可。一段就是一行 - "..."。

2. 改邮箱、GitHub、Google Scholar

找到：

hero:
  socials:

和：

about:
  info:

把对应的 href 或 value 改掉即可。

2.1 改首页最上方那一行身份信息

找到：

hero:
  eyebrow: "..."
  role_cn: "..."
  role_en: "..."

这 3 个字段分别控制：

eyebrow：姓名上方的小字
role_cn：中文单位行
role_en：英文单位行

3. 新增一条新闻

找到：

news:
  items:

照着已有格式复制一条：

    - date: "2026.03"
      text: "你的新消息写在这里。"

4. 新增一篇论文

找到：

publications:
  items:

复制一篇已有论文，改这些字段：

    - year: "2026"
      category: "llm"
      title: "论文标题"
      venue: "会议或期刊"
      tags:
        - "标签1"
        - "标签2"
      links:
        - label: "Paper"
          href: "https://..."
      image: "/images/你的图片文件名.jpg"

默认首页先显示前 4 篇论文，点击 More 会展开全部。

如果你以后想改默认显示数量，修改：

publications:
  initial_visible: 4

如果你想修改 More / Less 按钮文案，改这里：

publications:
  more_label: "More"
  less_label: "Less"

图片怎么换

头像和论文配图放在：

/images/

然后在 /_data/homepage.yml 里把路径改成：

/images/xxx.jpg

例如：

photo: "/images/profile.jpg"

CV 文件

当前首页下载按钮使用的是：

/files/CV_en.pdf

如果以后你想换新的英文 CV，直接把新文件替换成同名文件即可。

如果你想换成别的文件名，也可以改：

cv:
  file: "/files/CV_en.pdf"

哪些内容已经被隐藏

这次首页里已经去掉了：

Teaching
Join Us
首屏里的招生按钮
教学版块
招生版块

如果以后你想重新启用，不建议自己改模板，直接告诉我加回去会更稳。

一个最简单的维护原则

以后优先只做这两件事：

改 /_data/homepage.yml
把新图片放到 /images/

只要不碰 /_includes/homepage.html，页面样式基本不会坏。

本地预览

如果你想在浏览器里先看效果，再决定是否提交，运行：

./scripts/preview-local.sh

然后打开：

http://127.0.0.1:4000/

说明：

这个脚本会把当前站点同步到 /tmp/lihaogx-preview-copy
会自动安装本地预览需要的 Ruby 依赖
会在无空格目录里启动 Jekyll，避免本机 Ruby gem 编译踩路径问题

如果你想换端口，比如 4001：

./scripts/preview-local.sh 4001

如果你想发布到线上

本地看起来没问题后，通常只需要：

git add .
git commit -m "update homepage content"
git push

如果你的 GitHub Pages 已经连接这个仓库，推送后会自动发布。

Li Hao