jekyll using standards 使用规范

jekyll using standards 使用规范

1. file命名格式：文章就是普通的文本文件，文件名假定为2012-08-25-hello-world.html。 (注意，文件名必须为"年-月-日-文章标题.后缀名"的格式。如果网页代码采用html格式，后缀名为html；如果采用markdown格式，后缀名为md。）

2. demo示例：在该文件中，填入以下内容：（注意，行首不能有空格）

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

3. 元数据：每篇文章的头部，必须有一个yaml文件头，用来设置一些元数据。 它用三根短划线"—"，标记开始和结束，里面每一行设置一种元数据。“layout:default”，表示该文章的模板使用_layouts目录下的default.html文件；“title: 你好，世界”，表示该文章的标题是"你好，世界"， 如果不设置这个值，默认使用嵌入文件名的标题，即"hello world"。

   每个页面都可以有自己的头信息，可以覆盖Jekyll和_config.yml里面的值

   ---
   layout: post
   title: 一步一步创建Jekyll主题
   categories: [jekyll github markdown rouge]
   date: 2016-9-3 15:47:05
   excerpt: ""   # 覆盖清掉文章的摘要
   pid: ""       # 新建一个pid的字符串变量
   ---
   

4. 使用模板变量

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

5. 发布

前置条件：本地已经安装了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

ps: 本地也需要安装builder工具，so 那为什么不用hexo？

文章参考:

阮一峰的网络日志

一步一步创建Jekyll主题