hypra

SEO-003: more than one h1

Error: the page doesn't build until this is fixed.

The h1 is the page's main topic, for search engines and for screen reader users, who often jump to it first. Sections below it are h2.

Fails

page(title: "Shoes", description: "All our running shoes, from light racers to trail shoes.") {
  h1 "Shoes"
  h1 "Trail shoes"
}
error[SEO-003]: more than one h1 on this page
 --> page.hypra:3:3
  |
3 |   h1 "Trail shoes"
  |   ^^
  = help: a page has one h1 with its main topic; use h2 for sections
  = docs: https://hypralang.dev/rules/seo-003/

1 error, 0 warnings

Fixed

page(title: "Shoes", description: "All our running shoes, from light racers to trail shoes.") {
  h1 "Shoes"
  h2 "Trail shoes"
}

A design that really needs two, like a headline split in two lines, can switch the rule off with allow("SEO-003") "the reason".