jekyll using standards 使用规范

file命名格式:文章就是普通的文本文件,文件名假定为2012-08-25-hello-world.html。

(注意,文件名必须为"年-月-日-文章标题.后缀名"的格式。如果网页代码采用html格式,后缀名为html;如果采用markdown格式,后缀名为md。)

demo示例:在该文件中,填入以下内容:(注意,行首不能有空格)

    ---
    layout: default
    title: 你好,世界
    ---
    <h2>{{ page.title }}</h2>
    <p>我的第一篇文章</p>
    <p>{{ page.date | date_to_string }}</p>

元数据:每篇文章的头部,必须有一个yaml文件头,用来设置一些元数据。

它用三根短划线"---",标记开始和结束,里面每一行设置一种元数据。
"layout:default",表示该文章的模板使用_layouts目录下的default.html文件;
"title: 你好,世界",表示该文章的标题是"你好,世界",
如果不设置这个值,默认使用嵌入文件名的标题,即"hello world"。
每个页面都可以有自己的头信息,可以覆盖Jekyll和_config.yml里面的值
</ol>
<hr />
<p>layout: post
title: 一步一步创建Jekyll主题
categories: [jekyll github markdown rouge]
date: 2016-9-3 15:47:05
excerpt: "" # 覆盖清掉文章的摘要
pid: "" # 新建一个pid的字符串变量
<hr />

使用模板变量

在yaml文件头后面,就是文章的正式内容,里面可以使用模板变量。
{{ page.title }}就是文件头中设置的"你好,世界",
{{ page.date }}则是嵌入文件名的日期(也可以在文件头重新定义date变量),"| date_to_string"表示将page.date变量转化成人类可读的格式。

发布

前置条件:本地已经安装了jekyll程序。
本地安装jekyll
sudo gem install jekyll
本地预览:jekyll serve
gh-pages分支push jekyll源文件
master分支push `jekyll build` 后_site文件夹中的文件
GitHub pages服务器并不会自动帮你发布,也不会额外处理什么。

注意

config中baseurl根目录不要添加/,post.url解析出来的格式为 /2016/07/25/VPS.html

文章参考:

阮一峰的网络日志

一步一步创建Jekyll主题