文章出處

利用Octopress在github pages上搭建個人博客

SEP 29TH, 2013

在GitHub Pages上用Octopress搭建博客,需要安裝ruby環境、git環境等。本人在Fedora下成功搭建Octopress,這里把主要步驟和遇到的問題做一個記錄。

在搭建的過程中發現yum安裝的ruby與rake在管理octopress博客的時候會引起沖突,要使用rvm的方式安裝ruby和rake;另外rvm一般用curl一段腳本來安裝的話,網址有所變化,原來的教程中的網址要“去掉一個點”。

 

1.安裝rvm
curl https://rawgithub.com/wayneeseguin/rvm/master/binscripts/rvm-installer | bash -s stable
網上很多教程用raw.github這個站點,但目前需要使用去除”.“的網址

2.將rvm命令添加到系統path中
echo ‘[[ -s “$HOME/.rvm/scripts/rvm” ]] && . “$HOME/.rvm/scripts/rvm” # Load RVM function’ >> ~/.bash_profile
source ~/.bash_profile
如果不做這一步,第3步的”rvm use 1.9.3”將不起作用

3.安裝ruby1.9.3 
rvm install 1.9.3 或者用2.0也可以
rvm use 1.9.3 或者用2.0也可以 
這是下載ruby和rubygem源代碼后本地自動編譯安裝.ruby和rubygem的版本要對應,這里會自動解決。

此時,可以查看ruby版本:ruby —version 我在shell下看到的是:ruby 1.9.3p448 (2013-06-27 revision 41675) [x86_64-linux]

4.確保你裝了git 
用git —version查看版本 
如果沒有安裝git,那就sudo yum install git-core

5.下載octopress
不要認為是網頁上的“下載”,這里是用git的方式:
cd ~/workspace/blog
git clone git://github.com/imathis/octopress.git octopress
如果下載速度超慢請嘗試修改hosts

6.安裝bundle
cd octopress
gem install bundler
bundle install
這里很奇怪,先前bundle的時候一直報錯,換成ruby.taobao.org還是報錯,但這次沒有修改Gemfile竟然下載安裝無阻。

7.安裝主題
rake install [‘theme-name’]
如果只是rake install表示安裝默認主題(位于octopress/.theme)
這里如果遭遇rake install aborted錯誤,說rake版本不正確,因為rvm幫我們下載了0.9的版本,但是如果用yum install的話裝的是10.x的版本,需要先yum remove rake。。感覺ruby的包管理機制真煩。

8.后續操作
生成模板:
rake generate

本地預覽:
rake preview
可以通過127.0.0.1的4000端口查看

添加新文章
rake new_post[“文章標題”] //可以直接輸入中文,Octopress 自動將漢字轉換成拼音url
例如:rake new_post[“hello”]
會在source/_post/生成hello.markdown的文件
用文本編輯器打開后編輯即可。

添加新頁面
rake new_page[“about”]

其他的編輯項
blog的配置信息修改: _config.ym

9.部署到github
需要先在github上建立一個repo,名字格式為username.github.io
官方主頁的說明https://help.github.com/articles/user-organization-and-project-pages

然后是rake setup_github_pages
會詢問你的repo的地址,填寫你剛剛建立的repo的全稱。
如果使用git@的形式,需要github的ssh設定過,否則會報錯:
ssh-keygen
文件名取為/home/username/.ssh/github
然后就生成了key,復制/home/username/.ssh/github.pub中的內容,粘貼到github上account setting中的ssh key里面就ok了。

然后是部署:
rake deploy
如果github上比本地版本高則部署會失敗,可以修改Rakefile第264行,“#”前添加“+”即可

ok,查看一下,比如我的:zchrissirhcz.github.com
可以看到octopress已經在了!

10.域名綁定
官方的幫助:https://help.github.com/articles/setting-up-a-custom-domain-with-pages  比如在godaddy買了example.com域名,然后把A記錄改為 204.232.175.78(git page) 然后在本地octopress/source目錄下新建CNAME文件,填寫example.com
據說國外DNS容易被墻,索性換成DNSPOD好了

 

總結:
新建文章:rake new_page[‘文章名’]
增刪改查:在octopress/source/_posts中進行
生成:rake generate 預覽:rake preview 部署:rake deploy

參考:
http://beyondvincent.com/blog/2013/08/03/108-creating-a-github-blog-using-octopress/  http://easypi.github.io/blog/2013/01/05/using-octopress-to-setup-blog-on-github/  http://ginsmile.github.io/blog/2013/08/29/octopressbo-ke-ji-qiao/#.UkfO2x0W1q8 http://beiyuu.com/github-pages/


文章列表


不含病毒。www.avast.com
arrow
arrow
    全站熱搜
    創作者介紹
    創作者 大師兄 的頭像
    大師兄

    IT工程師數位筆記本

    大師兄 發表在 痞客邦 留言(0) 人氣()