Demote <h1> to <h2> on index page

bastibe / org-static-blog

A static site generator using org-mode

BSD 3-Clause "New" or "Revised" License

342 stars 74 forks source link

Open bastibe opened 5 years ago

bastibe commented 5 years ago

A website should only have one <h1>. However, our index page currently contains every post in its entirity, including each posts <h1>.

Possible solutions:

keep as is.
demote <h1> to <h2>. Then we might have multiple levels of <h2> in a single post. We could make it look right in CSS, but it is structurally wrong.
demote all <hX> to <hX-1>. What to do about <h5>? This might break the layout.

Any other ideas?

fapdash commented 2 months ago

There is a spec conforming way to define h7 for screen readers, but I don't know how many of them actually handle that as intended: https://www.w3.org/TR/WCAG20-TECHS/ARIA12.html#ARIA12-ex2