このブログをjekyllで生成するにあたって、プラグインとかいろいろと調べたので、このエントリにまとめておきます。

基本的なこと

jekyllのプラグイン機能って？

jekyllにはプラグイン機能があり、いろいろとサイト生成の挙動を拡張できます。作成したプラグインは_pluginsディレクトリに配置して利用します。以下のページの「Available Plugins」というところで、利用できるプラグインも紹介されています。

プラグイン機能の説明： http://jekyllrb.com/docs/plugins/

jekyllではLiquidというテンプレートエンジンを利用しています。基本的には、変数の表示：{{ variable }}、機能の実行：{% function %}で、テンプレートを作成していきます。Liquidの文法などは次のページに説明があります。

jekyllとか関係ないこともありますが、ブログを生成する際に設定したことをずらっと並べていきます。

このブログでは、 {% icon fa-tag %} {% icon fa-calendar %} などのアイコンを利用していますが、これはFont Awesomeというツールキットのアイコンです。以下のプラグインを使えばLiquidのタグでアイコンを表示出来るようになります。

アイコンの一覧：　http://fortawesome.github.io/Font-Awesome/icons/

一覧ページをページングする場合は、次のページの方法で設定します。

タグページ（タグ毎の投稿一覧ページ）を作成する場合は、次のプラグインを利用します。このプラグインでタグクラウドも生成出来ます。

jekyll-tagginプラグイン：https://github.com/pattex/jekyll-tagging

カテゴリページ（カテゴリ毎の投稿一覧ページ）は、次のページを参考に作成しました。 jekyllのカテゴリページ：http://count0.org/2013/07/04/jekyll-category-page.html

サイトマップ（検索エンジンに読み込ませるためのサイトマップ）は、次のプラグインで生成できます。

投稿の本文に{{ variable }}のような記載があるとLiquidのタグとして処理され困ることがあるので、これを回避するために以下のプラグインで無効化出来るようにします。

数式の表示にはMathJaxを利用します。これでLaTexライクに数式が利用できます。以下はjekyllでの設定方法と、MathJax自体のドキュメントです。

MathJaxを利用する場合は_記号を頻繁に利用するので、redcarpetを利用している場合は、_config.ymlを以下のように設定して強調表示を無効にしておいた方が良さそうです。

markdown: redcarpet
redcarpet:
 extensions: ['no_intra_emphasis']

jekyllで生成するページは静的ページなので、サイト内検索は外部の機能を利用します（JavaScriptでなんとかするのもアリですが、）。このサイトで利用しているのはGoogleのカスタム検索です。

jekyllでは、_postsの代わりに_draftsというディレクトリ配下に原稿を置くとドラフト原稿となり、--draftsオプションをつけて起動した場合のみ、生成対象にすることが出来ます。これでドラフト原稿安心して、バージョン管理に含めることが出来ますね。。

他にもあるけど、ひとまずこんな感じ。。