笔记：使用 Github Page 搭建 Jekyll 个人 blog

部署方式

两种方法，基于不同的部署方式， 在 Github 上生成的站点 URL 会有所不同：

• USERNAME.github.io
• USERNAME.github.io/SITENAME

站点 URL 格式为 USERNAME.github.io 的部署

1. 在 Github 上新建一个名为 ‘USERNAME.github.io` 的 repo *（USERNAME 等同于自己的用户名）*；
2. 在本地新建一个 Jekyll 项目: jekyll new PROJECT；
3. 完成配置，推送至 Github：
   1. git remote add origin https://github.com/USERNAME/USERNAME.github.io.git
   2. git remote push origin master
4. 等待一段时间，五至十分钟左右，Github 会为你生成好静态网站，打开 USERNAME.github.io 就能访问。

站点 URL 格式为 USERNAME.github.io/PROJECT 的部署

1. 在本地新建一个 Jekyll 项目: jekyll new PROJECT；
2. 在 Github 新建一个 repo，repo 的名称便是之后完成部署，访问链接的 path：USERNAME.github.io/REPO_NAME；
3. 完成一般配置后，新建一个名为 gh-pages 的分支：git checkout -b gh-pages；
4. 推送至 Github，gh-pages 分支会被 Github 自动识别为所创建的 page；
5. 等待几分钟，访问 USERNAME.github.io/REPO_NAME 便可访问。

这种方法需要注意是：在根目录的 _config.yml 中需要修改 baseurl 字段的值，值要和新建的 REPO_NAME 的相对应，不然 CSS，IMAGE 等静态素材会报告 404 ERROR； *(比如我设置了一个 USERNAME.github.io/REPO_NAME，那么在这里就需要添加 baseurl: /REPO_NAME )*。

Tips

1. 使用 _drafts 文件夹管理草稿

因为 jekyll new PROJECT 后 Jekyll 默认创建的文件目录中不包含 _drafts ，所以需要手动在根目录创建一个名为 _drafts 的文件夹：

• 运行 jekyll serve 的时候 Jekyll 会自动忽略此文件夹;
• 如果需要预览草稿内容，可以运行 jekyll serve --drafts 命令。

2. 在 blog 文件中使用图片文件

官方在这里给出了办法:

• 在更目录下新建 assets 或者 downloads 文件夹;
• 文章中使用类似这样 ![My helpful screenshot]({{ site.url }}/assets/screenshot.jpg) 的 URL 来切图图片。

⚠️ 没有一篇可以简单搜索到的文档对「Jekyll 中以下划线开头的文件夹或者图片都会成为不合法的相对路径」有过任何记载，比如 _images/_image.jpg 是完全不能在页面中正确显示的。

3. 使用 Google Analytics

可以直接参考这篇，非常详细：Google Analytics for Jekyll

遇到的一些问题：

使用 Disqus 作为评论区 http 与 https 之间切换的问题

在 http 和 https 之间切换，显示的问题不同，具体情况描述可以参考这篇博客文章 Force HTTPS with Github Pages 和 相关的问题解决的讨论：这里 和 这里