Website Edit Guide

这份说明用于以后快速修改本站。项目根目录是：

/Users/qingyu/Desktop/github/QingyuLiu0521.github.io

最常改的文件

修改首页各板块

首页内容都在：

_pages/about.md

当前主要板块：

新增一个板块时：

1. 在 _pages/about.md 里新增标题，例如 # News。
2. 在标题附近加锚点，例如 <span class='anchor' id='news'></span>。
3. 如果希望顶部导航出现它，再改 _data/navigation.yml，加 url: "/#news"。

修改侧边栏

侧边栏资料来自：

_config.yml

主要改这里：

author:
  name: "Qingyu Liu (刘庆宇)"
  avatar: "images/QingyuLiu_images.jpg"
  bio: "Johns Hopkins University"
  location: "Baltimore, MD, USA"
  employer: "CLSP, Johns Hopkins University"
  email: "qliu91@jh.edu"
  uri: "https://qingyuliu0521.github.io/"
  github: "QingyuLiu0521"

如果要换头像：

1. 把新图片放进 images/。
2. 修改 avatar: 路径，例如 avatar: "images/new-avatar.jpg"。

修改顶部导航栏

顶部导航在：

_data/navigation.yml

格式示例：

main:
  - title: "Publications"
    url: "/#publications"

title 是导航显示的文字，url 是跳转位置。url 里的 #publications 要和 _pages/about.md 里的 id='publications' 对应。

添加论文或项目链接

论文列表在：

_pages/about.md 的 # Publications 部分

PDF、Poster、CV 这类本地文件放在：

assets/

Markdown 链接写法：

[[PDF](assets/example.pdf)] [[Code](https://github.com/example/repo)]

本地预览

在项目目录运行：

bundle exec jekyll serve --host 127.0.0.1 --port 4000 --livereload

然后打开：

http://127.0.0.1:4000

如果 shell 没有使用 rbenv 的 Ruby，可以先运行：

eval "$(rbenv init - zsh)"

不建议直接改的文件

这些是模板框架文件，除非你要改布局结构，否则先别动：

打开和关闭本地预览

如果想在本地查看网页效果，先进入项目目录：

cd /Users/qingyu/Desktop/github/QingyuLiu0521.github.io

如果你的终端没有自动使用 rbenv 的 Ruby，先输入：

eval "$(rbenv init - zsh)"

然后启动本地预览：

bundle exec jekyll serve --host 127.0.0.1 --port 4000 --livereload

启动成功后，在浏览器输入这个链接查看网页：

http://127.0.0.1:4000

如果看到类似下面的信息，就说明启动成功：

Server address: http://127.0.0.1:4000
Server running... press ctrl-c to stop.

关闭本地预览的方法：

在运行 jekyll serve 的终端窗口里按：

Control + C

也就是键盘上的 Ctrl 和 C 同时按下。关闭后，再访问 http://127.0.0.1:4000 就不会打开网页了。

如果忘记在哪个终端启动了服务，可以用下面命令查找占用 4000 端口的进程：

lsof -nP -iTCP:4000 -sTCP:LISTEN

如果确认要强制关闭，把查到的 PID 替换进下面命令：

kill PID