From c2261bfc9fd0b9b5fc6bb3ba7511533b5ab5ecce Mon Sep 17 00:00:00 2001
From: Vigilio Desto <vigilio@trentuna.com>
Date: Fri, 10 Apr 2026 20:33:25 +0200
Subject: [PATCH] =?UTF-8?q?drop=20<main>,=20use=20<article=20role=3D"main"?=
 =?UTF-8?q?>=20=E2=80=94=20bold=20landmark=20structure?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

body direct children: <nav>, <header>, <article role="main">, <footer>
- <nav>: site navigation (own landmark)
- <header>: page identity — title, author, date, metadata
- <article role="main">: content (screen reader gets landmark via role)
- <footer>: site footer

No <main> wrapper. Fewer tags, clearer signal.
Header block defined per-layout (prose gets eyebrow/date, docs gets hgroup).
Content block defined per-layout (docs adds sidebar <nav> + <aside> TOC).
---
 layouts/_default/baseof.html |   7 +-
 layouts/_default/list.html   |  48 ++++-----
 layouts/_default/single.html |  47 ++++----
 layouts/docs/single.html     | 192 +++++++++++++++------------------
 layouts/index.html           |  56 +++++-----
 layouts/paper/single.html    |  95 +++++++---------
 layouts/vault/single.html    | 203 ++++++++++++++++-------------------
 7 files changed, 291 insertions(+), 357 deletions(-)
diff --git a/layouts/_default/baseof.html b/layouts/_default/baseof.html
index 706117c..7943483 100644
--- a/layouts/_default/baseof.html
+++ b/layouts/_default/baseof.html
@@ -4,10 +4,9 @@
   {{- partial "head.html" . -}}
 </head>
 <body>
-  <header>
-    {{ partial "nav.html" . }}
-  </header>
-  {{ block "main" . }}{{ end }}
+  {{ partial "nav.html" . }}
+  {{ block "header" . }}{{ end }}
+  {{ block "content" . }}{{ end }}
   <footer>
     <small><a href="/">{{ .Site.Title }}</a> · {{ now.Format "2006" }}</small>
   </footer>
diff --git a/layouts/_default/list.html b/layouts/_default/list.html
index 2be3e17..16ef30c 100644
--- a/layouts/_default/list.html
+++ b/layouts/_default/list.html
@@ -1,26 +1,24 @@
-{{ define "main" }}
-  <main>
-    <article data-layout="prose">
-
-      <header>
-        <h1>{{ .Title }}</h1>
-        {{ with .Description }}<p>{{ . }}</p>{{ end }}
-      </header>
-
-      <section>
-        {{ range .Pages }}
-        <article>
-          <header>
-            <h2><a href="{{ .Permalink }}">{{ .Title }}</a></h2>
-            <p data-text="dim">
-              <time datetime="{{ .Date.Format "2006-01-02" }}">{{ .Date.Format "January 2006" }}</time>
-            </p>
-          </header>
-          {{ with .Summary }}<p>{{ . }}</p>{{ end }}
-        </article>
-        {{ end }}
-      </section>
-
-    </article>
-  </main>
+{{ define "header" }}
+  <header>
+    <h1>{{ .Title }}</h1>
+    {{ with .Description }}<p>{{ . }}</p>{{ end }}
+  </header>
+{{ end }}
+
+{{ define "content" }}
+  <article role="main">
+    <section>
+      {{ range .Pages }}
+      <article>
+        <header>
+          <h2><a href="{{ .Permalink }}">{{ .Title }}</a></h2>
+          <p data-text="dim">
+            <time datetime="{{ .Date.Format "2006-01-02" }}">{{ .Date.Format "January 2006" }}</time>
+          </p>
+        </header>
+        {{ with .Summary }}<p>{{ . }}</p>{{ end }}
+      </article>
+      {{ end }}
+    </section>
+  </article>
 {{ end }}
diff --git a/layouts/_default/single.html b/layouts/_default/single.html
index a2cf10c..ff6ac82 100644
--- a/layouts/_default/single.html
+++ b/layouts/_default/single.html
@@ -1,25 +1,24 @@
-{{ define "main" }}
-  <main>
-    <article data-layout="prose">
-
-      <header>
-        <hgroup>
-          {{ with .Params.eyebrow }}<p data-text="eyebrow">{{ . }}</p>{{ end }}
-          <h1>{{ .Title }}</h1>
-          {{ with .Description }}<p>{{ . }}</p>{{ end }}
-        </hgroup>
-        <p data-text="dim">
-          <time datetime="{{ .Date.Format `2006-01-02` }}">{{ .Date.Format "January 2006" }}</time>
-          {{ with .Params.author }} · {{ . }}{{ end }}
-        </p>
-      </header>
-
-      {{ .Content }}
-
-      <footer>
-        <small>{{ with .Params.footer }}{{ . }}{{ else }}Published in the dorveille.{{ end }}</small>
-      </footer>
-
-    </article>
-  </main>
+{{ define "header" }}
+  <header>
+    <hgroup>
+      {{ with .Params.eyebrow }}<p data-text="eyebrow">{{ . }}</p>{{ end }}
+      <h1>{{ .Title }}</h1>
+      {{ with .Description }}<p>{{ . }}</p>{{ end }}
+    </hgroup>
+    <p data-text="dim">
+      <time datetime="{{ .Date.Format "2006-01-02" }}">{{ .Date.Format "January 2006" }}</time>
+      {{ with .Params.author }} · {{ . }}{{ end }}
+    </p>
+  </header>
+{{ end }}
+
+{{ define "content" }}
+  <article role="main">
+    {{ .Content }}
+    {{ with .Params.footer }}
+    <footer>
+      <small>{{ . }}</small>
+    </footer>
+    {{ end }}
+  </article>
 {{ end }}
diff --git a/layouts/docs/single.html b/layouts/docs/single.html
index cf07bbb..70a28cf 100644
--- a/layouts/docs/single.html
+++ b/layouts/docs/single.html
@@ -1,107 +1,87 @@
-{{ define "main" }}
-  <main>
-    <div data-layout="docs">
-
-      {{/* ── Left sidebar ─────────────────────────────────────────────── */}}
-
-      <aside>
-        <nav aria-label="Documentation" data-nav="sidebar">
-
-          {{- $menu := index .Site.Menus "docs" -}}
-          {{- if $menu -}}
-
-            {{- range $menu -}}
-              {{- if .HasChildren -}}
-              <small>{{ .Name }}</small>
-              <ul>
-                {{- range .Children -}}
-                <li>
-                  <a href="{{ .URL }}"
-                    {{- if eq (relURL .URL) $.RelPermalink }} aria-current="page"{{ end -}}>
-                    {{- .Name -}}
-                  </a>
-                </li>
-                {{- end -}}
-              </ul>
-              {{- else -}}
-              <ul>
-                <li>
-                  <a href="{{ .URL }}"
-                    {{- if eq (relURL .URL) $.RelPermalink }} aria-current="page"{{ end -}}>
-                    {{- .Name -}}
-                  </a>
-                </li>
-              </ul>
-              {{- end -}}
-            {{- end -}}
-
-          {{- else -}}
-
-            {{/* Fallback: list sibling pages in the docs section */}}
-            {{- with .CurrentSection -}}
-            <small>{{ .Title }}</small>
-            <ul>
-              {{- range .RegularPages -}}
-              <li>
-                <a href="{{ .RelPermalink }}"
-                   {{- if eq .RelPermalink $.RelPermalink }} aria-current="page"{{ end -}}>
-                  {{- .LinkTitle -}}
-                </a>
-              </li>
-              {{- end -}}
-            </ul>
-            {{- end -}}
-
-          {{- end -}}
-
-        </nav>
-      </aside>
-
-
-      {{/* ── Main content ──────────────────────────────────────────────── */}}
-
-      <article>
-
-        {{- if .Description -}}
-        <hgroup>
-          <h1>{{ .Title }}</h1>
-          <p>{{ .Description }}</p>
-        </hgroup>
-        {{- else -}}
-        <h1>{{ .Title }}</h1>
-        {{- end }}
-
-        {{ .Content }}
-
-        {{- if or .PrevInSection .NextInSection -}}
-        <div data-role="prev-next">
-          {{- with .NextInSection -}}
-          <a href="{{ .RelPermalink }}" rel="prev">
-            <small>← Previous</small>
-            <span>{{ .LinkTitle }}</span>
-          </a>
-          {{- end -}}
-          {{- with .PrevInSection -}}
-          <a href="{{ .RelPermalink }}" rel="next">
-            <small>Next →</small>
-            <span>{{ .LinkTitle }}</span>
-          </a>
-          {{- end -}}
-        </div>
-        {{- end -}}
-
-      </article>
-
-
-      {{/* ── Right TOC ────────────────────────────────────────────────── */}}
-
-      {{- with .TableOfContents -}}
-      <aside data-toc>
-        <small>On this page</small>
-        {{ . }}
-      </aside>
-      {{- end -}}
-
-    </div>
-  </main>
+{{ define "header" }}
+  <header>
+    {{- if .Description -}}
+    <hgroup>
+      <h1>{{ .Title }}</h1>
+      <p>{{ .Description }}</p>
+    </hgroup>
+    {{- else -}}
+    <h1>{{ .Title }}</h1>
+    {{- end }}
+  </header>
+{{ end }}
+
+{{ define "content" }}
+  {{/* Docs sidebar — this is navigation, not an aside */}}
+  <nav aria-label="Documentation" data-nav="sidebar">
+    {{- $menu := index .Site.Menus "docs" -}}
+    {{- if $menu -}}
+      {{- range $menu -}}
+        {{- if .HasChildren -}}
+        <small>{{ .Name }}</small>
+        <ul>
+          {{- range .Children -}}
+          <li>
+            <a href="{{ .URL }}"
+              {{- if eq (relURL .URL) $.RelPermalink }} aria-current="page"{{ end -}}>
+              {{- .Name -}}
+            </a>
+          </li>
+          {{- end -}}
+        </ul>
+        {{- else -}}
+        <ul>
+          <li>
+            <a href="{{ .URL }}"
+              {{- if eq (relURL .URL) $.RelPermalink }} aria-current="page"{{ end -}}>
+              {{- .Name -}}
+            </a>
+          </li>
+        </ul>
+        {{- end -}}
+      {{- end -}}
+    {{- else -}}
+      {{- with .CurrentSection -}}
+      <small>{{ .Title }}</small>
+      <ul>
+        {{- range .RegularPages -}}
+        <li>
+          <a href="{{ .RelPermalink }}"
+             {{- if eq .RelPermalink $.RelPermalink }} aria-current="page"{{ end -}}>
+            {{- .LinkTitle -}}
+          </a>
+        </li>
+        {{- end -}}
+      </ul>
+      {{- end -}}
+    {{- end -}}
+  </nav>
+
+  <article role="main">
+    {{ .Content }}
+
+    {{- if or .PrevInSection .NextInSection -}}
+    <footer data-role="prev-next">
+      {{- with .NextInSection -}}
+      <a href="{{ .RelPermalink }}" rel="prev">
+        <small>← Previous</small>
+        <span>{{ .LinkTitle }}</span>
+      </a>
+      {{- end -}}
+      {{- with .PrevInSection -}}
+      <a href="{{ .RelPermalink }}" rel="next">
+        <small>Next →</small>
+        <span>{{ .LinkTitle }}</span>
+      </a>
+      {{- end -}}
+    </footer>
+    {{- end -}}
+  </article>
+
+  {{- with .TableOfContents -}}
+  <aside data-toc>
+    <small>On this page</small>
+    {{ . }}
+  </aside>
+  {{- end -}}
 {{ end }}
diff --git a/layouts/index.html b/layouts/index.html
index 4331f72..662bed5 100644
--- a/layouts/index.html
+++ b/layouts/index.html
@@ -1,32 +1,30 @@
 {{ define "title" }}{{ .Site.Title }}{{ end }}
 
-{{ define "main" }}
-  <main>
-    <article data-layout="prose">
-
-      <header>
-        <hgroup>
-          <h1>{{ .Site.Title }}</h1>
-          <p>{{ .Site.Params.description | default "An agent-first approach to web generation." }}</p>
-        </hgroup>
-      </header>
-
-      <section>
-        <h2>Recent</h2>
-        {{ range first 10 .Site.RegularPages }}
-        <article>
-          <header>
-            <h3><a href="{{ .Permalink }}">{{ .Title }}</a></h3>
-            <p data-text="dim">
-              <time datetime="{{ .Date.Format "2006-01-02" }}">{{ .Date.Format "January 2006" }}</time>
-              {{ with .Params.eyebrow }} · {{ . }}{{ end }}
-            </p>
-          </header>
-          {{ with .Summary }}<p>{{ . }}</p>{{ end }}
-        </article>
-        {{ end }}
-      </section>
-
-    </article>
-  </main>
+{{ define "header" }}
+  <header>
+    <hgroup>
+      <h1>{{ .Site.Title }}</h1>
+      <p>{{ .Site.Params.description | default "An agent-first approach to web generation." }}</p>
+    </hgroup>
+  </header>
+{{ end }}
+
+{{ define "content" }}
+  <article role="main">
+    <section>
+      <h2>Recent</h2>
+      {{ range first 10 .Site.RegularPages }}
+      <article>
+        <header>
+          <h3><a href="{{ .Permalink }}">{{ .Title }}</a></h3>
+          <p data-text="dim">
+            <time datetime="{{ .Date.Format "2006-01-02" }}">{{ .Date.Format "January 2006" }}</time>
+            {{ with .Params.eyebrow }} · {{ . }}{{ end }}
+          </p>
+        </header>
+        {{ with .Summary }}<p>{{ . }}</p>{{ end }}
+      </article>
+      {{ end }}
+    </section>
+  </article>
 {{ end }}
diff --git a/layouts/paper/single.html b/layouts/paper/single.html
index 7332068..f8d5295 100644
--- a/layouts/paper/single.html
+++ b/layouts/paper/single.html
@@ -1,59 +1,40 @@
-{{ define "main" }}
-  <main>
-    <article data-paper>
-
-      <header>
-
-        <h1>{{ .Title }}</h1>
-
-        {{- with .Description -}}
-        <p data-abstract>{{ . }}</p>
-        {{- end -}}
-
-        {{/* Byline: date and/or author */}}
-        {{- $hasDate   := not .Date.IsZero -}}
-        {{- $hasAuthor := .Params.author -}}
-        {{- if or $hasDate $hasAuthor -}}
-        <p data-byline>
-          {{- if $hasDate -}}
-          <time datetime="{{ .Date.Format "2006-01-02" }}">{{ .Date.Format "January 2, 2006" }}</time>
-          {{- end -}}
-          {{- if and $hasDate $hasAuthor -}}
-          <span aria-hidden="true"> · </span>
-          {{- end -}}
-          {{- with .Params.author -}}
-          <span>{{ . }}</span>
-          {{- end -}}
-        </p>
-        {{- end -}}
-
-        {{/* Tags */}}
-        {{- with .GetTerms "tags" -}}
-        <nav data-role="tag-cloud" aria-label="Tags">
-          {{- range . -}}
-          <a href="{{ .Permalink }}" data-tag="{{ .Name }}">{{ .Name }}</a>
-          {{- end -}}
-        </nav>
-        {{- end -}}
-
-      </header>
-
-
-      {{ .Content }}
-
-
-      {{/* ── Prev / Next footer ──────────────────────────────────────── */}}
-      {{- if or .PrevInSection .NextInSection -}}
-      <footer>
-        {{- with .PrevInSection -}}
-        <a href="{{ .RelPermalink }}" rel="prev">← {{ .LinkTitle }}</a>
-        {{- end -}}
-        {{- with .NextInSection -}}
-        <a href="{{ .RelPermalink }}" rel="next">{{ .LinkTitle }} →</a>
-        {{- end -}}
-      </footer>
+{{ define "header" }}
+  <header>
+    <h1>{{ .Title }}</h1>
+    {{ with .Description }}<p data-abstract>{{ . }}</p>{{ end }}
+    {{- $hasDate := not .Date.IsZero -}}
+    {{- $hasAuthor := .Params.author -}}
+    {{- if or $hasDate $hasAuthor -}}
+    <p data-byline>
+      {{- if $hasDate -}}
+      <time datetime="{{ .Date.Format "2006-01-02" }}">{{ .Date.Format "January 2, 2006" }}</time>
       {{- end -}}
-
-    </article>
-  </main>
+      {{- if and $hasDate $hasAuthor }} · {{ end -}}
+      {{- with .Params.author }}{{ . }}{{ end -}}
+    </p>
+    {{- end }}
+    {{- with .GetTerms "tags" }}
+    <nav data-role="tag-cloud" aria-label="Tags">
+      {{- range . }}
+      <a href="{{ .Permalink }}" data-tag="{{ .Name }}">{{ .Name }}</a>
+      {{- end }}
+    </nav>
+    {{- end }}
+  </header>
+{{ end }}
+
+{{ define "content" }}
+  <article role="main">
+    {{ .Content }}
+    {{- if or .PrevInSection .NextInSection }}
+    <footer>
+      {{- with .PrevInSection }}
+      <a href="{{ .RelPermalink }}" rel="prev">← {{ .LinkTitle }}</a>
+      {{- end }}
+      {{- with .NextInSection }}
+      <a href="{{ .RelPermalink }}" rel="next">{{ .LinkTitle }} →</a>
+      {{- end }}
+    </footer>
+    {{- end }}
+  </article>
 {{ end }}
diff --git a/layouts/vault/single.html b/layouts/vault/single.html
index fa0726e..c6be8cf 100644
--- a/layouts/vault/single.html
+++ b/layouts/vault/single.html
@@ -1,113 +1,92 @@
-{{ define "main" }}
-  <main>
-    <div data-layout="docs">
-
-      {{/* ── Left sidebar ─────────────────────────────────────────────── */}}
-
-      <aside>
-        {{- $menuName := .Site.Params.vault_menu | default "vault" -}}
-        <nav aria-label="Vault documentation" data-nav="sidebar">
-
-          {{- $menu := index .Site.Menus $menuName -}}
-          {{- if $menu -}}
-
-            {{- range $menu -}}
-              {{- if .HasChildren -}}
-              <small>{{ .Name }}</small>
-              <ul>
-                {{- range .Children -}}
-                <li>
-                  <a href="{{ .URL }}"
-                    {{- if $.IsMenuCurrent $menuName . }} aria-current="page"{{ end -}}>
-                    {{- .Name -}}
-                  </a>
-                </li>
-                {{- end -}}
-              </ul>
-              {{- else -}}
-              <ul>
-                <li>
-                  <a href="{{ .URL }}"
-                    {{- if $.IsMenuCurrent $menuName . }} aria-current="page"{{ end -}}>
-                    {{- .Name -}}
-                  </a>
-                </li>
-              </ul>
-              {{- end -}}
-            {{- end -}}
-
-          {{- else -}}
-
-            {{/* Fallback: list direct pages of the current section */}}
-            {{- with .CurrentSection -}}
-            <small>{{ .Title }}</small>
-            <ul>
-              {{- range .RegularPages -}}
-              <li>
-                <a href="{{ .RelPermalink }}"
-                   {{- if eq .RelPermalink $.RelPermalink }} aria-current="page"{{ end -}}>
-                  {{- .LinkTitle -}}
-                </a>
-              </li>
-              {{- end -}}
-            </ul>
-            {{- end -}}
-
-          {{- end -}}
-
-        </nav>
-      </aside>
-
-
-      {{/* ── Main content ──────────────────────────────────────────────── */}}
-
-      <article>
-
-        {{- if .Description -}}
-        <hgroup>
-          <h1>{{ .Title }}</h1>
-          <p>{{ .Description }}</p>
-        </hgroup>
-        {{- else -}}
-        <h1>{{ .Title }}</h1>
-        {{- end }}
-
-        {{ .Content }}
-
-        {{/* ── Prev / Next — from front matter, not Hugo section order ── */}}
-        {{- $prevURL   := index .Params "prev-url" -}}
-        {{- $prevTitle := index .Params "prev-title" -}}
-        {{- $nextURL   := index .Params "next-url" -}}
-        {{- $nextTitle := index .Params "next-title" -}}
-        {{- if or $prevURL $nextURL -}}
-        <div data-role="prev-next">
-          {{- if $prevURL -}}
-          <a href="{{ $prevURL }}" rel="prev">
-            <small>← Previous</small>
-            <span>{{ $prevTitle }}</span>
-          </a>
-          {{- end -}}
-          {{- if and $nextURL $nextTitle -}}
-          <a href="{{ $nextURL }}" rel="next">
-            <small>Next →</small>
-            <span>{{ $nextTitle }}</span>
-          </a>
-          {{- end -}}
-        </div>
-        {{- end -}}
-
-      </article>
-
-
-      {{/* ── Right TOC ────────────────────────────────────────────────── */}}
-
-      {{- with .TableOfContents -}}
-      <aside data-toc>
-        <small>On this page</small>
-        {{ . }}
-      </aside>
-      {{- end -}}
-
-    </div>
-  </main>
+{{ define "header" }}
+  <header>
+    {{- if .Description -}}
+    <hgroup>
+      <h1>{{ .Title }}</h1>
+      <p>{{ .Description }}</p>
+    </hgroup>
+    {{- else -}}
+    <h1>{{ .Title }}</h1>
+    {{- end }}
+  </header>
+{{ end }}
+
+{{ define "content" }}
+  {{/* Vault sidebar navigation */}}
+  <nav aria-label="Vault" data-nav="sidebar">
+    {{- $menuName := .Site.Params.vault_menu | default "vault" -}}
+    {{- $menu := index .Site.Menus $menuName -}}
+    {{- if $menu -}}
+      {{- range $menu -}}
+        {{- if .HasChildren -}}
+        <small>{{ .Name }}</small>
+        <ul>
+          {{- range .Children -}}
+          <li>
+            <a href="{{ .URL }}"
+              {{- if $.IsMenuCurrent $menuName . }} aria-current="page"{{ end -}}>
+              {{- .Name -}}
+            </a>
+          </li>
+          {{- end -}}
+        </ul>
+        {{- else -}}
+        <ul>
+          <li>
+            <a href="{{ .URL }}"
+              {{- if $.IsMenuCurrent $menuName . }} aria-current="page"{{ end -}}>
+              {{- .Name -}}
+            </a>
+          </li>
+        </ul>
+        {{- end -}}
+      {{- end -}}
+    {{- else -}}
+      {{- with .CurrentSection -}}
+      <small>{{ .Title }}</small>
+      <ul>
+        {{- range .RegularPages -}}
+        <li>
+          <a href="{{ .RelPermalink }}"
+             {{- if eq .RelPermalink $.RelPermalink }} aria-current="page"{{ end -}}>
+            {{- .LinkTitle -}}
+          </a>
+        </li>
+        {{- end -}}
+      </ul>
+      {{- end -}}
+    {{- end -}}
+  </nav>
+
+  <article role="main">
+    {{ .Content }}
+
+    {{- $prevURL := index .Params "prev-url" -}}
+    {{- $prevTitle := index .Params "prev-title" -}}
+    {{- $nextURL := index .Params "next-url" -}}
+    {{- $nextTitle := index .Params "next-title" -}}
+    {{- if or $prevURL $nextURL -}}
+    <footer data-role="prev-next">
+      {{- if $prevURL -}}
+      <a href="{{ $prevURL }}" rel="prev">
+        <small>← Previous</small>
+        <span>{{ $prevTitle }}</span>
+      </a>
+      {{- end -}}
+      {{- if and $nextURL $nextTitle -}}
+      <a href="{{ $nextURL }}" rel="next">
+        <small>Next →</small>
+        <span>{{ $nextTitle }}</span>
+      </a>
+      {{- end -}}
+    </footer>
+    {{- end -}}
+  </article>
+
+  {{- with .TableOfContents -}}
+  <aside data-toc>
+    <small>On this page</small>
+    {{ . }}
+  </aside>
+  {{- end -}}
 {{ end }}
