Windows7下，用Octopress在Github上搭建博客

本文主要參考: http://shanewfx.github.com/blog/2012/02/16/bulid-blog-by-octopress/

 本文在Windows7下測試成功。

 

安裝和設置Git

下載Git for Windows，采用默認安裝，安裝完成后就可以在本地使用Git了。

但要將內容放到Github上，必須先在Github網站上注冊個賬戶，然后在本機使用Git創建SSH Key。操作如下：

 

在Git Bash上輸入命令:

ssh-keygen -C "[e-mail]" -t rsa

 

Note: “[e-mail]”需要更換成你在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 [e-mail]”測試能夠正常連接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項目網址，比如：

[e-mail]: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

 

 

 大功告成！