• 範例展示、文件
• gist

用法懶人包

1. 下載 Indexer for Octopress。
2. 將 indexer.rb 複製到 plugins 目錄下。

3. 新增 source\_includes\custom\asides\indexer.html。

   {% if page.indexer == true %}
     <section>
     <h1>Catalog</h1>
     {{ page.indexer_aside }}
     </section>
   {% else %}
     {% if site.page_asides.size %}
       {% include_array default_asides %}
     {% endif %}
   {% endif %}
   

4. 編輯 _config.yml。

   # Each layout uses the default asides, but they can have their own asides instead. Simply uncomment the lines below
   # and add an array with the asides you want to use.
   # blog_index_asides:
   # post_asides:
   page_asides: [custom/asides/indexer.html] # 加上這個
   

5. 完成！之後只要在你需要索引的 page 上方 YAML 區塊加上 indexer: true，右方欄位就會自己索引了。

安裝 Ruby

雖然你也可以安裝 RVM 或者自行編譯，但既然是在 Windows 下，建議直接使用 Ruby Installer 最省事。在此要下載兩個東西，一就是 ruby ，另一個則是 development kit。之所以要後者是因為屆時在安裝 Octopress 時，所需要用到的 ruby gems 會需要在本地編譯（例如 rdiscount）。而 development kit 是一套基於 MSYS/MinGW 下的 C/C++ 編譯環境工具組，安裝時請跟著官網上的指示即可，你大概會輸入以下指令：

cd C:\Devkit
ruby dk.rb init :: 產生 config.yaml，裡面有你的 ruby 路徑，一般會幫你設好
ruby dk.rb install

為了保險起見，安裝之後先更新一下 gem 是個好習慣。

gem update --system
gem update

正在苦惱 octopress 沒有可以顯示所有目錄地外掛時，在高見龍前輩的網誌上取到西經（看不懂的人，建議先閱讀過 jekll plugin）。但由於這種解在 rake preview 時會失敗，於是我開始撰寫 tag 版本。

嗯……好險我沒有寫完，因為我後來又發現在底下的回覆，tokkonoPapa...