mac环境下搭建github - jekyll blog，创建自定义风格模板

前篇-博客搭建

——在头回家探亲的国庆佳节，我终于可以有时间搭建好了自己的blog，普天同庆！ 先看官网教程搭建吧，如果喜欢折腾，搭个jekyll框架就好了，再自己折腾样式，如果秉着重视内容，就把jekyll-bootstrapclone下来，直接用他的默认样式.

jekyll官网：http://jekyllrb.com/docs/installation/

jekyll中文站：http://jekyllcn.com/docs/installation/

jekyll-bootstrap 官网：http://jekyllbootstrap.com/usage/jekyll-quick-start.html（我基本是按这个教程安装的，虽然后来把它的模板全撤了，换成自己的了，这篇教程将github与jekyll博客搭建流程写的很清晰）

如果不出意外，你都会遇到一些问题，遇到后就去google吧，基本都能找到答案。我就遇到了一些问题。

1、其实博客搭建的时间比较早，期间本地博客一直搭不上，gem install jekyll一直在报错，后来静候mac更新了Ruby、下载了RubyGems·······不是很了解这些语言，也不是很了解ios系统，所以这里也没什么可分享的。就是要看教程、出问题google，

2、按教程来的话，你敲git push origin master，一定会报错：

    $ git push origin master
    Permission denied (publickey).
    fatal: The remote end hung up unexpectedly

这时，参考https://help.github.com/articles/generating-ssh-keys/


主篇-风格主题搭建

见我的下一篇博客吧http://echizen.github.io/tech/2014/10-06-custome-blog-style/

尾篇-发布博客

有两种方式发布内容：

1、rake post title="Hello World"

一般写博客都是用这句，这句代码会在 _post\ 文件夹下新建一个文件，文件名由 _config.yml 里的permalink: /:categories/:year-:month-:day-:title 的配置决定，都说文件名不要取中文，jekyll系统会把文件名中的中文过滤掉，由于文章中会有title的设置，所以不用中文命名也不是什么痛苦的事啦。

permalink:的配置中的/不是真的文件夹部署，只是url上的显示，其实如果是真的文件夹分布就完美了。目前支持三种默认的配置，可以简洁的用permalink: date这种形式配置。

也就是说无论你是permalink: /:categories/:year-:month-:day-:title 还是什么，都只能显示三种效果，

2、修改头信息

打开新建的那个文件，新建的文件终端都会输出新建的文件路径，所以只用open命令就可以很轻松的用默认的编辑器打开该文件了。（Mac下是Mou打开markdown文件）

	rake post title="jekyll blog 模板修改-创建自己的style"
	Creating new post: ./_posts/2014-10-06-jekyll-blog--style.md
	➜  echizen.github.io git:(master) ✗ open ./_posts/2014-10-06-jekyll-blog--style.md

新建的~~~XXXhello-world.md的头部有一段YAML 头信息，形如：

	---
	layout: post
	title: "hello world"
	description: ""
	category: 
	tags: []
	---

layout:决定渲染的模板，post就是post.html啦，用rake post命令生成的默认都是post。

title:真正的会在归档等地方显示的页面标题。

description:为了SEO优化，方便搜索引擎搜到，最好写一点。

category:文章所在的分类，像我的博客是以category分页面展示的，这时候这个参数就非常重要。

tags:给文章打上标签，和category一样，这样两个都是要在页面模板上有处理时才方便。

以上的参数冒号后一定要多加个空格不然，呵呵，就不能正确解析了

3、发布博客

这一步在我的电脑上不需要，我在本地手动新建的文件，不用git add、git commit就能jekyll server后在本地访问，就看到修改后的效果，很方便，满意后再commit。

如果是新增：git add XXX -> git commit -m 'add XXX'

如果是修改已存在的文件就： git ci -am 'modify XXX'

然后一致git push origin master。

ps:在中文下，markdown其实挺不好用的，不断切换英文的语法标签和中文。。。

4、疑难杂症

markdown里插图片好不方便啊！！！还得加链接。我的做法是，在根目录下的assets下新建一个blog-img文件夹，图片基本来源于截图，我把截图的保存目录直接关联到这个目录，然后在博文中因为考虑到有可能会把.md文件粘到其他地方，我用的又是绝对地址，即https://username.github.io/assets/blog-img/图片名称.png。这样相对方便一点，但是还是没有那种直接在插入图片方便。不知大家用的是什么方法。