Markdown in a section list page?

support
1

Hi,

First of, thanks for creating this excellent bit of software. I forgot how much I liked writing because I used to spend all my time fighting the tools.

I have a section list template that I have written that pulls some keys out of the front matter of all the pages in that section, and renders them into a table. So far so good, but I want to have a bit of text at the top of the page explaining what the table represents. Is it possible to write that text in a content markdown file and have the template render it out, or do I have to fall back to having content as HTML in the template?

Thanks

2

Having List front-matter and content in a markdown file is on the road map, but itā€™s not possible right now. You have to do that in the HTML layout.

3

Thanks! Is there a Github issue or something covering this? Iā€™ve been looking for an excuse to learn Go

4

I donā€™t think there is a GH issue simply because itā€™s not a trivial fix. See Node Improvements for a discussion of the topic. If youā€™re new to Go, Iā€™d suggest starting with something smaller. :smiley:

We tag some of our GH issues with experience-level tags. See the beginner issues.

5

I was in a similar situation and just abused content types for that on my frontpage. I just created a post with a unique type and used .Data.Pages with some filtering to just fetch that one post for rendering. You can find an example here :slightly_smiling:

6

What I have suggested in another thread is to store these ā€œsection listā€ texts in /data.

Then do:

``
{{ (index .Site.Data.sections .Section).someText | markdownify }}



The above is typed really fast and probably full of error. But I hoe it gets the message through.
7

Thanks! I ended up implementing a variant of this. Template has two loops, one that renders out all pages in the section with the type ā€˜_headerā€™, and the other that renders out everything that isnā€™t ā€˜_headerā€™.

8

Awesome. Thanks for sharing! Iā€™m currently evaluating Hugo and the ā€œmarkdown in a section list pageā€ issue was something that was kind of a blocker for me. Your solution is however elegant and easy to implement. So thanks again!

9

Sounds great. Would you mind sharing some sample code?

10

Sure. The section template is here, and the content is in here. The resulting site looks like this

1 Like
11

Thanks! This is really helpful!