Color theme Dark mode Font size Content width

Hugo: ignore _index.md in list templates

How I ignore _index.md files in my list templates

Published on 01/3/2020

While creating my new website I also added more sections, namely a blog, photography, and art section. All of these use list templates and render “article”-like content previews. I wanted to add some content to these lists and Hugo has a special file named _index.md for that. This file can be used to create index pages for lists.

When I did that I somehow also included the index files in the post listings which was not what I wanted, so I added a if statement to my article-preview.html template that is used to render article previews.

{{ if ne .File.LogicalName "_index.md" }}
<article class="article article--in-list" aria-labelledby="article-heading-{{ .File.UniqueID }}">
    [...]
</article>
{{ end }}

{{ if ne .File.LogicalName "_index.md" }} checks if the file name is not _index.md - this will ignore all _index.md files from being rendered with the article-preview.html template.

It does the job but feels wrong and hacky, so if you know a better solution, please let me know on GitHub or Mastodon.

Categories

Tags

Like this?

If this content has helped you or your company, consider making a donation to a good cause.

For example, consider donating to the following causes:

A Selfie of me

Kevin Gimbel

is a DevOps Engineer and avid (Video) Gamer. He’s also interested in Sci-Fi, Cyberpunk, and dystopian books.

Wearing a mask is a good idea!

You can find out more about me if you wish.