Octopress簡(jiǎn)介

Octopress is a framework designed by Brandon Mathis for Jekyll, the blog aware static site generator powering Github Pages.

優(yōu)點(diǎn)

用文件方式儲(chǔ)存數(shù)據(jù),，無需數(shù)據(jù)庫
以靜態(tài)方式發(fā)布，可直接掛在github等地方
用markdown格式寫博客
可以輕松的配置和發(fā)布

常用命令

注意

有些機(jī)子上運(yùn)行可能會(huì)報(bào)錯(cuò),，需要在命令前加上bundle exec

添加文章

1

$ rake new_post["title"]

運(yùn)行后會(huì)通過title生成相關(guān)文件,、鏈接，可在文件里修改顯示出來的標(biāo)題,。
title可以使用中文,，會(huì)自動(dòng)轉(zhuǎn)化為拼音（個(gè)人不建議，因?yàn)殒溄訒?huì)比較無意義）,。

1
2
3

$ rake generate       #發(fā)布文件到public目錄
$ rake watch          #監(jiān)控source和sass目錄的變動(dòng)
$ rake preview        #啟動(dòng)服務(wù)器并監(jiān)控變動(dòng),，通過http://localhost:4000預(yù)覽

發(fā)布

1
2

$ rake generate
$ rake deploy

保存源代碼

因?yàn)榘l(fā)布的只是生成的靜態(tài)頁面，
需要在項(xiàng)目里建立source分支用于保存整個(gè)項(xiàng)目源代碼（配置、markdown文件等）,。

1
2
3

$ git add .
$ git commit -m 'blog'
$ git push origin source

更多設(shè)置

添加”關(guān)于我”

在source下新建about目錄,，并在里面添加index.markdown文件。
編輯導(dǎo)航條source/_includes/custom/navigation.html
注意:index.markdown文件需要加上頭,，否則會(huì)找不到,。

首頁只顯示摘要

• 在文中加入<!--more-->來控制摘要截取位置
• 修改_config.yml里的excerpt_link控制鏈接文字

部署到Github

操作步驟參考：Deploying to Github Pages
如果你有自己的域名，可參考：Github Page綁定自己域名

Bug Fix

不能進(jìn)行deploy(Github)

問題：有次發(fā)現(xiàn)$ rake deploy不能發(fā)布,，但是預(yù)覽正常,。檢查github上source分支代碼已更新，但master仍為老代碼,。
原因：發(fā)現(xiàn)是因?yàn)榇a是新從github下clone下來的,，未進(jìn)行初始化deploy。
解決：需要執(zhí)行$ rake setup_github_pages進(jìn)行初始化,。
注意：rake操作應(yīng)該在source分支下進(jìn)行,，若是剛從github里clone下來的，請(qǐng)先執(zhí)行$ git checkout source,。

修改的樣式preview時(shí)不生效

問題：預(yù)覽時(shí)發(fā)現(xiàn)之前設(shè)置成功的自定義樣式不生效,，變回默認(rèn)樣式。
解決：$ rake generate即可,，會(huì)重新生成css,。

參考

Octopress官方文檔
markdown語法