pic

    博客地址是:http://dariuskylin.github.io/blogs/或者http://www.ifdong.com

    在github搭建blog之前,当然需要有一个github账户;本机也要安装好git。

根目录文件结构

    选择一个空目录或者新建一个目录,用来作为主目录primary_dir,进入primary_dir执行
  
	git init

基本的文件结构应该是:

/primary_dir
                |-- _config.yml  //配置文件
                |-- _layouts     //模板目录
                |-- _posts       //日志文件目录
                |-- index.html   //首页文件

    里面只有_config.yml是必需的,其他都可以自定义名称。所有的页面都是静态的,或者是html格式或者是markdown格式。 根据github的要求,所有文件和目录的添加必须在gh-pages分支下执行,即在git init后,马上执行

git checkout --orphan gh-pages

然后再创建子目录和文件

_config.yml配置文件

_config.yml是配置文件,它包含了很多的配置选项,具体可参看官方文档。 _config.yml可以设置很多东西,但是如果不设置某个具体选项,那么该选项就使用默认设置,这样就比较省事了,可以仅写几个选项就可以了。baseurl是一个非常重要的选项,baseurl必须指定,用来表示主目录primary_dir
baseurl: /primary_dir
(冒号后有一个空格) 这是对github内部blog的设置方法,如果有自己的独立域名,那么baseurl只需要/,而不需要带目录。

github发布博客

	* 进入主目录primary_dir
	* 初始化主目录:git init
	* 切换到gh-pages分支:git checkout --orphan gh-pages
	* 进行博客文件编辑
	* 将要发布的内容加入到git:git add filename(如果要添加所有文件和目录,就用git add .)
	* git本地提交:git commit -m ‘comment’(comment是备注)
	* 添加远端git源:git remote add origin https://github.com/github用户名/博客项目名.git(只需要执行一次
	* 推送到github:git push origin gh-pages
推送结束后,等待一段时间(3-10分钟)就可以访问了

Some tips

1、添加分类

添加分类是,只需要在yml开头的配置里面设置category选项即可

pic

如果是多个分类,则需要用categories(category的复数),需要注意的是“-”后面有一个空格

pic

2、代码高亮

代码高亮使用pygments插件,使用方法很简单,只需要将代码放入

pic

中间就可以,c++可以替换成c,java,php等。

pic

3、使用自己的域名

不使用github的域名,需要在主目录primary_dir下添加一个CNAME文件,里面指定自己的域名地址,push到github上; 然后在域名管理里面添加一条A记录指向github pages的IP地址204.232.175.78,等待几分钟就可以了。

4、添加评论

Disqus是比较出名的第三方评论系统,国外用户量有很多,但是对新浪微博、qq微博等接入方式支持不好。友言uyan是国内的第三方评论系统,相对于Disqus,国内化的用户体验比较好。

友言uyan的使用方法比较简单,只需要去官网注册一下,然后获取通用代码,放入body内即可

参考资料

install Jekyll with pages:

    https://help.github.com/articles/using-jekyll-with-pages#installing-jekyll

Jekyll博客模版:

    https://github.com/mojombo/jekyll/wiki/Sites

入门:

  • 1、http://www.ruanyifeng.com/blog/2012/08/blogging_with_jekyll.html
  • 2、http://hzmook.github.io/2012/07/01/use-jekyll-build-blog-on-github.html

不错的几个中文博客模版:

  • http://mytharcher.github.io/
  • http://hzmook.github.io/
  • http://www.fuweiyi.com/
  • http://taoxiaolei.cn/
  • http://havee.me/