Do you want to publish a blog post series ?

roq-plugins (5 Parts Series)

1 The first Roq plugin is for tagging (with pagination)
2 The second Roq plugin is for redirecting your page to a better place!
3 Write your blog posts in AsciiDoc
4 Need a QR Code?
5 Do you want to publish a blog post series ?

So you plan to do a series of blog posts about a given subject. This is as simple as adding a series attribute to the front matter of your posts.

Step 1: Add the Series plugin in your dependencies file:

<dependency>
    <groupId>io.quarkiverse.roq</groupId>
    <artifactId>quarkus-roq-plugin-series</artifactId>
    <version>${quarkus-roq.version}</version>
</dependency>

Step 2: Edit the layout for your posts, for example when using roq-default theme:

---
layout: theme-layouts/roq-default/post
---

{#include partials/roq-series /} (1)

{#insert /} (2)

This will add the series partial before the post content, if it’s declared.
This is the post content.

And finally, use this layout and add the series attribute in the Front Matter of the posts you want to join.

---
layout: series-post
title: Assemble you blog post in a series
description: Automatically series header for your posts
tags: plugin, frontmatter, guide, series
author: John Doe
series: My series Title (1)
---

You should use the exact same title for all documents in the series.

It will add the following at the head of your post:

A bit like what you see at the very begining of this post.