在GitHub上搭建octopress博客

前言
我将详细叙述在Windows下如何安装、运行Octopress博客并发布Github Pages上，这样就可以通过 http://username.github.io 来访问你的站点了。我发布在Github上的Octopress演示博客：https://jpgong.github.io/

一、安装本地环境
1、首先安装ruby， 下载官方网站是：https://rubyinstaller.org/downloads/ ，我下载的是Ruby 2.5.1-2（x64), 下载后双击安装即可，安装时记得选中“Add Ruby executables to your PATH"，为了检查rubu是否加入到PATH中，可以在windows的cmd窗口执行以下命令:

1 2	ruby -version

2、然后再安装Devkit,下载的官方网站也是：https://rubyinstaller.org/downloads/ ，我下载的版本是4.7.2，下载之后进行安装即可。
注：而且现在ruby已经将这两个进行整合了，也可以直接下载带有Devkit的ruby。
二、更新本地环境配置
1、为了支持中文UTF-8编码，对Windows环境变量配置如下：

1 2 3

LANG=zh_CN.UTF-8 LC_ALL=zh_CN.UTF-8

也可在直接在Windows的cmd窗口下运行命令：

1 2 3

set LANG=zh_CN.UTF-8 set LC_ALL=zh_CN.UTF-8

2、更新gem的更新源，ruby的官方更新源经常被河蟹，换成国内的更新源，这样速度就快多了，变更如下：
gem sources -a https://ruby.taobao.org/
gem sources -r https://rubygems.org/
gem sources -l
最后一条命令可以查看更新后的更新源列表。
三、下载并并配置octopress
1、首先下载Octopress源码，可以使用下面git命令下载，也可直接在Octopress Github库中下载octopress的zip包，然后将下载的压缩包解压到E盘根目录，修改解压后的文件夹名称为 octopress。

1 2 3

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

2、下载之后更新octopress的gem更新源：进到 E:octopress 目录，用文本编辑器（例如记事本）打开文件Gemfile，将里面source "http://rubygems.org/”   更换为  source "https://ruby.taobao.org/"
3、安装octopress的依赖项，输入一下命令：

1 2 3 4 5

E: cd octopress gem install bundler bundle install

四、新建GitHub Repositories
1、登录Github，假设你的用户名是username，首先要新建一个命名为 username.github.com 的Repo，命名必须是这个格式，如果不这样命名的话，在运行命令 rake setup_github_pages 之后不能够自动创建后面提到的master和source 分支，而是作为普通仓库生成 gh-pages 分支。
如下图：

五、发布octopress到GitHub
1、打开Windows下的命令窗口，进入到Octopress所在的目录，输入命令：

1 2	bundle exec rake setup_github_pages

然后根据提示输入刚才新建的Repo地址，在GitHub中进行查找，如下图：

输入Repo url后，根据提示向下进行即可。
2、输入一下命令：

1 2 3 4

bundle exec rake install bundle exec rake generate bundle exec rake preview

其中rake install是安装Octopress默认主题的，rake gnerate是生成静态页面的，这两个命令是必须运行的，而rake preview则是用来本地浏览的（运行时看屏幕上提示，按Ctrl+C并输入Y来终止批处理操作），运行后打开浏览器，输入 http://localhost:4000/ 就可以看到如下的界面了:

我是更换其他主题，所以和你们的有些许不同，更换主题我在下篇博文会介绍，如果不想预览的话也可以不运行，直接进入下一步。
3、将博客发布到Github上，输入下面命令：

1 2	bundle exec rake deploy

这样，生成的内容将会自动发布到master分支，并且可以使用 http://username.github.io 访问内容。
4、别忘了把所有源文件发布到 source 分支下面：

1 2 3 4

git add . git commit -m “your message” git push origin source