CODEWITHSUNDEEP
htmlyamljekyllgithub-pages
wigging
wigging

Reputation: 9170

Manually order a Jekyll collection

As mentioned in the Jekyll docs here, I have the following in my _config.yml as:

collections:
  sections:
    order:
      - introduction.md
      - battery-state.md
      - vibe.md
      - references.md

To render the content of each file within the HTML, I have the following:

{% for section in site.sections %}
  {{ section.content }}
{% endfor %}

However, the content order is not presented as what I defined in the config file. How do I display the content in the order I defined in the config file?

Upvotes: 1

Views: 827

Answers (2)

Mr. Hugo
Mr. Hugo

Reputation: 12592

You can also choose to add the sections to the front matter of the page. This is useful when you are not using Jekyll v4 or you want the user to be able to edit the order in CloudCannon, Netlify CMS, Forestry or another CMS with front matter editor.

sections:
  - introduction
  - battery-state
  - vibe
  - references

And the use a layout like this:

{% for s in page.sections %}
    {% for section in site.sections %}
        {% if s == section.slug %}
             ...
        {% endif %}
    {% endfor %}
{% endfor %}

Upvotes: 2

ashmaroli
ashmaroli

Reputation: 5444

Manually ordering documents in a collection was introduced in Jekyll 4.0 To use this feature, make sure that you're using Jekyll 4.0

For a site deployed on GitHub Pages, that would mean having to build the site outside GitHub Pages environment and upload the contents of the destination directory (_site).

Upvotes: 2

Related Questions