Configuration d’une collection

Il faut déclarer la collection dans le fichier de configuration de Jekyll; à savoir _config.yml.

collections:
  doc:
    output: true

Positionner output à true permet de générer individuellement chaque page contenue dans la collection. Ainsi, une collection composée des éléments suivants sur le disque :

• _doc/index.md
• _doc/graphite.md
• _doc/nodej.md

donnera dans le dossier _site les fichiers /doc/index.html, /doc/graphite.html et /doc/nodejs.html.

En positionnant output à false, ces fichiers ne seraient pas générés. Le contenu de la collection resterait cependant accessible par le langage de templates depuis n’importe quelle page appelant cette collection.

Ajout d’un contenu à une collection

Créez un dossier correspondant à la collection déclarée à la racine de vos sources; _doc dans mon cas. Notez le tiret bas qui permet à Jekyll de ne pas copier tel quel ce dossier comme le dossier _posts ou _drafts.

Ajouter du contenu se fait de façon classique, comme une page ou un post.

Affichage d’une collection

Chaque collection est accessible à partir de la variable site.nom_collection. Ainsi notre collection de doc est accessible à partir de site.doc.

---
layout: default
---

  {% for page in site.doc %}
     
{{ page.date | date: "%b %-d, %Y" }} {{ page.title }}

  {% endfor %}