Index page skips <h2> header #52

New issue

Closed

opened 2026-03-17 17:26:16 +01:00 by neil_neilzone · 1 comment

neil_neilzone commented

2026-03-17 17:26:16 +01:00

When the index page is generated, it uses an h1 tag for "Latest Posts", and an h3 tag for each article title. e.g.:

<h1>Latest Posts</h1>
<div class="posts-list">
    <article>
        <h3><a href="https://my-notes.dragas.net/2026/03/13/the-scent-of-the-city/">The Scent of the City</a></h3>

This means that the h2 tag is skipped.

I have read that skipping heading ranks can be confusing and should be avoided where possible.

Might it be worth updating scripts/build/generate_index.sh to use an h2 tag for articles?

When the index page is generated, it uses an `h1` tag for "Latest Posts", and an `h3` tag for each article title. e.g.: ``` <h1>Latest Posts</h1> <div class="posts-list"> <article> <h3><a href="https://my-notes.dragas.net/2026/03/13/the-scent-of-the-city/">The Scent of the City</a></h3> ``` This means that the `h2` tag is skipped. I have read that [skipping heading ranks can be confusing and should be avoided where possible.](https://www.w3.org/WAI/tutorials/page-structure/headings/) Might it be worth updating `scripts/build/generate_index.sh` to use an `h2` tag for articles?