Jekyll Tips1

2012-12-17

Jekyllの設定に関するメモ。

JekyllBootstrapの配置先は下記ディレクトリ。(関連記事)

/var/www/html/jekyll/JEKYLL_HOME/

・画面ヘッダ部分のナビゲーションを変更したい。

(例)
画面ヘッダ部分にArchiveを表示したくない場合
下記ファイルのヘッダ部分の"group: navigation"を#でコメントアウトする。
/var/www/html/jekyll/JEKYLL_HOME/archive.html

・記事タイトルに日本語を使いたい。

記事のファイル名に日本語は使えないので、YAMLのFront Matterでtitleを指定する。
(例)
---
layout: page
category: Jekyll
tags: [Ruby, RubyGems, Jekyll, GitHub]
date: 2012-12-23 00:00:00
title: Jekyllとgithubでブログ作成
---

・ループ回数を制限したい。

limitを使う。

(例)最近の5件だけ記事を表示。
{% raw %}
<ul class="posts">
  {% for post in site.posts limit:5 %}
    <li><span>{{ post.date | date_to_string }}</span> &raquo; <a href="{{ BASE_PATH }}{{ post.url }}">{{ post.title }}</a></li>
  {% endfor %}
</ul>
{% endraw %}

・liquidの文法をエスケープしたい。参考ページ

Markdownの中でif文やliquidの文法をそのまま出力したい場合、下記のタグを使用する。

{{ "{% raw " }}%}
エスケープしたい表現
{{ "{% endraw " }}%}

・日付のフォーマット(書式)を変更したい。参考ページ

日本語を使う場合、ファイルをUTF8で保存する。

(例)
{% raw %}
{ post.date | date: "%Y年%m月%d日" }
{% endraw %}

・文法に関する参考ページ