4.2 Jekyll のルール

1. 基本的なルール

   • 全てのjekyllファイル⁽¹⁾は「フロントマター(front matter)＋内容(content)」で構成される

     【index.html の例】

     ---
     layout: default  ┬→ フロントマター
     title: Home      ┘
     ---
     <h1>{{ "Hello World!" | downcase }}</h1>  → 内容
     

     • フロントマターは"---"で区切られた部分

       　ここには「変数名:値」という形で変数に値を設定できる ⁽²⁾．なお フロントマターは必 須ではないが，これがないと Jekyll はスルーします ;-)

   • 全てのページのデータはオブジェクトになる
     • 当該ページの内容⇒content
     • 当該ページのフロントマターの変数⇒page.変数名
     • ブログサイトおよびコレクションで作成したサイトはそれぞれ固有名で指定
   • ページ内容はLiquid言語[5]で制御できる
     • オブジェクトの出力⇒{{オブジェクト名}}
     • コンテンツの制御(タグ)⇒{%制御文%}…{%終了文%}
       • {% assign foo = "bar" %}
       • {% if…%}…{% endif %}
       • {% for foo in bar %}…{% endfor %}
     • オブジェクトの編集(フィルター)⇒{{ foo |フィルター名[…] }}
2. ブログサイト(_posts)のルール
   • _postsにYYYY-MM-DD-タイトル名.mdという名前のファイル名のファイルにマークダウン形式で書く
   • 各ファイル名は変換されてsite.posts配列に格納(ここではその要素をpostとする)
     • そのファイルに対応するページのURL⇒post.url (YYYY/MM/DD/タイトル名.html)
     • そのファイルに対応するページのタイトル名⇒post.title (タイトル名)
     • そのファイルの内容の最初の段落⇒post.excerpt
3. データサイト(_data)のルール

   • YAMLの入れ子マッピング形式で書くとマッピングの配列になる

     【_data/navigation.yml の例】

     - name: Home
       link: /
     - name: About
       link: /about.html
     - name: Blog
       link: /blog.html
     - name: Staff
       link: /staff.html
     

     　各シーケンスを要素(ここでは item とする)として site.data.navigation 配列で参照できる．各要素の変数は， item.name および item.link で参照できる．

4. コレクションサイトのルール
   • コレクションサイトの作成手順

     1. コレクションを定義する(_config.yml)

        collections:
          コレクション名:
            output: true

        　collections キー以下はインデントして，それぞれのコレク ション名のスコープを考慮しないといけない．デフォルトで はコレクションはドキュメントページを出力しないようなので， 必ず最後に "output: true" を付けておくこと．

     2. コレクションサイトを作成する

        　"_コレクション名" のディレクトリを掘る．この中にデータファイルを入れる．

     3. データを作成する

        　コレクションサイトに，"ファイル名.md" のデータファイルを作成する．

        • データファイルの中身は"site.コレクション名"配列に格納

5. 各ファイルのデフォルト設定を一括管理

   　_config.yml の中の defaults キーで設定できる

   • 設定方法

     defaults:
       - scope:
           path: "対象とするファイルのパス"
           type: "対象とするファイルのタイプ"
         values:
           layout: "適用するレイアウト"
     

     • path：""の場合は全てのファイルが対象になる
     • type：Jekyllの定義するタイプで，postsおよびコレクションで定義されたコレクション名