mac环境下安装搭建github - jekyll blog
06 October 2014

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这种形式配置。

image

也就是说无论你是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 addgit 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。这样相对方便一点,但是还是没有那种直接在插入图片方便。不知大家用的是什么方法。