安装和设置Git

下载Git for

Windows，采用默认安装，安装完成后就可以在本地使用Git了。

但要将内容放到Github上，必须先在Github网站上注册个账户，然后在本机使用Git创建SSH Key。操作如下：

在Git Bash上输入命令:

ssh-keygen -C "[email protected]" -t rsa

Note: “[email protected]”需要更换成你在Github上注册的Email地址或者是Username

这样会在用户目录(C:\Users\用户名)下产生一个.ssh文件夹，里面为对应的SSH

Keys，其中id_rsa.pub是Github需要的SSH公钥文件。

到c:\Users\用户名\.ssh\目录找到id_rsa.pub（可能位置不一定对，但是确认是以.pub结尾的文件），并用记事本打开复制全部内容。

Note：建议私钥公钥的名称最好写成"id_rsa"，这样连接Github的时候会找这个文件，如果文件名已定，之后改名也行。

在github网站选择“Account Settings”>>“SSH Public Keys”>>“Add another

public key”，将刚才复制的内容粘贴到key文本框内。

这样就可以直接使用Git和GitHub了。

Note：建议在Git Bash中输入“ssh -v [email protected]”测试能够正常连接github

安装Ruby环境

下载RubyInstaller和DevKit。

因为Octopress需要的Ruby版本为1.9.2，所以选rubyinstaller-1.9.2-p290.exe，DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe。

先安装RubyInstaller，然后解压缩DevKit(路径中不能有中文)。

在“Start Command Prompt with Ruby”命令行中进入DevKit解压缩的目录，然后运行以下命令:

ruby dk.rb init

ruby dk.rb install

gem install rdiscount --platform=ruby

如果安装成功，就可以使用一些Ruby的工具了，也为后面搭建博客提供了基础环境。

安装Octopress

先通过Git从Github上克隆一份Octopress（在Git Bash上输入命令）

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

然后安装一些依赖的工具（后面都是在Start Command Prompt with Ruby中输入）

cd octopress

ruby --version # Should report Ruby 1.9.2

gem install bundler

bundle install

安装Octopress默认的Theme

rake install

配置Octopress

将octopress的文件夹下的_config.yml的编码改成UTF-8：

保存（或另存为）时选择编码格式为UTF-8

修改_config.yml，批改url、title、subtitle、author等等。

到Ruby的安装目次\lib\ruby\gems\1.9.1\gems\jekyll-0.11.2\lib\jekyll\找到convertible.rb这个文件，批改self.content

= File.read（File.join（base， name））为self.content = File.read（File.join（base，

name）， :encoding =>"utf-8"）。

写博文

最简单的方式：复制octopress\source\_posts下某个文件，例如2012-07-30-the-first-post.markdown，修改文件名和文件中的内容

或者，命令行中输入rake

new_post["title"]，会创建一个新的Post，新文件在source/_post下，文件名如下面的格式:2012-07-31-title.markdown。该文件可以直接打开修改。

写文章时，可以使用Markdown和Octopress

Plugins等工具对内容进行格式排版。

预览效果

在修改设置或者写完文章后，想看看具体效果，可以通过如下命令来完成:

rake generate

rake preview

将博客部署到Github上

在预览的效果符合自己的预期后，就可以通过如下命令将内容部署到Github上了。

如果是第一次部署，需要在Github上创建一个username.github.com的repository

在github网站选择“Create a New Repo”,如图

填写对应的内容即可

note：Repository

name填写username.github.com，username一定要和github的username一致，建好的博客代表的是你这个github账户的主页即page

配置octopress与github的连接：

进入Octopress目录：

rake setup_github_pages

按照提示填入你的github项目网址，比如：

[email protected]:Username/yourname.github.com.git

note：可以按照上面的修改，也可以在github的项目页中找地址

分发到github上：

rake deploy

第一次运行时，会询问是否建立对github的授权，输入：yes。然后将站点更新的内容推送到github上。

补充一点：

最后的但并不是最重要的，我们需要将修改的日志同步到github上，因此下面的3个命令也是必须的。

git status

git add .

git commit -m 'your message'

git push origin source

大功告成！

windows下安装或升级时gem经常会碰到

Please update your PATH to include build tools or download the DevKit

from 'http://rubyinstaller.org/downloads' and follow the instructions

at 'http://github.com/oneclick/rubyinstaller/wiki/Development-Kit'

这是因为没有安装DevKit的缘故。

DevKit 是windows平台下编译和使用本地C/C++扩展包的工具。它就是用来模拟Linux平台下的make, gcc, sh来进行编译。注：这个方法目前仅支持通过RubyInstaller安装的Ruby，如果不是建议你重新安装。安装方法：双击下载的7z文件，指定解压路径，路径中不能有空格。如C:\DevKit，这个路径就是<DEVKIT_INSTALL_DIR>。

>cd <DEVKIT_INSTALL_DIR>

>ruby dk.rb init

#生成config.yml，这里会检查将要添加DevKit支持的Ruby列表，只支持通过RubyInstaller安装的Ruby

#如果这里列出的Ruby与你的要求不符，可以手动修改

>ruby dk.rb review #检查要添加DevKit支持的Ruby列表是否有误，可以略过

>ruby dk.rb install

[INFO] Updating convenience notice gem override for 'C:/Ruby192'

[INFO] Installing 'C:/Ruby192/lib/ruby/site_ruby/devkit.rb'

检查是否安装成功

>gem install rdiscount --platform=ruby

Fetching: rdiscount-1.6.8.gem (100%)

Temporarily enhancing PATH to include DevKit...

Building native extensions. This could take a while...

Successfully installed rdiscount-1.6.8

1 gem installed

Installing ri documentation for rdiscount-1.6.8...

Installing RDoc documentation for rdiscount-1.6.8...

如果能安装rdiscount成功说明安装DevKit成功。

设置launch.json

把echo $PATH的结果放到env的PATH里

可能还需要下面的配置