Support for "lead section"

[OndraZizka]

On the index page(s), the template author can only use 1-line title, or the full content.

But it's a common practice to have lead section. Content authors then keep this in mind stylistically and treat the lead section as a bait for the reader.

This can be quite easily done - good markup languages support adding CSS classes to sections in some way. JBake could simply take the first //div[@class='leadParagraph']|//section[@class='leadParagraph']| and store it's inner HTML to an extra ODocument field.

Example in Texy:

New cool feature!
##############

/---section .(lead)
JBake has a new feature.
\---

Coming in next release.

Would you like that?

[OndraZizka]

As a workaround, one could use this class to show that part and hide the rest, with a bit of JS tweaking, but the main issue would still be performance. Phones won't deal with the large DOM easily.

[jonbullock]

I have seen some define the value for the lead in the metadata header for the file, not saying it's ideal but it's one solution.

[slavus]

Hi,

I am using a simple trick, and maybe it works for you. I am using thymleaf for templating engine. I use a divider and than use substring funcion to show only first part of post as summary.

In my posts I add a simple html comment like this . This is a divider between summery shown on posts index page and whole text that is shown on separate post page.

In my posts index template i have than this:

<h2 class="subtitle is-4" th:text="${#dates.format(post.date, 'dd MMMM yyyy')}">December 25, 2018</h2>
<h1 class="title" th:text='${post.title}'>Title </h1>
<block th:utext='${#strings.substringBefore(post.body,"<!--more-->")}'>post block</block>
<br />
<a class="button is-outlined" th:href="${post.uri}">Read more</a>

I hope this helps. I banged my head how to solve this issue.

[jonbullock]

Thanks for taking the time to share your solution @slavus