如何在Github创建个人博客

网上有很多如何在github上创建个人博客的教程,我根据别人的经验,花了一天的时间,终于搭建出了自己的博客(^_^).先将整个流程分享给大家.

  • 安装git,并会基本的git操作命令.这个不多说了,还没有使用过git的同学们可参考廖雪峰的git教程

  • 在github上注册账号并添加本机公钥. 还没有github账号的同学可访问git官网,上面有详细的说明步骤

  • github仓储分用户仓储和项目仓储. 我们在上面创建个人仓储.

github-create-user-repo

注意仓储选择public,当然, 你也可以选择创建README.md文件

  • 由于个人博客上面都是静态网页, 但写html实在是太麻烦了({>~<}),还好markdown是一个不错的选择.但我们需要一个将mardown文件转换为html的工具, 这个就是jekyll了.幸好github pages也是支持jekyll的. 我们需要先安装ruby, 因为jekyll是ruby的一个插件(gem). rubyInstaller下载地址

  • 创建环境变量$RUBY_HOME,并将$RUBY_HOME/bin添加到$PATH环境变量中

  • (可选)安装DevKit, DevKit可在windows环境中运行Unix命令及C,C++编译器,类似minggw,有些ruby gem源码编译是需要用到. 注意不同的ruby版本选用不同的DevKit.( 64位 DevKit下载地址 ). 下载解压并进入解压目录, 修改config.yml, 配置ruby安装路径:

    - E [ruby安装路径] #比如: - E:/installed/Ruby22-x64

,然后运行: 

ruby dk.rb init

ruby dk.rb preview

ruby dk.rb install

  • 由于众所周知的原因, 需要为ruby gem更换来源,否则下载不了gem

    gem sources -remove https://rubygems.org/ -add https://ruby.taobao.org/

    gem sources -l

  • 安装Python2.7.10, ruby中有些gem是需要运行python脚本的.比如下面说到的pygments.rb

  • 安装jekyll gem

    gem install jekyll

    安装完成后, 运行命令jekyll serve --watch. 并在浏览器中访问 http://localhost:4000

  • 安装pygments代码高亮显示插件

    gem install pygments.rb # 代码高亮

  • 找个jekyll模板, 我使用的是 jekyll-boostrap模板, 主题选用的是 the-program主题

    git clone https://github.com/plusjade/jekyll-bootstrap.git

    cd jekyll-bootstrap

    rake theme:install git=”https://github.com/jekyllbootstrap/theme-the-program.git”

  • jekyll-boostrap 0.3.0 版本有个小bug: 找不到相应主题下的样式表文件(style.css), 可将_config.yml配置项:

    ASSET_PATH : false 修改为

    ASSET_PATH : /assets/themes/the-program

    来解决. 至此, 个人博客的基本模板就完成了. git push 到github上, 访问 [github账户].github.io 就可以看到了(^_^).