How to show posts in "Just the docs"

[SvenFlock]

Hi,

I have created an empty project with Jekyll and installed the "Just the docs" theme. The init scripts created a _posts folder with a sample post in place. However, the post is not rendered in the HTML. I have searched the docs but have found no hint.

As this is purely documentation focused theme: is this disabled by default? I wanted to use the posts feature for changelogs.

If you want to have a look, you can find my test repo here.

Thanks!

[mattxwang]

@SvenFlock you would just need to write some liquid code that searches through site.posts and renders whatever liquid/HTML you'd like. Just the Docs doesn't touch the posts feature at all, other than adding the default layout to post pages.

The Jekyll docs on posts are a good read if you're not familiar. Her'es a relevant snippet (that you would need to change to fit your purposes)

<ul>
  {% for post in site.posts %}
    <li>
      <a href="{{ post.url }}">{{ post.title }}</a>
    </li>
  {% endfor %}
</ul>

[SvenFlock]

Thanks for the quick reply. Your code snippet worked perfectly. Sorry for asking that question but I was reverse-engineering the examples from Jekyll and the home page presented the posts out of the box. So this must be hard-wired somehow in the theme.

Thanks again!

[mattxwang]

So this must be hard-wired somehow in the theme.

Great intuition! The default Jekyll project comes with the minima theme, which along with other things, overrides the index.md and includes the snippet above (+ other styling). Since we don't inherit the minima theme, you'd have to implement that feature yourself.

If you're curious, you can take a look at the Minima source code - especially if you have other things you'd like to replicate in JtD.

In addition, you are always free to open an issue to request a new feature.