内容更新说明

这个仓库现在已经是个人主页站点，线上地址是：

https://mbjinx.github.io/

后续更新时，按下面这个位置改就可以，不需要到处找文件。

1. 文字内容改哪里

首页主要内容

首页结构文件：

_pages/about.md

这个文件控制首页有哪些区块，比如：

• Papers
• Links
• Photos

一般不需要经常改结构，除非你想新增一个新板块。

首页数据

首页实际展示的数据文件：

_data/profile.yml

这个文件是最常改的，主要内容都在这里：

• name：主页名字
• interests：兴趣标签
• resumes：简历按钮和链接
• papers：论文标题和顺序
• links：外部主页链接
• portrait：首页头像
• photos：照片列表

如果你要改论文顺序、论文标题、链接名字、按钮名字，直接改这个文件就行。

2. 文件放哪里

头像

放这里：

images/profile/

当前首页头像文件：

images/profile/ming-ma-portrait.jpg

如果你只是想替换头像，最省事的方法是直接用同名文件覆盖。

生活照片

放这里：

images/life/

比如滑板照片就放在这里。

摄影作品

放这里：

images/photography/

如果你新增照片，记得同时把路径补到：

_data/profile.yml 的 photos 里。

简历

放这里：

files/cv/

当前使用中的文件：

• files/cv/ma-ming-cv-zh.pdf
• files/cv/ming-ma-cv-en.pdf

如果只是替换简历，建议直接覆盖同名文件，这样页面链接不用改。

3. 最常见的更新方式

更新论文

编辑：

_data/profile.yml

找到 papers:，按下面格式增删或调整顺序：

papers:
  - title: "Paper Title"
    url: https://example.com

更新外部链接

编辑：

_data/profile.yml

找到 links:，按下面格式修改：

links:
  - label: GitHub
    note: Code and projects
    url: https://github.com/MBJinX

更新照片

1. 把图片放进 images/life/ 或 images/photography/
2. 再去改 _data/profile.yml 里的 photos:

格式：

photos:
  - title: Photo Title
    url: /images/photography/example.jpg

更新简历

如果你直接替换文件，推荐保持文件名不变：

• files/cv/ma-ming-cv-zh.pdf
• files/cv/ming-ma-cv-en.pdf

如果你改了文件名，就要同步修改：

_data/profile.yml 里的 resumes:

4. 本地启动和预览

第一次启动或依赖有变动时

先安装依赖：

bundle install

本地构建检查

先跑一次构建，确认站点没有报错：

bundle exec jekyll build

启动本地预览

在项目根目录运行：

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

然后打开：

http://127.0.0.1:4000/

停止本地服务

在运行中的终端里按：

Ctrl + C

常用本地命令汇总

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

5. 上传发布

改完后执行：

git add .
git commit -m "Update homepage content"
git push origin master

推送到 GitHub 后，GitHub Pages 会自动更新站点。