Jekyllのコレクションの紹介

投稿日: 2022-04-20 2022-04-20
タグ: Jekyll

Jekyllのコレクションは、同じタイプのコンテンツの周りに独自の分類法を作成する簡単な方法を提供します。これは、グループに属する作品には最適ですが、実際には投稿ではなく、時系列で整理するべきではありません。コレクションの良い使用例は、コンテンツコラボレーターのためにこのWebサイトに実装された作成者ページです。

お気に入りの動物に関連するコンテンツを保持する簡単なanimalsコレクションを設定しましょう。

コレクションの構成

まず、_config.ymlファイルでコレクションを設定します。

_config.yml

collections:
  animals:
    output: true

output オプションをtrueに設定すると、コレクション内の各ドキュメントのページが生成されます。

次に、Jekyllサイトのルートフォルダーに _animals フォルダーを作成し、コレクション内の各動物のマークダウンファイルを入力します。

_animals/
  zebra.md
  lion.md
  alligator.md
  ...

これにより、たとえば / animal /zebraにアクセスして動物にアクセスできるようになります。必要に応じて、別のパーマリンク構造を定義することもできます…

_config.yml

collections:
  animals:
    output: true
    permalink: /my-animal/:name

…そして、それは私たちの動物のページを / my-animal /zebraのようなURLで利用できるようにします。

動物の属性のデフォルト値を定義できます。これは、コレクション内のすべてのドキュメントが同じレイアウトを共有する場合に役立ちます。たとえば、次のようになります。

_config.yml

collections:
  animals:
    output: true
    permalink: /my-animal/:name

defaults:

_config.yml に変更を加えた後、ローカルサーバーを再起動することを忘れないでください。

コレクションドキュメント

コレクションのmardownファイルの1つに含まれるコンテンツの例を次に示します。

_animals / zebra.md

---
layout: animal # You can ommit this if you've set it as a default
title: Zebra
class:     Mammalia
family: Equidae
headline: Zebras are the best!
picture: /images/animails/zebra.jpg
---

私たちの動物のそれぞれには、 title 、 class 、 family 、…、および[X180Xを使用して出力されるいくつかのマークダウンコンテンツ]の値が含まれます。 animalレイアウトの]{{content}}

getdocs

13036