在github搭建自己的blog

一个周末，终于搞定，写个大概流程，具体的可以参考下方列出的页面。
开始用的是jekyll，后来转到了hexo。本篇介绍的是jekyll，hexo可以参考使用hexo搭建github pages，比jekyll配置简单许多。

  1. git一些基本知识，可以看 廖雪峰的Git教程
  2. 一个github账号
  3. 需要一点耐心

使用github pages

只需要新建一个repository，名为 {username}.github.io，username为你注册的github账号，然后新建一个页面index.html，写入hello，提交到github中，在页面{username}.github.io中即可显示页面内容。
例如：我的账号名为wzktravel，我的github blog地址就为 wzktravel.github.io

在本地搭建jekyll环境

具体操作略过，详细的可以看github官方步骤，这里主要说一下大体步骤和遇到的一些坑。

机器环境：redhat6，mac 10.10.2

  1. 安装ruby，需要版本2.0.0以上
  2. 使用gem安装bundler，在此步骤之前，请先换gem源！
    1. gem sources --remove https://rubygems.org/ #删除ruby官方源
    2. gem sources -a http://ruby.taobao.org/ #使用taobao源
    3. gem sources -u #更新源
    4. gem sources -l #列出所有源，保证只有taobao的那个

  3. 可以将我的repository copy一份(最好是我的，有一些小工具)，也可以用其他人的，新建一个Gemfile，内容

    1
    2
    source 'http://ruby.taobao.org/' 
    gem 'github-pages'

    然后运行buddle install，祝你好运。

  4. 如果是在mac上，在buddle install之前，需要自行安装libxml2，xcode是必需的，其他的各种版本libxml2都不好使，相信我

    sudo gem install nokogiri -- --with-xml2-include=/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.10.sdk/usr/include/libxml2 --use-system-libraries

    参考 http://www.virtlab.cx/ruby-fix-error-install-nokogiri-yosemite/

  5. 全都成功之后，可以bundle exec jekyll serve，开启本地jekyll服务，输入ip:4000查看你的本地blog。
    也可以使用我的脚本

    1
    ./server (start|stop|restart)

  6. 我的是基于jekyllbootstrap的，样式可以自己定义，在assets/themes/bootstrap-3/css/style.css

小工具和备忘

新建相关: rake

  • 新建一篇文章: rake post title="hello world"
  • 新建一个页面: rake page name="about.md"
  • 新建一个内部页面: rank page name="pages/about.md"

本地server

  • ./server (start|stop|restart)
  • 日志在_log目录下

参考