使用Octopress來搭建博客,還是有一定門檻的,看完本文后,希望您不會(huì)覺得很難。
Octopress 是一款基于 Jekyll 的靜態(tài)站點(diǎn)生成系統(tǒng),使用Ruby實(shí)現(xiàn),所以您需要懂點(diǎn)Ruby的知識(shí),其實(shí)會(huì)幾個(gè)命令就行;
Octopress的博客內(nèi)容是通過Markdown來書寫,所以您需要了解Markdown的編寫規(guī)則,Markdown 語法說明可以讓你在幾分鐘之內(nèi)熟悉Markdown的語法,在Windows下可以使用MarkDown Pad或是使用在線的編輯器http://mahua.jser.me/進(jìn)行編輯;
Octopress通常會(huì)部署在GitHub上,所以您需要會(huì)一些簡(jiǎn)單的Git命令以及Gtihub的使用。
系統(tǒng):Windows 2003 Server、Windows 7、Windows 2008R2 Server,這三個(gè)系統(tǒng)用下面的版本都安裝成功過;
Git:http://msysgit.googlecode.com/files/Git-1.8.1.2-preview20130201.exe
Ruby:http://files.rubyforge.vm.bytemark.co.uk/rubyinstaller/rubyinstaller-1.9.3-p429.exe
DevKit:http://cloud.github.com/downloads/oneclick/rubyinstaller/DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe
Python:http://www.python.org/ftp/python/2.7.5/python-2.7.5.msi
Octopress:git://github.com/imathis/octopress.git
Windows下安裝Git很簡(jiǎn)單,一路next就可以了。
Ruby的安裝也是一路next就可以,不過記得勾選“Add Ruby executables to your PATH”,將Ruby的執(zhí)行路徑加入到環(huán)境變量中,如果忘記勾選,也可以手動(dòng)設(shè)置。安裝完后可以在命令提示符中輸入ruby –version 來確認(rèn)是否安裝成功。
DevKit下載下來的是一個(gè)自壓縮文件,我們將其解壓到D:/DevKit,有兩點(diǎn)需要注意:
1. 解壓目錄中沒有有中文和空格;
2. 必須先安裝Ruby,而且Ruby需要是RubyInstallser安裝。
解壓DevKit后,在命令行輸入以下命令來進(jìn)行安裝:
d: cd DevKitruby dk.rb init ruby dk.rb install
安裝Python,也是一路next就可以,博客的代碼高亮用到了Python的Pygments模塊,在Python中安裝第三方庫需要使用easy_install,在下面地址下載跟Python相對(duì)應(yīng)的安裝程序安裝后就可以使用easy_install了。
https://pypi.python.org/pypi/setuptools
easy_install會(huì)安裝在Python安裝目錄的Scripts目錄中,例如我的Python目錄是C:\Python27,所以需要將C:\Python27\Scripts目錄加入到環(huán)境變量中才能在命令提示符中使用easy_install命令。
在命令提示符中輸入如下命令就可以安裝Pygments了。
easy_install pygments
首先在GitBash中輸入如下命令將Octopress代碼拉到本地,
cd d:/GitProjectgit clone git://github.com/imathis/octopress.git octopress
然后需要安裝Octopress的依賴項(xiàng),安裝依賴項(xiàng)需要用到Ruby的gem,使用下面的命令可以更換gem的更新源,使用國(guó)內(nèi)的淘寶鏡像速度相對(duì)快點(diǎn)。
gem sources -a http://ruby.taobao.org/gem sources -r http://rubygems.org/gem sources -l
修改Octopress目錄下的Gemfile文件,將第一行的http://rubygems.org/ 修改為http://ruby.taobao.org/
在命令提示符中進(jìn)入到Octopress目錄,輸入下面命令進(jìn)行依賴項(xiàng)的安裝
gem install bundlerbundle install
輸入下面的命令來安裝Octopress的默認(rèn)主題
rake install
到此所有的安裝工作已經(jīng)結(jié)束,輸入下面的命令可以在本地進(jìn)行預(yù)覽。
rake preview
如果博客中包含中文,需要進(jìn)行如下設(shè)置:
1. 在環(huán)境變量中設(shè)置下面的鍵值對(duì);
LANG=zh_CN.UTF-8
LC_ALL=zh_CN.UTF-8
2. 含有中文的文件需要保存為UTF-8無BOM格式編碼。
3. 在Ruby的安裝路徑找到 文件convertible.rb
C:\Ruby193\lib\ruby\gems\1.9.1\gems\jekyll-0.12.0\lib\jekyll\convertible.rb
將27行修改為:self.content = File.read(File.join(base, name), :encoding => 'utf-8')
使用下面命令可以在Octopress中添加文章
注意,rake new_post['my first octopress blog']中的my first octopress blog 并不是博客標(biāo)題,而是和生成的文件名以及url地址有關(guān),該名稱不支持中文。博客標(biāo)題可以在生成的markdown文件中修改。生成的markdown文件在octopress/source/_posts目錄中。
編輯markdown文件,將標(biāo)題可以修改為中文標(biāo)題,還可以設(shè)置分類等信息以及編寫正文部分
每次執(zhí)行了添加博客的命令,或是修改了現(xiàn)有博客的內(nèi)容后,都要執(zhí)行下面命令進(jìn)行重新生成
rake generate
如果之前有輸入rake preview的命令提示符窗口沒關(guān),可以直接localhost:4000來進(jìn)行預(yù)覽,否則需要重新執(zhí)行下rake preview才能進(jìn)行預(yù)覽。
首先需要您有一個(gè)Github的賬號(hào),并且知道怎么樣將Git項(xiàng)目推送到Github上,具體配置可以參考我之前的博文《Windows 下使用Git管理Github項(xiàng)目》
登錄到Github,創(chuàng)建一個(gè)名為username.github.com的repository,例如我創(chuàng)建的為oec2003.github.com;
在命令提示符中進(jìn)入到Octopress目錄,輸入下面命令:
rake setup_github_pages
按照提示輸入新建的repository的地址,例如我的地址為:
git@github.com:oec2003/oec2003.github.com.git
執(zhí)行命令rake deploy 就可以將本地的內(nèi)容發(fā)布到Github上。
最后需要將Octopress的源文件推送到Github的Source分支上,執(zhí)行下面命令即可:
git add .git commit -m “your message”git push origin source
如果喜歡寫博客有很多的平臺(tái)可以選擇,像博客園就是Net平臺(tái)下很好的博客平臺(tái),如果想搭建自己的個(gè)人博客有獨(dú)立的域名,WordPress是不錯(cuò)的選擇,如果您喜歡折騰,不妨試試Octopress。在環(huán)境搭建好的情況下,使用Octopress寫博客大致有一下幾個(gè)步驟:
1. 執(zhí)行rake new_post['title']來生成一個(gè)博文;
2. 找對(duì)生成的markdown文件,編輯內(nèi)容,當(dāng)然是使用markdown語法來編輯;
3. 執(zhí)行rake generate來生成文章;
4. 執(zhí)行rake preview在本地預(yù)覽;
5. 執(zhí)行rake deploy發(fā)布到Github中。
6. 執(zhí)行下面命令將修改的源碼推送到source分支:
git add .git commit -m “your message”git push origin source
在安裝的過程中可能會(huì)碰到各種問題,根據(jù)錯(cuò)誤提示信息google,肯定會(huì)找到答案。
最后推薦一個(gè)安裝Octopress的視頻:
聯(lián)系客服