今天在使用 rake deploy 試圖發佈文章時，在發佈到 Github 這步驟時發生了錯誤，發佈的動作被 rejected 了。 {% img /images/posts/OctopressDeployFail/1.png %} 要解決這樣的問題我們可以依下面步驟操作。 cd _deploy git reset --hard origin/master cd .. 就像下面這樣： {% img /images/posts/OctopressDeployFail/2.png %} 操作完就重新建立靜態檔案並 Deploy。 rake generate rake deploy 沒意外的話就能正確的發佈。 {% img /images/posts/OctopressDeployFail/3.png %} Link ruby - Octopress pushing error to GitHub - Stack Overflow

新增 About Me 檔，檔案位置存放在 source/_includes/custom/asides 下。 {% img /images/posts/OctopressAboutMe/1.png %} 編輯後存檔退出。 {% img /images/posts/OctopressAboutMe/2.png %} 接著開啟 _config.yml 設定檔找到 blog_index_asides 設定，將剛編輯好的 About Me 檔設上。 {% img /images/posts/OctopressAboutMe/3.png %} 存檔退出，編譯網頁後啟用預覽功能，即會看到側欄這邊多出剛我們設在 About Me 檔的內容。 {% img /images/posts/OctopressAboutMe/4.png %} Link Theming & Customization - Octopress

要為 Octopress 新增 Categories 頁面，首先需先叫用下列命令產生新的頁面： rake new_page[page] 像是下面這樣： {% img /images/posts/OctopressCategories/1.png %} 然後開啟剛所建立的頁面，加入用來產生 Categories 頁面的程式。 {% img /images/posts/OctopressCategories/2.png %} 這邊頁面的 Sharing ，Comments 與 Footer 都可以順帶修改將之關閉，一般來說 Categories 頁面是不需要這些的，修改完後存檔離開。 接著開啟 /source/_includes/custom/navigation.html 設定檔設定上方的選單，把我們剛建的 Categories 頁面設定上去。 {% img /images/posts/OctopressCategories/3.png %} 存檔離開，建置後啟用預覽功能，即會看到上方選單多出 Categories 這個選單選項，點擊切換可看的到 Categories 頁面正常的運作。 {% img /images/posts/OctopressCategories/4.png %} Link Theming & Customization - Octopress

Octoflat Theme 預設就有支援 Linkedin Profile 的連結，只要在 _config.yml 設定檔中設定 linkedin_user，將 Linkedin User ID 設上去就可以了。 {% img /images/posts/OctopressOctoflatLinkedinProfile/1.png %} 呼叫命令產生靜態網頁並啟用預覽： rake generate rake preview 我們可以看到在部落格的右上方會多出 Linkedin 的 Icon。 {% img /images/posts/OctopressOctoflatLinkedinProfile/2.png %} 點擊該 Icon，沒意外的話應該可以看到 Linkedin 的 Profile 頁面。 但是筆者看到的畫面卻是… {% img /images/posts/OctopressOctoflatLinkedinProfile/3.png %} 因為 Octoflat 他的 Linkedin Profile 位置是設成 http://www.linkedin.com/in/[UserID]，而 Linkedin Profile 的位置看起來是有很多不同的可能，像是筆者的 Profile 位置就不是 Octoflat 預期的那樣。 {% img /images/posts/OctopressOctoflatLinkedinProfile/4.png %} 因此筆者修改 source/_includes/navigation.html 檔案，為其加入 linkedin_url。 {% if site.linkedin_url %} <li><a href="{{ site.linkedin_url }}" title="Linkedin Profile"><i class="icon-linkedin-sign social-navbar"></i></a></li> {% endif %} 像是下面這樣：

要更換 Octopress 的 Theme，我們可先找到要替換的 Theme。 這部份可參閱 Opthemes · Octopress Themes ，它有將 Octopress 可用的 Theme 做個整理，並以縮圖方式呈現， Theme 套用起來的樣子一目了然。 找到喜歡的 Theme 後可以到範例網站做進一步的預覽。 若沒有什麼問題，也以確定就是要套用該 Theme 的話，可到 GitHub 查閱進一步的安裝與設定步驟。 除了 Opthemes · Octopress Themes 外，也可以到 3rd Party Octopress Themes · imathis/octopress Wiki · GitHub 這邊看看有無喜歡的 Theme，它的 Theme 介紹的比較多，但沒提供縮圖預覽，使用上比較沒那麼直覺。 找到 Theme 後，基本上安裝方式都一樣，就是將 Theme 用 Git Clone 下來，Clone 下來後呼叫 rake install 任務進行安裝，安裝完後叫用 rake generate 產生靜態網頁。 git clone GIT_URL .themes/THEME_NAME rake install['THEME_NAME'] rake generate 安裝完後，各套件可能會要做不同的設定動作，因此建議還是要到對應的 GitHub 網站，餅以上面的操作為主。

sitemap.xml 是 Google 提出來的標準，以 XML 為格式，紀錄著網頁的連結與最後修改的時間。 {% img /images/posts/OctopressNotifySearchEngine/1.png %} 如果要即時通知搜尋引擎更新，而不等待搜尋引擎自行檢測，我們可以主動將 sitmap.xml 上傳給搜尋引擎。 若是想要在 Octopress 中做這動作的話，我們可以編輯 Octopress 的 Rakefile 檔案，將下面腳本加入。 desc 'Ping pingomatic' task :pingomatic do begin require 'xmlrpc/client' puts '* Pinging ping-o-matic' XMLRPC::Client.new('rpc.pingomatic.com', '/').call('weblogUpdates.extendedPing', 'Level Up' , 'http://larrynung.github.io', 'http://larrynung.github.io/atom.xml') rescue LoadError puts '! Could not ping ping-o-matic, because XMLRPC::Client could not be found.' end end desc 'Notify Google of the new sitemap' task :sitemapgoogle do begin require 'net/http' require 'uri' puts '* Pinging Google about our sitemap' Net::HTTP.

Octopress blog架設好後，預設的部落格網址格式為 /blog/:year/:month/:day/:title/，會在網址那邊多一層不必要的 blog 目錄，要將這層不必要的目錄拿掉，我們可以開啟 _config.yaml 進行些修改，將 permalink、 category_dir、與 pagination_dir 的 /blog 前綴給拿掉 (Demo)。 #permalink: /blog/:year/:month/:day/:title/ permalink: /:year/:month/:day/:title/ #category_dir: blog/categories category_dir: categories #pagination_dir: blog # Directory base for pagination URLs eg. /blog/page/2/ pagination_dir: # Directory base for pagination URLs eg. /page/2/ 接著將 source/_includes/custom/navigation.html 檔案開啟，針對上方巡覽列這邊的連結部分作些修改，一樣將 /blog 前綴給移掉 (Demo)。 <li><a href="/">Home</a></li> <li><a href="/archives">Archives</a></li> 同樣的動作也要對 source/index.html 做一次。 <a href="/archives">Archives</a> 網址跟連結都做完，記得要將本來放在 source/blog 下的資料移到source (Demo)。 mv -v source/blog/archives source/ 最後老樣子建置網頁並預覽 rake generate rake preview 預覽沒什麼問題的話將之佈署上去

要修改Octopress部落格的RSS訂閱位置。 可以開啟_config.yaml設定檔，將subscribe_rss設定設為我們想要使用的RSS訂閱位置。 {% img /images/posts/OctopressChangeRssSubscribeLink/1.png %} 像是筆者就將RSS訂閱位置改為FeedBurner。 設定完後建置發佈，將部落格跑起來就會發現RSS訂閱位置已經變成我們所設定的。 {% img /images/posts/OctopressChangeRssSubscribeLink/2.png %} {% img /images/posts/OctopressChangeRssSubscribeLink/3.png %}

在Octopress上撰寫文章時，若不特別做些處理，在Blog分頁那邊會將所有文章的全文依序列出。 這樣的呈現方式很難被訪客所閱讀，通常我們會期望只顯示部分的文章內容，若有興趣在進ㄧ步的去閱讀全文，這樣文章也比較好找。 若您也有這樣的需求，可以開啟_config.yaml這個設定檔，在excerpt_link這邊設定進ㄧ步閱讀的按鈕所要呈現的字樣。 {% img /images/posts/OctopressReadMore/1.png %} 設定好後存檔，並在撰寫文章的同時，加入特定的註解: <!--More--> 像是這樣 {% img /images/posts/OctopressReadMore/2.png %} 該註解可以用以指定文章的摘要要顯示到哪。 實際將部落格跑起來就會像下面這樣: {% img /images/posts/OctopressReadMore/3.png %}