Skip to content

Document section index pages for blog authors #3

Description

@hlassiege

Follow-up to bloggrify/bloggrify#13.

Section index pages are supported since bloggrify/bloggrify@df5d784, but they are not documented for blog authors.

Today MinimalistListing only appears in content/4.recipes/2.theme-recipe.md, which targets theme authors and shows the Vue component. There is nothing telling someone writing markdown how to build an index page for a content directory. The only description of the MDC syntax lives in an announcement post on the minimalist demo blog, which is not documentation.

What is missing, probably in 1.introduction/ next to the page about writing pages:

  • putting an index.md in a content directory to create the section page
  • the :minimalist-listing{...} MDC syntax and its parameters: title, tag, category, prefix
  • a concrete nested example, for instance content/japan/kansai/index.md listing everything under japan/kansai
  • the current limitation: only one listing component per page, because of a pagination conflict

Reference examples: https://minimalist.bloggrify.com/2025/new-custom-component

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions