前前后后花了五六天时间把个人学术网站和博客建好了,记录一下需要注意的事项以方便后续使用。
基本使用方法
-
二者都是基于GitHub Pages和Jekyll的,但使用了不同的模版。
-
后期使用基本上是在本地以markdown更新相关文件,然后使用GitHub Desktop 将更新commit到GitHub上去,网站便可更新内容。
-
可以在本地修改后先行查看网站效果然后再commit到GitHub中。方法是在本地的网站文件夹上打开终端,然后运行下述命令:
bundle exec jekyll serve
随后即可在浏览器中打开网址 “localhost:4000”查看。
-
所有更新应及时push到GitHub。
博客
- 网址: ybzhao.me/blog
- 包括如下页面:
- ‘首页’:博客首页;
- ‘分类’:按文章类别分类的博客页面;
- ‘归档’:按年份归档的博客页面;
- ‘关于’:一些链接;
- 内容更新:将新的markdown文章放到 ‘_post’ 文件夹内,可按类别选择不同的子文件夹。文件需满足命名要求(日期+标题),并写好头信息。一般应从模版开始写作。
- 博客更新: 本地更新commit到GitHub后博客即自动更新。
个人学术网站
-
网址: ybzhao.me
-
包括如下页面:
- ‘about’: 个人基本介绍和新闻;
- ‘projects’: 研究项目介绍;
- ‘publications’: 论文列表;
- ‘students’: 学生信息;
- ‘teaching’: 教学课程信息;
- ‘博客’: 链接到中文博客
-
内容更新:
- publications: 将论文bibtex文件命名为 papers.bib,专利bibtex文件命名为patents.bib,均放入到 ‘_bibliography’ 文件夹;为了学生页面相关域的更新,论文和专利bibtex文件需要在keywords中标注学生作者中文姓名;将相关 pdf 文件放入到 ‘assests/pdf’ 文件夹;需要放到selected中的论文设置’rating=5’;
- projects:将项目介绍文件放到 ‘projects’ 文件夹;
- students: 将学生介绍文件放到’_students’ 文件夹;填写头信息即可,正文模版无需改动;将学生铭牌图片放到assets相关文件夹;
- teaching: 将课程介绍文件放到’_teaching’ 文件夹;填写头信息即可,正文模版无需改动;教材或介绍图片放到assets相关文件夹,设定大小640像素;
- news: 将新闻文件放到 ‘_news’文件夹;
-
网站更新: 为了满足自动生成publication list的需求,个人学术网站使用了GitHub Pages不支持的插件Jekyll-Scholar。个人学术网站的更新需要在本地编译。方法是在本地的网站文件夹上打开终端,然后运行下述命令:
./bin/deploy --user
使用 ‘- - user’ 选项的原因是源代码部署在GitHub的 ‘source’ branch, 而网站材料在 ‘master’ branch。