Hello Blog

这是对markdown语法和yaml头部以及本blog的css类的一点记录

yaml头部说明以及表格

key	value
layout	模版，文章则写post
title	标题
category	分类
tag	标签(暂时没用到)
description	描述(没用到)
frontImage	头部图片，满父框的宽且置于标题之上的顶部
place	in 地点
published	是否发布

要写代码则这样

<div class="tip">
	<p>这是对markdown语法和yaml头部以及本blog的css类的一点记录</p>
</div>

	{ % highlight 语法 %}
	<div class="tip">
		<p>自定义的和blockquote类似的样式,因为blockquote的样式是引用，这个用作自己的提示</p>
	</div>
	{ % endhighlight %}
	

注：’{’ 和 ’%’ 之间没有空格，为了防止被转换只好这样写了

分割线

分割线的语法只需要三个 * 号，例如：

---

粗体与斜体

Markdown 的粗体和斜体也非常简单，用两个 * 包含一段文本就是粗体的语法，用一个 * 包含一段文本就是斜体的语法。

例如: 这里是斜体 这是粗体

图片与链接

插入链接与插入图片的语法很像，区别在一个 !号

图片为：![]()

链接为：[]()

由于一些样式需求，如需要满框则要加上class='full-width'

普通的图片插入，和左右边有margin

满宽的图片插入，紧贴左右边，小图会被强制拉伸

其他

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：

同时，下面也是一个普通pre的示例，只需要以 ``` 开头以 ``` 结尾，且内部行均用tab制表符开头

	\   反斜线
	`   反引号
	*   星号
	_   底线
	{}  花括号
	[]  方括号
	()  括弧
	#   井字号
	+   加号
	-   减号
	.   英文句点
	!   惊叹号

类别为中文时问题

Windows下，使用UTF-8编码时当category为中文时，在通过url进入文章时，会出现如下错误

Internal Server Error “\xAE\xBE” from GBK to UTF-8

首先介绍一下jekyll的Permalinks这个配置，这个配置定义了文章被jekyll处理后生成结果的最终路径，默认为 /:categories/:year/:month/:day/:title.html ，也就是说，如一篇文章叫“2014-2-6-this-is-a-title.md”，在文章中定义的文类为[测试, new]，那么最终这篇文章的路径将会是“_site/测试/new/2014/02/06/this-is-a-title.html”，也就是说如果category为中文名称的话，中文将会出现在url中。然后就会根据中文去jekyll的action中索引，然后导致错误。

避开方法就是去掉根据permlinks中的categories，因为一般情况下根据时间来生成文件夹就已经够了，在_config.yml中新增一行：

permalink: /:year/:month/:day/:title 规则可以自己定，具体参照 jekyll的Permlinks配置介绍页面 ，别出现categories就行了

哦天呐，发现Windows下好多奇怪的错误，下次还是开一篇新的Blog来细说吧