使用github page搭建个人博客（jekyll的安装和使用）

       github Pages 是在github上托管的静态网页。从2016年6月15日开始，通过域名github.io访问使用的是https协议。github pages的代码仓库容量限定是1G,并且带宽限制是100G或者每月10万次访问。

     使用github搭建个人博客步骤如下：

     1、创建github仓库

      在github上创建github pages的仓库，如果名字是xxx 则仓库的名字是xxx.github.io, 之后提交代码到这个代码仓库，访问https://xxx.github.io 即可以访问你的主 页。

     

     2、安装ruby环境

     下载安装包  http://rubyinstaller.org/downloads/  安装时记得勾选“加入环境变量的选项”，安装完在命令行输入 ruby -v  出现下图即安装成功

     

     下载devkit  https://github.com/oneclick/rubyinstaller/downloads/  下载最新版devkit，双击会提示选择路径自动解压，然后进入到解压路径，输入以下命令

     ruby dk.rb init      

     ruby dk.rb install

    

    3、安装Jekyll

         首先加入国内的镜像，因为国外的镜像有的连接不上。

          gem sources --remove https://rubygems.org/

         

        gem source --add http://gems.ruby-china.org/

         

        接着使用命令 gem install jekyll 开始安装Jekyll

        

        安装完后输入 jekyll -v 显示版本号即安装成功。

        

  4、安装Rdiscount，Jekyll默认的markdown解析器maruku对中文支持不够完善,所以果断换成RDiscount解析器

        输入 gem install rdiscount

        

      5、创建jekyll工程，开始使用

        输入 jekyll new blog , 创建名字为blog的工程

        进入blog目录，运行 jekyll serve 命令，会启动服务，访问localhost:4000即可预览。

        

  6、提交到github

        将上述工程的代码复制到 在本地克隆的xxx.github.io的git仓库下，提交push到github，即可访问。

        如果有报错，比如下面之类的

E:/Ruby23/lib/ruby/gems/2.3.0/gems/bundler-1.13.2/lib/bundler/resolver.rb:366:in `block in verify_gemfile_dependencies_a
re_found!': Could not find gem 'jekyll-sitemap x86-mingw32' in any of the gem sources listed in your Gemfile or availabl
e on this machine. (Bundler::GemNotFound)
        from E:/Ruby23/lib/ruby/gems/2.3.0/gems/bundler-1.13.2/lib/bundler/resolver.rb:341:in `each'
        from E:/Ruby23/lib/ruby/gems/2.3.0/gems/bundler-1.13.2/lib/bundler/resolver.rb:341:in `verify_gemfile_dependenci
es_are_found!'
        from E:/Ruby23/lib/ruby/gems/2.3.0/gems/bundler-1.13.2/lib/bundler/resolver.rb:199:in `start'
        from E:/Ruby23/lib/ruby/gems/2.3.0/gems/bundler-1.13.2/lib/bundler/resolver.rb:181:in `resolve'
        from E:/Ruby23/lib/ruby/gems/2.3.0/gems/bundler-1.13.2/lib/bundler/definition.rb:250:in `resolve'
        from E:/Ruby23/lib/ruby/gems/2.3.0/gems/bundler-1.13.2/lib/bundler/definition.rb:174:in `specs'
        from E:/Ruby23/lib/ruby/gems/2.3.0/gems/bundler-1.13.2/lib/bundler/definition.rb:233:in `specs_for'
        from E:/Ruby23/lib/ruby/gems/2.3.0/gems/bundler-1.13.2/lib/bundler/definition.rb:222:in `requested_specs'
        from E:/Ruby23/lib/ruby/gems/2.3.0/gems/bundler-1.13.2/lib/bundler/runtime.rb:118:in `block in definition_method
'
        from E:/Ruby23/lib/ruby/gems/2.3.0/gems/bundler-1.13.2/lib/bundler/runtime.rb:19:in `setup'
        from E:/Ruby23/lib/ruby/gems/2.3.0/gems/bundler-1.13.2/lib/bundler.rb:99:in `setup'
        from E:/Ruby23/lib/ruby/gems/2.3.0/gems/jekyll-3.2.1/lib/jekyll/plugin_manager.rb:36:in `require_from_bundler'
        from E:/Ruby23/lib/ruby/gems/2.3.0/gems/jekyll-3.2.1/exe/jekyll:9:in `<top (required)>'
        from E:/Ruby23/bin/jekyll:23:in `load'
        from E:/Ruby23/bin/jekyll:23:in `<main>'

       

      则因为缺少相应的模块，根据提示“Could not find gem 'jekyll-sitemap x86-mingw32' in any of the gem sources listed”安装相应模块即可。即输入 gem install jekyll-sitemap

      

      以此类推，如果遇到类似错误，则缺少什么模块安装什么模块即可。