博客地址是: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_dirbaseurl: /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选项即可
2、代码高亮
代码高亮使用pygments插件,使用方法很简单,只需要将代码放入
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-jekyllJekyll博客模版:
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/