Windows下部署Octopress静态网站至GitHub（详细教程）

环境的配置

在部署之前我们需要配置下环境我们需要安装下面这几款软件
- Git
- Markdown
- Ruby
- DevKit
其中git和markdown都直接下一步一直安装即可，在安装markdown后，需要安装awesomium，这样才能实现所见即所得。
–Git的配置
具体git的配置我就不多说了，baidu.com有一大堆
–安装ruby
安装ruby的时候注意勾选下面这项，将路径添加到系统的环境变量中

完成后，鼠标右键打开 Git Bash输入ruby --version如果出来了版本信息则说明安装成功了
–安装DevKit
下载完成DevKit直接安装就可以了
–关联Ruby和DevKit
来到DevKit的目录下，打开Git Bash，输入 ruby dk.rb init弹出【INFO】信息然后输入ruby dk.rb install弹出两个【INFO】信息，说明我们成功的为ruby安装了DevKit
–安装Octopress并设置默认主题
找到一个你想存放octopress文件夹的目录右键进入Git Bash输入

git clone git://github.com/imathis/octopress.git octopress

同步完成后，cd到octopress目录下 cd octopress详情可以看下octopresssetup
安装依赖项bundler

gem install bundler

如果你没用科学上网那么可能提示错误，我们可以切换到国内的ruby源，在国内淘宝或腾讯的ruby镜像源，可以使用下面的命令添加软件源：

gem source -a https://ruby.taobao.org
//淘宝ruby镜像

如果链接失败可以换一个：

gem source -a https://gems.ruby-china.org
//腾讯ruby镜像

使用gem sources -l查看所有ruby源，当有多余一个源我们可以使用

gem source -r http://rubygems.org/

移除不需要的源，注意类似http://rubygems.org/地址要书写完全一致才能移除。
修改Gmefile文件的软件源，将第一行sources修改即可（例如修改成腾讯的ruby源）

source "http://gems.ruby-china.org/"

group :development do
  gem 'rake', '~> 10.0'
  gem 'jekyll', '~> 2.0'
  gem 'octopress-hooks', '~> 2.2'
  gem 'octopress-date-format', '~> 2.0'
  gem 'jekyll-sitemap'
  gem 'rdiscount', '~> 2.0'
  gem 'RedCloth', '~> 4.2.9'
  gem 'haml', '~> 4.0'
  gem 'compass', '~> 1.0.1'
  gem 'sass-globbing', '~> 1.0.0'
  gem 'rb-fsevent', '~> 0.9'
  gem 'stringex', '~> 1.4.0'
end

gem 'sinatra', '~> 1.4.2'

安装bundler

gem install bundler

这个过程有点长，出现Sucessful后

bundler install

这个过程也有点长
接下来就是真正的安装Octopress
输入rake install
当在octopress目录下看见多了 public登目录时说明安装成功了
怎么知道我们的确成功了呢？
输入rake generate生成静态网页，然后rake preview创建一个本地服务器来预览下，在浏览器地址栏输入localhost:4000如果出现Octopress Blog页面说明成功安装了Octopress
如果这个页面加载非常慢，我们可以将这个页面的jquery库换成国内百度的，来到octopress\source_includes目录下，编辑head.html文件

修改框起来的部分为百度的库

//libs.baidu.com/jquery/1.9.1/jquery.min.js

然后再次rake generate生成静态网页，rake preview发布出去打开localhost:4000感受下速度有没有加快？
–生成博客
在octopress目录下右键Git Bash输入rake new_post["title"]其中title应为英文，因为它用于地址。接下来你会发现在在octopress\source\_posts目录下会生成一个markdown文件，打开编辑这个文件你就可以写自己的blog了，至于markdown的语法这里就不讲了，如果你没有关闭之前的rake preview打开的页面那么直接刷新网页就可以看见你最新发布的博客了，如果你已经关闭那么重复上面
rake generate生成静态网页，rake preview发布的步骤。如果你发现打开的网页是空的，可能是你的markdown文件出现不支持的语法，如果rake preview发布失败，你要看下你得电脑的4000端口有没有被占用，杀死对应进程就可以了（杀死方法：cmd，输入 netstat -ano查看占用4000端口进程的PID，在任务管理器中杀死指定PID进程即可）

部署博客至GitHub

首先你要在github上新建一个仓库，命名格式

yourname.github.io

yourname是指你github的账户名，
接下来执行rake setup_github_pages如果在Git Bash执行rake setup_github_pages没有反应，你可以在windows自带的命令行工具（win+r）中执行，但是首先你要cd到octopress目录下
在octopress目录下输入

rake setup_github_pages

接下来要你输入你github仓库的url，按照指定格式填写就可以了（如果出现错误，baidu会发现很多格式，可能是老版本的格式，根据提示格式填写确保正确）

在提交前你需要再次生成网页确保一致rake generate
如果没错，就执行

rake deploy

命令同步，如果你设置了SSH密钥，确保你得本地和github都有密钥，并在提交的时候需要两次输入生成密钥时候的密码，如果成功提交了，刷新你的yourname.github.io的仓库，将会将与本地_deploy目录下内容一致
如果出现 ERROR,failed等字样说明出现了错误需要先排除错误，下面有几个我遇到的错误：
1.fatal: Could not read from remote repository.Please make sure you have the correct access rights.and the repository exists.确保你得URL地址没有填写错误
2.Permission denied (publickey).
fatal: Could not read from remote repository.
Please make sure you have the correct access rights
and the repository exists.密钥不正确，确保你github上添加了密钥
3.rake aborted! no such file or directory - git -remote -v 前面说了切换至windows的命令操作行下操作
4.jekyll 2.5.3 | Error: Not a directory @ dir_s_mkdir -c:/Users/Administrator/De
sktop/octopress/public/git@github.com:ljx520你的第一步rake setup_github_pages没有有成功，导致没有生成对应文件
5. NoMethodError: undefined method `[]’ for nil:NilClass可能命令行格式出现问题，有可能git.exe环境没有配置成功，这个我不确定

如果觉得我哪里还没讲到或则讲清楚可以到极客学院观看教学视频，点击传送门

我的博客网站：http://huyuxin.top/欢迎大家访问！评论！