朋也的博客 » 首页 » 文章
使用jekyll搭建个人博客，托管在github pages上
作者：朋也
日期：2017-06-03
类别：杂项
版权声明：自由转载-非商用-非衍生-保持署名（创意共享3.0许可证）
安装
// 通用安装
// 依赖ruby，所有要先装上ruby
sudo gem install jekyll bundle
// ubuntu上安装
sudo apt install jekyll
常用命令
// 启动一个服务，会自动更新改动的，在书写博客的时候开着相当方便
jekyll serve
// 构建静态页面，会生成 _site 文件夹
jekyll build
目录介绍
| 名称 | 说明 | 用法 |
|---|---|---|
| _layouts | 布局文件 | 比如博客详情页面，在md文件头部要加上的 layout: post 就是用的 _layouts/post.html 页面 |
| _posts | 博客原文件目录 | 格式为 markdown 后缀的博客原文件所在目录 |
| _includes | 在页面里引入的页面 | 可以直接使用 include 引用 |
配置文件
jekyll 默认启动加载 _config.yml 文件，在页面里获取配置在 _config.yml 里的值用的是 site.xxx
比如，在 _config.yml 文件里加入一个变量 github_username: atjiu 那么在页面上就可以用 atjiu 来获取它的值
permalink: /:year/:month/:day/:title/ 表示访问博客的路径地址格式，比如 _posts/2017-06-03-hello.md 构建后的访问地址就是 /2017/06/03/hello/ 如果定成 permalink: /:title/ 那么访问地址就是 /hello/ 这里就有个问题，万一两个文件名字是一样的，就是前面的日期不同，那就会出现访问路径一样的现象，会不会报错，我没试过，不过如果带上日期，这样的概率就小多了，还是建议带上，这样在搜索引擎抓到页面后，路径上也有个时间，对需要的人也是一种帮助
博客的相关变量取值
| 变量 | 说明 |
|---|---|
post.title |
博客title |
post.content |
博客内容，已经将markdown转成html的内容 |
post.url |
博客地址，就是访问详情的地址 |
博客简介
可以在 _config.yml 里配置一个 excerpt_separator: "\n\n\n\n" 这里配置了四个换行，也可以换成其它的分割符号，然后在博客原文件里要分割的位置加上四个换行，就可以在列表里看到分割部分的内容了，这样如果一篇博客比较长的话，可以在博客前面写上简介，分割一下，看起来好看的多
列表分页
在 _config.yml 里配置上
gems: [jekyll-paginate]
paginate: 6
paginate 是每页要显示的条数
这样在页面里遍历就可以用 paginator.posts 来获取分页列表，如下
| 变量 | 说明 |
|---|---|
paginator.previous_page |
是否有前一页 |
paginator.next_page |
是否有上一页 |
paginator.page |
当前页 |
paginator.total_pages |
总页数 |
paginator.previous_page_path |
前一页的路径地址 |
paginator.next_page_path |
后一页的路径地址 |
分页地址是 /page + num 比如 /page1 表示第一页 /page4 表示第4页，所以最后一页就是 /page
模板语法
只介绍两种 if for
if用法
for用法
另外 for 里还可以设置偏移量，类似分页功能
Github Pages托管
将开发好的代码都push到github上就可以了，怎么push，可以百度一下，也可以fork本博客来改
注意事项
博客的文件名必须要写成 YEAR-MONTH-DAY-TITLE.md 就是 年-月-日-名称.md 如果不是这个，它不能解析
参考
本博客就是基于jekyll写的，所有上面提到的，在这个博客里都可以找到