Jekyll blog show posts under a category

Question

I want to show posts that are from a certain category. For example, going to url http://example.com/posts/programming will list all the posts that have "programming" as their category.

My general blog index looks like below

  {% for post in site.posts %}
    <div class="post-box">
      <div class="post-title">
        <a href="{{ post.url | prepend: site.baseurl }}">{{ post.title }}</a>
      </div>
      <span class="post-date">{{ post.date | date: "%b %-d, %Y" }}</span>
      <p class="post-excerpt">{{ post.excerpt }}</p>
      <div>
        {% for category in post.categories %}
          <a href="#">#{{ category }}</a>
        {% endfor %}
      </div>
    </div>
  {% endfor %}

If Jekyll does not automatically provide a specific url for each category, I would have to dynamically change the available posts based on the given url. I can of course create a directory dedicated to each category and then make index.html inside it, but there must be a better way.

It would be perfect if there were a way to dynamically change {% for post in site.posts %} part to {% for post in posts in some_category %} with javascript. Any help would be wonderful.

score 4 · Answer 1 · answered Jan 28 '15 at 13:26

I can of course create a directory dedicated to each category and then make index.html inside it, but there must be a better way.

This is a great way to do it, isn't much work at all and works flawlessly on gh-pages. It's exactly what I do on my own sites as I prefer to keep my .md posts filed by category in the directory structure, so I simply have:

/blog/
    /_posts/20015-01-01-my-awesome-post.md
    index.html

/labs/
    /_posts/20015-01-01-my-technical-post.md
    index.html

I find it preferable for maintenance to not have 1001 posts all in _posts/ and I get the pretty permalink structure I want without entering categories in each posts front-matter.

score 2 · Answer 2 · answered Jan 26 '15 at 10:09

2

That's exactly what https://github.com/jekyll/jekyll-archives is doing.

answered Jan 26 '15 at 10:09

David Jacquel

51,670
6
121
147

score 1 · Answer 3 · edited May 23 '17 at 12:09

You could use a plugin (for that, see David Jacquel's answer)...but you can't use it if you want to host your site on GitHub Pages, because GitHub Pages supports only a few plugins, and jekyll-archives isn't one of them.

So if you can't use a plugin, AFAIK there's no other way than to create a page for each category manually.
I'm no JavaScript guru, but I'm quite sure that it's not possible to dynamically change the category with JavaScript, because Jekyll pages are compiled once and can't be changed on the fly at runtime.

But creating a new category page for each category isn't as much work as it seems.

I have a blog post here where I explain how to do it:
Separate pages per tag/category with Jekyll (without plugins)

Short version:
(I'm using tags instead of categories here, but both work exactly the same)

Create a special layout file /_layouts/tagpage.html:

---
layout: default
---

<h1>{{ page.tag }}</h1>

<ul>
{% for post in site.tags[page.tag] %}
  <li>
    {{ post.date | date: "%B %d, %Y" }}: <a href="{{ post.url }}">{{ post.title }}</a>
  </li>
{% endfor %}
</ul>

With this layout file, you need only two lines of YAML front-matter to create a new tag page, for example /tags/jekyll/index.html:
```
---
layout: tagpage
tag: jekyll
---
```

Jekyll blog show posts under a category

3 Answers3

Linked