• 初始配置
• 进阶
• kramdown语法

一直在用的Wiz对Ubuntu的支持越来越差了，毕竟是收费软件，考虑换个成本更低的地方写总结。github虽然不如Wiz方便，胜在受开发喜欢，并且免费，所以尝试下用github来记

初始配置

1. 安装
   安装：gem install jekyll
   创建站点有两种方式，一种是通过jekyll创建后上传到github，但这种要注意站点名称需要符合一定的规则：即{username}.github.io。创建站点：jekyll new {username}.github.io
   另一种方式是先在github上创建代码仓库，clone到本地之后，进入到这个文件夹下jekyll new {username}.github.io --force 启动站点：jekyll serve
2. 新建文件
   jekyll的发布的文章放置在_posts文件夹下，需要注意的是命名需要以日期开头，2017-08-28-filename.EXET,其中，EXET为文件后缀名
   示例如下：
   新建文件2017-08-28-testFile.md,添加内容如下：

---
layout: default
title:  "test"
date:   2017-08-28 01:12:40 +0800
categories: test
---
#test
test1

这里文件头部添加博客的相关设置，设置内容参见：http://jekyll.com.cn/docs/frontmatter/ 修改完成之后，通过jekyll serve启动本地服务，查看页面效果
以上即可完成初始配置

进阶

• 如何添加图片
  在根目录下添加文件夹_pic用于存放图片，然后在配置文件中添加include: ['./_pic']， (当配置二级目录的时候，启动时无法正常引入include的文件夹，所以只能把文件夹存放在根目录中，不确定是不是我哪里操作的问题)。这样在系统启动时，会将这个文件夹自动加载进_site,然后在markdown文件中引入图片：![](/_pic/picName.png) 除了引入相对路径，也可以通过全路径来引入图片，只需在引用路径前添加站点地址即可，这种比较简单，但不适合本地调试和发布，不再介绍。

• 如何设置markdown模板引擎
  在配置文件_config.yml中添加配置markdown: Redcarpet,其他可选配置参见：http://jekyll.com.cn/docs/extras/

由于github未来可能只支持kramdown，而kramdown引擎要求的markdown语法和标准markdown语法有所差别，在一开始使用的时候最好设置markdown引擎为kramdown，并在写文档时参考kramdown语法,具体参见kramdown文档

• 其他问题
  关于换行：markdown通过回车换行后，页面效果无效，可以通过两个空格加换行的方式实现页面的换行效果
  另一种方式是添加空白行

kramdown语法

• 关于标题

使用#时，需要在#后添加空格并在每个标题前后添加空白行
另一种添加标题的方式是在标题下添加—或===分别代表一级标题和二级标题

• 关于table

在标准table前后添加表头和表尾

|---
|a|b|c|d |
|:-:|:-:|:-:|:-:|
|a|b|c|d|
|===

• 关于代码块

行内代码引用使用”`”

代码块使用”~~~”放在代码块前后