jekyll-theme-zer0 1.31.2 → 1.32.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (82) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +183 -0
  3. data/_data/ai.yml +1 -1
  4. data/_data/backlog.yml +149 -28
  5. data/_data/features.yml +173 -17
  6. data/_data/navigation/admin.yml +26 -8
  7. data/_data/navigation/docs.yml +2 -8
  8. data/_data/site_builder.yml +1 -1
  9. data/_data/theme-manifest.yml +74 -58
  10. data/_data/ui-text.yml +9 -0
  11. data/_includes/README.md +2 -1
  12. data/_includes/analytics/google-analytics.html +46 -9
  13. data/_includes/analytics/posthog.html +101 -77
  14. data/_includes/components/ai-chat.html +3 -3
  15. data/_includes/components/author-bio.html +3 -1
  16. data/_includes/components/author-card.html +9 -9
  17. data/_includes/components/author-eeat.html +13 -3
  18. data/_includes/components/collection-manager.html +2 -2
  19. data/_includes/components/component-showcase.html +7 -7
  20. data/_includes/components/cookie-consent-needed.html +37 -0
  21. data/_includes/components/cookie-consent.html +44 -5
  22. data/_includes/components/page-feedback.html +10 -6
  23. data/_includes/components/post-card.html +2 -2
  24. data/_includes/components/theme-customizer.html +1 -1
  25. data/_includes/content/comments.html +46 -0
  26. data/_includes/content/giscus.html +22 -13
  27. data/_includes/content/intro.html +39 -3
  28. data/_includes/content/jsonld-software.html +4 -9
  29. data/_includes/content/sitemap.html +173 -17
  30. data/_includes/core/favicon.html +42 -6
  31. data/_includes/core/footer.html +38 -17
  32. data/_includes/core/header.html +11 -2
  33. data/_includes/navigation/admin-nav.html +110 -63
  34. data/_includes/navigation/section-sidebar.html +20 -20
  35. data/_includes/navigation/sidebar-config.html +17 -8
  36. data/_includes/navigation/sidebar-right.html +16 -2
  37. data/_includes/setup/wizard.html +2 -2
  38. data/_layouts/README.md +1 -1
  39. data/_layouts/admin.html +49 -20
  40. data/_layouts/article.html +10 -10
  41. data/_layouts/book-story.html +3 -7
  42. data/_layouts/default.html +63 -2
  43. data/_layouts/news.html +8 -7
  44. data/_layouts/note.html +2 -6
  45. data/_layouts/notebook.html +2 -6
  46. data/_layouts/recipe.html +3 -7
  47. data/_layouts/root.html +7 -4
  48. data/_layouts/section.html +43 -42
  49. data/_sass/components/_back-to-top.scss +9 -0
  50. data/_sass/components/_cookie-banner.scss +31 -0
  51. data/_sass/components/_page-feedback.scss +1 -1
  52. data/_sass/components/_ui-enhancements.scss +22 -0
  53. data/_sass/core/_nav-tree.scss +10 -2
  54. data/_sass/core/_navbar.scss +19 -5
  55. data/_sass/core/_obsidian.scss +19 -3
  56. data/_sass/core/_sidebar-categories.scss +4 -2
  57. data/_sass/core/_sidebar-extras.scss +3 -2
  58. data/_sass/layouts/_admin.scss +60 -0
  59. data/_sass/layouts/_navbar-extras.scss +7 -2
  60. data/_sass/theme/_skins.scss +124 -32
  61. data/_sass/tokens/_color.scss +3 -0
  62. data/_sass/tokens/_layers.scss +12 -5
  63. data/_sass/utilities/_focus.scss +12 -1
  64. data/assets/css/main.scss +1 -0
  65. data/assets/js/code-copy.js +30 -2
  66. data/assets/js/modules/navigation/index.js +94 -40
  67. data/assets/js/modules/navigation/scroll-spy.js +70 -7
  68. data/assets/js/setup-wizard.js +2 -2
  69. data/assets/js/ui-enhancements.js +46 -0
  70. data/scripts/ai/README.md +1 -1
  71. data/scripts/ai/api_call.rb +1 -1
  72. data/scripts/bin/audit-consumer +155 -8
  73. data/scripts/bin/manifest +27 -8
  74. data/scripts/bin/validate +3 -2
  75. data/scripts/ci/test_visual_evidence_autogen.py +53 -1
  76. data/scripts/ci/visual_evidence_autogen.py +26 -7
  77. data/scripts/install/ai/client.sh +1 -1
  78. data/scripts/lib/audit.sh +156 -0
  79. data/scripts/lib/preview_generator.py +1 -1
  80. data/scripts/translate.rb +1 -1
  81. data/scripts/validate-features.rb +20 -2
  82. metadata +5 -2
@@ -1,6 +1,15 @@
1
1
  ---
2
2
  # Features: ZER0-001, ZER0-008, ZER0-019
3
3
  layout: root
4
+ # The skip link (core/header.html) jumps past the docs sidebar, intro and
5
+ # TOC straight to the page body below.
6
+ skip_link_target: page-content
7
+ # This layout is the one that emits the #bdSidebar / #tocContents offcanvases.
8
+ # navigation/sidebar-config.html reads this through Jekyll's layout front-matter
9
+ # merge, so every layout whose `layout:` chain reaches here — including a
10
+ # consumer's own — gets the sidebar toggle, TOC FAB and local-graph FAB that go
11
+ # with them (issues #373, #570).
12
+ renders_sidebar_offcanvas: true
4
13
  ---
5
14
  {% comment %}
6
15
  ===================================================================
@@ -122,8 +131,60 @@ layout: root
122
131
  {% comment %} MAIN CONTENT BODY {% endcomment %}
123
132
  {% comment %} =============================== {% endcomment %}
124
133
  {% comment %} Where the actual page content is rendered {% endcomment %}
125
- <div class="bd-content ps-lg-2">
126
- {{ content }}
134
+ {% comment %} Skip-link target for this layout (see front matter). tabindex="-1"
135
+ lets the link move keyboard focus here, not just scroll (same reason
136
+ as #main-content in root.html); its focus ring is suppressed in
137
+ _sass/utilities/_focus.scss. {% endcomment %}
138
+ {% comment %} The TOC-scope sentinels (#552) have done their job in
139
+ sidebar-right.html above; they never reach the visitor. {% endcomment %}
140
+ {%- comment -%}
141
+ One <h1> per page (issue #593). When the intro above has rendered
142
+ page.title as the page's <h1>, the body must not add a second one —
143
+ yet most Markdown pages open with `# Title` (kramdown emits
144
+ <h1 id="title">), and some child layouts print their own heading.
145
+ So the FIRST <h1> of the body is rewritten, once:
146
+ - it is the body's leading element and its text is page.title
147
+ (compared through slugify, so case, punctuation and a decorative
148
+ emoji do not count): dropped, with its id kept on an empty
149
+ <span> so #anchors and the TOC link still land;
150
+ - anything else (different text, or a heading further in): demoted
151
+ to <h2>, attributes and text intact, so nothing written vanishes.
152
+ The TOC above is built from the original `content`, so its entries
153
+ and levels do not change. Layouts that skip the intro (article, note,
154
+ recipe, cookbook, hide_intro) render the body untouched. The landing
155
+ layout, which does not inherit this one, solves the same problem in
156
+ CSS (`.landing-content-body > h1:first-of-type`).
157
+ {%- endcomment -%}
158
+ {%- assign _page_body = content | remove: '<zer0-toc-start></zer0-toc-start>' | remove: '<zer0-toc-end></zer0-toc-end>' -%}
159
+ {%- assign _h1_title_key = page.title | strip_html | slugify -%}
160
+ {%- assign _h1_rewrite = false -%}
161
+ {%- if _skip_intro == false and _h1_title_key != "" and _page_body contains '<h1' -%}
162
+ {%- assign _h1_before = _page_body | split: '<h1' | first -%}
163
+ {%- assign _h1_rest = _page_body | remove_first: _h1_before -%}
164
+ {%- if _h1_rest contains '</h1>' -%}
165
+ {%- assign _h1_rewrite = true -%}
166
+ {%- assign _h1_inner = _h1_rest | remove_first: '<h1' | split: '</h1>' | first -%}
167
+ {%- assign _h1_html = '<h1' | append: _h1_inner | append: '</h1>' -%}
168
+ {%- assign _h1_after = _h1_rest | remove_first: _h1_html -%}
169
+ {%- assign _h1_attrs = _h1_inner | split: '>' | first | default: '' -%}
170
+ {%- assign _h1_key = _h1_inner | remove_first: _h1_attrs | remove_first: '>' | strip_html | slugify -%}
171
+ {%- assign _h1_id = '' -%}
172
+ {%- if _h1_attrs contains ' id="' -%}
173
+ {%- assign _h1_id = _h1_attrs | split: ' id="' | last | split: '"' | first -%}
174
+ {%- endif -%}
175
+ {%- assign _h1_leading = _h1_before | strip -%}
176
+ {%- if _h1_leading == "" and _h1_key == _h1_title_key -%}
177
+ {%- assign _h1_replacement = '' -%}
178
+ {%- if _h1_id != '' -%}
179
+ {%- assign _h1_replacement = '<span id="' | append: _h1_id | append: '"></span>' -%}
180
+ {%- endif -%}
181
+ {%- else -%}
182
+ {%- assign _h1_replacement = '<h2' | append: _h1_inner | append: '</h2>' -%}
183
+ {%- endif -%}
184
+ {%- endif -%}
185
+ {%- endif %}
186
+ <div id="page-content" class="bd-content ps-lg-2" tabindex="-1">
187
+ {% if _h1_rewrite %}{{ _h1_before }}{{ _h1_replacement }}{{ _h1_after }}{% else %}{{ _page_body }}{% endif %}
127
188
 
128
189
  {%- comment -%}
129
190
  Optional Obsidian-style backlinks panel. Opt-in for the generic
data/_layouts/news.html CHANGED
@@ -104,9 +104,10 @@ source: "https://getbootstrap.com/docs/5.3/examples/blog/#"
104
104
  </h1>
105
105
  </div>
106
106
  <div class="col-md-8">
107
- <nav class="nav nav-pills justify-content-md-end flex-wrap">
108
- <a class="nav-link text-white active" href="{{ page.url | relative_url }}">
109
- <i class="bi bi-house me-1"></i>Home
107
+ {%- include core/i18n.html -%}
108
+ <nav class="nav nav-pills justify-content-md-end flex-wrap" aria-label="{{ ui.news_sections_label | default: 'News sections' }}">
109
+ <a class="nav-link text-white active" href="{{ page.url | relative_url }}" aria-current="page">
110
+ <i class="bi bi-house me-1" aria-hidden="true"></i>Home
110
111
  </a>
111
112
  {% for sec_name in news_sections %}
112
113
  {% assign _sec_nav = site.data.navigation.posts | where: "title", sec_name | first %}
@@ -116,13 +117,13 @@ source: "https://getbootstrap.com/docs/5.3/examples/blog/#"
116
117
  {% capture _sec_url %}{{ news_base }}{{ sec_name | slugify }}/{% endcapture %}
117
118
  {% endif %}
118
119
  <a class="nav-link text-white-50" href="{{ _sec_url | relative_url }}">
119
- {% if _sec_nav.icon %}<i class="bi {{ _sec_nav.icon }} me-1"></i>{% endif %}
120
+ {% if _sec_nav.icon %}<i class="bi {{ _sec_nav.icon }} me-1" aria-hidden="true"></i>{% endif %}
120
121
  {{ sec_name }}
121
122
  </a>
122
123
  {% endfor %}
123
124
  {% if _tags_linkable %}
124
125
  <a class="nav-link text-white-50" href="{{ tags_base | relative_url }}">
125
- <i class="bi bi-tags me-1"></i>Tags
126
+ <i class="bi bi-tags me-1" aria-hidden="true"></i>Tags
126
127
  </a>
127
128
  {% endif %}
128
129
  </nav>
@@ -641,12 +642,12 @@ source: "https://getbootstrap.com/docs/5.3/examples/blog/#"
641
642
  <a href="{{ archives_url | relative_url }}#{{ month.name | slugify }}-{{ year.name }}"
642
643
  class="text-decoration-none">
643
644
  {{ month.name }}
644
- <span class="badge bg-secondary text-body">{{ month.items.size }}</span>
645
+ <span class="badge text-bg-secondary">{{ month.items.size }}</span>
645
646
  </a>
646
647
  {% else %}
647
648
  <span>
648
649
  {{ month.name }}
649
- <span class="badge bg-secondary text-body">{{ month.items.size }}</span>
650
+ <span class="badge text-bg-secondary">{{ month.items.size }}</span>
650
651
  </span>
651
652
  {% endif %}
652
653
  </li>
data/_layouts/note.html CHANGED
@@ -242,12 +242,8 @@ layout: default
242
242
  {% comment %} ================================ {% endcomment %}
243
243
  {% comment %} COMMENTS SECTION {% endcomment %}
244
244
  {% comment %} ================================ {% endcomment %}
245
- {% if page.comments != false and site.giscus.enabled %}
246
- <div class="note-comments mt-5 pt-4 border-top">
247
- <h5 class="mb-4">Comments</h5>
248
- {% include content/giscus.html %}
249
- </div>
250
- {% endif %}
245
+ {% comment %} On unless the page sets comments: false; h5 like the other footer sections. {% endcomment %}
246
+ {% include content/comments.html class="note-comments" compact=true %}
251
247
  {% comment %} ================================ {% endcomment %}
252
248
  {% comment %} BACKLINKS — "Linked mentions" {% endcomment %}
253
249
  {% comment %} ================================ {% endcomment %}
@@ -225,12 +225,8 @@ layout: default
225
225
  {% comment %} ================================ {% endcomment %}
226
226
  {% comment %} COMMENTS SECTION {% endcomment %}
227
227
  {% comment %} ================================ {% endcomment %}
228
- {% if page.comments != false and site.giscus.enabled %}
229
- <div class="notebook-comments mt-5 pt-4 border-top">
230
- <h5 class="mb-4">Comments</h5>
231
- {% include content/giscus.html %}
232
- </div>
233
- {% endif %}
228
+ {% comment %} On unless the page sets comments: false; h5 like the other footer sections. {% endcomment %}
229
+ {% include content/comments.html class="notebook-comments" compact=true %}
234
230
 
235
231
  </article>
236
232
 
data/_layouts/recipe.html CHANGED
@@ -1,5 +1,5 @@
1
1
  ---
2
- # Feature: ZER0-084
2
+ # Features: ZER0-035, ZER0-084
3
3
  layout: default
4
4
  ---
5
5
  {%- comment -%}
@@ -153,12 +153,8 @@ layout: default
153
153
  {% comment %} ================================ {% endcomment %}
154
154
  {% comment %} COMMENTS {% endcomment %}
155
155
  {% comment %} ================================ {% endcomment %}
156
- {%- if page.comments and site.giscus.enabled -%}
157
- <section class="post-comments mt-5 pt-4 border-top" id="comments">
158
- <h2 class="h4 mb-4"><i class="bi bi-chat-dots me-2" aria-hidden="true"></i>Comments</h2>
159
- {%- include content/giscus.html -%}
160
- </section>
161
- {%- endif -%}
156
+ {% comment %} Opt-in: only when the page sets comments: true (and site.giscus.enabled). {% endcomment %}
157
+ {%- include content/comments.html default_on=false -%}
162
158
  </article>
163
159
 
164
160
  {%- comment -%}
data/_layouts/root.html CHANGED
@@ -25,9 +25,7 @@
25
25
  - footer.html: Site footer with links and copyright
26
26
  - js-cdn.html: JavaScript dependencies and custom scripts
27
27
 
28
- Theme: Zer0 Mistakes Jekyll Theme v0.1
29
- Author: Amr Abdel-Motaleb
30
- Copyright: 2024 - it-journey.com | @bamr87
28
+ Theme: jekyll-theme-zer0 (MIT) — https://github.com/bamr87/zer0-mistakes
31
29
  ===================================================================
32
30
  {% endcomment %}
33
31
 
@@ -172,8 +170,13 @@
172
170
  consumer markup renders per page. {% endcomment %}
173
171
  {%- include custom/footer.html -%}
174
172
 
175
- {% comment %} Privacy-compliant cookie consent banner — page-invariant. {% endcomment %}
173
+ {% comment %} Privacy-compliant cookie consent banner — page-invariant. Rendered
174
+ only when the site configures a tracker or forces it with
175
+ cookie_consent.enabled (components/cookie-consent-needed.html, #566). {% endcomment %}
176
+ {%- capture _needs_consent -%}{%- include components/cookie-consent-needed.html -%}{%- endcapture -%}
177
+ {%- if _needs_consent == "true" -%}
176
178
  {%- include_cached components/cookie-consent.html -%}
179
+ {%- endif -%}
177
180
 
178
181
  {% comment %} AI Chat Assistant {% endcomment %}
179
182
  {%- include components/ai-chat.html -%}
@@ -120,7 +120,7 @@ layout: root
120
120
  <div class="row align-items-center">
121
121
  <div class="col-auto d-lg-none">
122
122
  <button class="btn btn-outline-light btn-sm" type="button" data-bs-toggle="offcanvas" data-bs-target="#sectionSidebar" aria-controls="sectionSidebar">
123
- <i class="bi bi-list me-1"></i>Topics
123
+ <i class="bi bi-list me-1" aria-hidden="true"></i>Topics
124
124
  </button>
125
125
  </div>
126
126
  <div class="col">
@@ -128,11 +128,11 @@ layout: root
128
128
  <ol class="breadcrumb mb-0">
129
129
  <li class="breadcrumb-item">
130
130
  <a href="{{ news_index_url | relative_url }}" class="text-white-50 text-decoration-none">
131
- <i class="bi bi-newspaper me-1"></i>News
131
+ <i class="bi bi-newspaper me-1" aria-hidden="true"></i>News
132
132
  </a>
133
133
  </li>
134
134
  <li class="breadcrumb-item active text-white" aria-current="page">
135
- {% if page.icon %}<i class="bi bi-{{ page.icon }} me-1"></i>{% endif %}
135
+ {% if page.icon %}<i class="bi bi-{{ page.icon }} me-1" aria-hidden="true"></i>{% endif %}
136
136
  {{ page.title }}
137
137
  </li>
138
138
  </ol>
@@ -140,7 +140,7 @@ layout: root
140
140
  </div>
141
141
  <div class="col-auto">
142
142
  <span class="badge bg-secondary">
143
- <i class="bi bi-file-text me-1"></i>{{ section_posts.size }} article{% if section_posts.size != 1 %}s{% endif %}
143
+ <i class="bi bi-file-text me-1" aria-hidden="true"></i>{{ section_posts.size }} article{% if section_posts.size != 1 %}s{% endif %}
144
144
  </span>
145
145
  </div>
146
146
  </div>
@@ -150,7 +150,8 @@ layout: root
150
150
  {% comment %} Sub-navigation for other sections {% endcomment %}
151
151
  <div class="container-fluid bg-body-tertiary border-bottom py-2 mb-4">
152
152
  <div class="container-fluid px-4">
153
- <nav class="nav nav-pills flex-nowrap overflow-auto" style="scrollbar-width: none;">
153
+ {%- include core/i18n.html -%}
154
+ <nav class="nav nav-pills flex-nowrap overflow-auto" style="scrollbar-width: none;" aria-label="{{ ui.news_sections_label | default: 'News sections' }}">
154
155
  {% for sec_name in news_sections %}
155
156
  {% assign is_active = false %}
156
157
  {% if sec_name == page.category or sec_name == page.title %}
@@ -163,8 +164,8 @@ layout: root
163
164
  {% capture _sec_url %}{{ news_base }}{{ sec_name | slugify }}/{% endcapture %}
164
165
  {% endif %}
165
166
  <a class="nav-link text-nowrap {% if is_active %}active{% else %}text-body-secondary{% endif %}"
166
- href="{{ _sec_url | relative_url }}">
167
- {% if _sec_nav.icon %}<i class="bi {{ _sec_nav.icon }} me-1"></i>{% endif %}
167
+ href="{{ _sec_url | relative_url }}"{% if is_active %} aria-current="page"{% endif %}>
168
+ {% if _sec_nav.icon %}<i class="bi {{ _sec_nav.icon }} me-1" aria-hidden="true"></i>{% endif %}
168
169
  {{ sec_name }}
169
170
  </a>
170
171
  {% endfor %}
@@ -199,7 +200,7 @@ layout: root
199
200
  <header class="section-header mb-4">
200
201
  <div class="d-flex align-items-center mb-3">
201
202
  {% if page.icon %}
202
- <i class="bi bi-{{ page.icon }} fs-1 me-3 text-primary"></i>
203
+ <i class="bi bi-{{ page.icon }} fs-1 me-3 text-primary" aria-hidden="true"></i>
203
204
  {% endif %}
204
205
  <div>
205
206
  <h1 class="display-5 mb-0">{{ page.title }}</h1>
@@ -234,11 +235,11 @@ layout: root
234
235
  <div class="col-lg-6 p-4 p-lg-5 d-flex flex-column justify-content-center">
235
236
  {% if featured_in_section.breaking %}
236
237
  <span class="badge bg-danger mb-3 align-self-start">
237
- <i class="bi bi-lightning-fill me-1"></i>Breaking
238
+ <i class="bi bi-lightning-fill me-1" aria-hidden="true"></i>Breaking
238
239
  </span>
239
240
  {% elsif featured_in_section.featured %}
240
241
  <span class="badge bg-warning text-dark mb-3 align-self-start">
241
- <i class="bi bi-star-fill me-1"></i>Featured
242
+ <i class="bi bi-star-fill me-1" aria-hidden="true"></i>Featured
242
243
  </span>
243
244
  {% endif %}
244
245
  {% if featured_in_section.post_type and featured_in_section.post_type != "standard" %}
@@ -250,7 +251,7 @@ layout: root
250
251
  <p class="lead text-muted mb-4">{{ featured_in_section.excerpt | strip_html | truncate: 180 }}</p>
251
252
  <div class="d-flex align-items-center gap-3 mb-4 flex-wrap">
252
253
  <small class="text-muted">
253
- <i class="bi bi-calendar me-1"></i>{{ featured_in_section.date | date: "%B %d, %Y" }}
254
+ <i class="bi bi-calendar me-1" aria-hidden="true"></i>{{ featured_in_section.date | date: "%B %d, %Y" }}
254
255
  </small>
255
256
  {% if featured_in_section.author %}
256
257
  <small class="text-muted">
@@ -259,7 +260,7 @@ layout: root
259
260
  {% endif %}
260
261
  </div>
261
262
  <a href="{{ featured_in_section.url | relative_url }}" class="btn btn-primary btn-lg align-self-start">
262
- Read Article <i class="bi bi-arrow-right ms-2"></i>
263
+ Read Article <i class="bi bi-arrow-right ms-2" aria-hidden="true"></i>
263
264
  </a>
264
265
  </div>
265
266
  <div class="col-lg-6">
@@ -287,12 +288,12 @@ layout: root
287
288
  {% if subcat_posts_filtered.size > 0 %}
288
289
  <section id="{{ subcat | slugify }}" class="subcategory-section mb-5 pb-4 border-bottom scroll-mt-5">
289
290
  <div class="d-flex justify-content-between align-items-center mb-4">
290
- <h3 class="h4 mb-0">
291
- <i class="bi bi-tag text-primary me-2"></i>{{ subcat | capitalize }}
292
- </h3>
291
+ <h2 class="h4 mb-0">
292
+ <i class="bi bi-tag text-primary me-2" aria-hidden="true"></i>{{ subcat | capitalize }}
293
+ </h2>
293
294
  {% if _tags_linkable %}
294
295
  <a href="{{ tags_base | relative_url }}#{{ subcat | slugify }}" class="btn btn-outline-secondary btn-sm">
295
- View All <i class="bi bi-arrow-right ms-1"></i>
296
+ View All <i class="bi bi-arrow-right ms-1" aria-hidden="true"></i>
296
297
  </a>
297
298
  {% endif %}
298
299
  </div>
@@ -318,18 +319,18 @@ layout: root
318
319
  </a>
319
320
  </div>
320
321
  <div class="card-body">
321
- <h5 class="card-title mb-2">
322
+ <h3 class="card-title h5 mb-2">
322
323
  <a href="{{ spost.url | relative_url }}" class="text-decoration-none text-body-emphasis">
323
324
  {{ spost.title | truncate: 55 }}
324
325
  </a>
325
- </h5>
326
+ </h3>
326
327
  <p class="card-text text-muted small">
327
328
  {{ spost.excerpt | strip_html | truncate: 80 }}
328
329
  </p>
329
330
  </div>
330
331
  <div class="card-footer bg-transparent border-0 pt-0">
331
332
  <small class="text-muted">
332
- <i class="bi bi-calendar me-1"></i>{{ spost.date | date: "%b %d, %Y" }}
333
+ <i class="bi bi-calendar me-1" aria-hidden="true"></i>{{ spost.date | date: "%b %d, %Y" }}
333
334
  </small>
334
335
  </div>
335
336
  </div>
@@ -343,9 +344,9 @@ layout: root
343
344
  {% comment %} All Posts Section {% endcomment %}
344
345
  <section id="all-posts" class="all-posts-section mb-5 scroll-mt-5">
345
346
  <div class="d-flex justify-content-between align-items-center mb-4">
346
- <h3 class="h4 mb-0">
347
- <i class="bi bi-grid text-secondary me-2"></i>All {{ page.title }} Articles
348
- </h3>
347
+ <h2 class="h4 mb-0">
348
+ <i class="bi bi-grid text-secondary me-2" aria-hidden="true"></i>All {{ page.title }} Articles
349
+ </h2>
349
350
  </div>
350
351
 
351
352
  <div class="row row-cols-1 row-cols-md-2 row-cols-xl-3 g-4">
@@ -378,18 +379,18 @@ layout: root
378
379
  <span class="badge bg-light text-dark">{{ apost.tags | first }}</span>
379
380
  {% endif %}
380
381
  </div>
381
- <h5 class="card-title mb-2">
382
+ <h3 class="card-title h5 mb-2">
382
383
  <a href="{{ apost.url | relative_url }}" class="text-decoration-none text-body-emphasis">
383
384
  {{ apost.title | truncate: 55 }}
384
385
  </a>
385
- </h5>
386
+ </h3>
386
387
  <p class="card-text text-muted small">
387
388
  {{ apost.excerpt | strip_html | truncate: 80 }}
388
389
  </p>
389
390
  </div>
390
391
  <div class="card-footer bg-transparent border-0 pt-0">
391
392
  <small class="text-muted">
392
- <i class="bi bi-calendar me-1"></i>{{ apost.date | date: "%b %d, %Y" }}
393
+ <i class="bi bi-calendar me-1" aria-hidden="true"></i>{{ apost.date | date: "%b %d, %Y" }}
393
394
  </small>
394
395
  </div>
395
396
  </div>
@@ -435,12 +436,12 @@ layout: root
435
436
  <div class="position-relative">
436
437
  {% if gpost.breaking %}
437
438
  <span class="badge bg-danger position-absolute top-0 start-0 m-2 z-1">
438
- <i class="bi bi-lightning-fill me-1"></i>Breaking
439
+ <i class="bi bi-lightning-fill me-1" aria-hidden="true"></i>Breaking
439
440
  </span>
440
441
  {% endif %}
441
442
  {% if gpost.featured %}
442
443
  <span class="badge bg-warning text-dark position-absolute top-0 end-0 m-2 z-1">
443
- <i class="bi bi-star-fill me-1"></i>Featured
444
+ <i class="bi bi-star-fill me-1" aria-hidden="true"></i>Featured
444
445
  </span>
445
446
  {% endif %}
446
447
  {% if gpost.post_type and gpost.post_type != "standard" and gpost.post_type != "featured" and gpost.post_type != "breaking" %}
@@ -459,11 +460,11 @@ layout: root
459
460
  <span class="badge bg-light text-dark">{{ tag }}</span>
460
461
  {% endfor %}
461
462
  </div>
462
- <h5 class="card-title mb-2">
463
+ <h2 class="card-title h5 mb-2">
463
464
  <a href="{{ gpost.url | relative_url }}" class="text-decoration-none text-body-emphasis">
464
465
  {{ gpost.title | truncate: 60 }}
465
466
  </a>
466
- </h5>
467
+ </h2>
467
468
  <p class="card-text text-muted small flex-grow-1">
468
469
  {{ gpost.excerpt | strip_html | truncate: 100 }}
469
470
  </p>
@@ -471,7 +472,7 @@ layout: root
471
472
  <div class="card-footer bg-transparent border-top-0">
472
473
  <div class="d-flex justify-content-between align-items-center small text-muted">
473
474
  <span>
474
- <i class="bi bi-calendar me-1"></i>{{ gpost.date | date: "%b %d, %Y" }}
475
+ <i class="bi bi-calendar me-1" aria-hidden="true"></i>{{ gpost.date | date: "%b %d, %Y" }}
475
476
  </span>
476
477
  {% if gpost.author %}
477
478
  <span>
@@ -506,10 +507,10 @@ layout: root
506
507
  <div class="card-body">
507
508
  <div class="d-flex gap-2 mb-2 flex-wrap">
508
509
  {% if lpost.breaking %}
509
- <span class="badge bg-danger"><i class="bi bi-lightning-fill me-1"></i>Breaking</span>
510
+ <span class="badge bg-danger"><i class="bi bi-lightning-fill me-1" aria-hidden="true"></i>Breaking</span>
510
511
  {% endif %}
511
512
  {% if lpost.featured %}
512
- <span class="badge bg-warning text-dark"><i class="bi bi-star-fill me-1"></i>Featured</span>
513
+ <span class="badge bg-warning text-dark"><i class="bi bi-star-fill me-1" aria-hidden="true"></i>Featured</span>
513
514
  {% endif %}
514
515
  {% if lpost.post_type and lpost.post_type != "standard" %}
515
516
  {% include components/post-type-badge.html post_type=lpost.post_type %}
@@ -518,14 +519,14 @@ layout: root
518
519
  <span class="badge bg-light text-dark">{{ tag }}</span>
519
520
  {% endfor %}
520
521
  </div>
521
- <h5 class="card-title">
522
+ <h2 class="card-title h5">
522
523
  <a href="{{ lpost.url | relative_url }}" class="text-decoration-none text-body-emphasis">
523
524
  {{ lpost.title }}
524
525
  </a>
525
- </h5>
526
+ </h2>
526
527
  <p class="card-text text-muted">{{ lpost.excerpt | strip_html | truncate: 200 }}</p>
527
528
  <div class="d-flex gap-3 text-muted small">
528
- <span><i class="bi bi-calendar me-1"></i>{{ lpost.date | date: "%B %d, %Y" }}</span>
529
+ <span><i class="bi bi-calendar me-1" aria-hidden="true"></i>{{ lpost.date | date: "%B %d, %Y" }}</span>
529
530
  {% if lpost.author %}
530
531
  <span>{% include components/author-card.html author=lpost.author style="inline" show_avatar=false %}</span>
531
532
  {% endif %}
@@ -542,7 +543,7 @@ layout: root
542
543
  {% else %}
543
544
  {% comment %} Empty state {% endcomment %}
544
545
  <div class="text-center py-5">
545
- <i class="bi bi-inbox fs-1 text-muted"></i>
546
+ <i class="bi bi-inbox fs-1 text-muted" aria-hidden="true"></i>
546
547
  <p class="text-muted mt-3">No articles in this section yet.</p>
547
548
  <a href="{{ news_index_url | relative_url }}" class="btn btn-outline-primary">
548
549
  Browse all news
@@ -553,10 +554,10 @@ layout: root
553
554
  {% comment %} ========================== {% endcomment %}
554
555
  {% comment %} RELATED SECTIONS {% endcomment %}
555
556
  {% comment %} ========================== {% endcomment %}
556
- <aside class="related-sections mt-5 pt-4 border-top">
557
- <h3 class="h5 mb-3">
558
- <i class="bi bi-compass me-2"></i>Explore Other Sections
559
- </h3>
557
+ <aside class="related-sections mt-5 pt-4 border-top" aria-labelledby="related-sections-heading">
558
+ <h2 class="h5 mb-3" id="related-sections-heading">
559
+ <i class="bi bi-compass me-2" aria-hidden="true"></i>Explore Other Sections
560
+ </h2>
560
561
  <div class="row row-cols-2 row-cols-md-3 row-cols-lg-6 g-3">
561
562
  {% for sec_name in news_sections %}
562
563
  {% unless sec_name == page.category or sec_name == page.title %}
@@ -571,8 +572,8 @@ layout: root
571
572
  <a href="{{ _sec_url | relative_url }}"
572
573
  class="card text-center h-100 text-decoration-none border-0 shadow-sm hover-lift">
573
574
  <div class="card-body py-3">
574
- <i class="bi {{ _sec_nav.icon | default: 'bi-folder' }} fs-4 text-primary mb-2 d-block"></i>
575
- <h6 class="card-title mb-1 small">{{ sec_name }}</h6>
575
+ <i class="bi {{ _sec_nav.icon | default: 'bi-folder' }} fs-4 text-primary mb-2 d-block" aria-hidden="true"></i>
576
+ <h3 class="card-title h6 mb-1 small">{{ sec_name }}</h3>
576
577
  <small class="text-muted">{{ other_section_posts.size }} articles</small>
577
578
  </div>
578
579
  </a>
@@ -35,4 +35,13 @@
35
35
  background-color: var(--zer0-color-link-hover, var(--bs-primary));
36
36
  transform: translateY(-2px);
37
37
  }
38
+
39
+ // `outline: 0` above removes the UA ring, and the hover-style change alone
40
+ // was the only focus cue (opacity, a darker fill, a 2px lift), which is not
41
+ // a visible indicator (WCAG 2.4.7). Same 2px primary ring as the site-wide
42
+ // :focus-visible rule in utilities/_focus.scss; mouse clicks stay ring-free.
43
+ &:focus-visible {
44
+ outline: 2px solid var(--zer0-color-primary, var(--bs-primary));
45
+ outline-offset: 2px;
46
+ }
38
47
  }
@@ -86,3 +86,34 @@
86
86
  }
87
87
  }
88
88
  }
89
+
90
+ // ----------------------------------------------------------------------------
91
+ // Reserve the banner's space while it is up
92
+ // ----------------------------------------------------------------------------
93
+ // components/cookie-consent.html sets `zer0-cookie-banner-open` on <html> and
94
+ // `--zer0-cookie-banner-inset` to the banner's height (kept current by a
95
+ // ResizeObserver) while the banner is shown, and removes both once a choice
96
+ // hides it. Without this the fixed bar covered the end of every page, the
97
+ // floating buttons (Back to top sat fully under it at 1366px), and whatever
98
+ // keyboard focus scrolled to near the bottom edge (WCAG 2.4.11).
99
+ html.zer0-cookie-banner-open {
100
+ // Focus and anchor scrolling stop above the banner, not under it.
101
+ scroll-padding-bottom: var(--zer0-cookie-banner-inset, 0px);
102
+
103
+ body {
104
+ // The last content on the page can scroll clear of the banner.
105
+ padding-bottom: var(--zer0-cookie-banner-inset, 0px);
106
+ }
107
+
108
+ // Lift the floating buttons (both FAB stacks) above the banner. `translate`
109
+ // composes with the `transform` hover/active lifts these buttons already
110
+ // use, so it does not fight them.
111
+ #backToTopBtn,
112
+ #aiChatToggle,
113
+ #obsidianLocalGraphFab,
114
+ .pf-fab,
115
+ .bd-toc-fab,
116
+ .bd-sidebar-fab {
117
+ translate: 0 calc(-1 * var(--zer0-cookie-banner-inset, 0px));
118
+ }
119
+ }
@@ -13,7 +13,7 @@
13
13
  position: fixed;
14
14
  bottom: var(--zer0-space-fab-offset, 1rem);
15
15
  left: var(--zer0-space-fab-offset, 1rem);
16
- z-index: var(--zer0-layer-fab-feedback, 1051);
16
+ z-index: var(--zer0-layer-fab-feedback, 1032);
17
17
 
18
18
  display: inline-flex;
19
19
  align-items: center;
@@ -572,6 +572,28 @@ a:not(.btn) {
572
572
 
573
573
  // MOVED → _sass/components/_skeleton.scss (token-aware, dark-mode-safe)
574
574
 
575
+ // GFM task lists (#573). kramdown emits
576
+ // `<li class="task-list-item"><input class="task-list-item-checkbox" …>Text`
577
+ // with no whitespace, so without these rules the item keeps its bullet and the
578
+ // box sits flush against its text. The box's width plus its right margin
579
+ // equals its negative left margin, so the text and its wrapped lines keep the
580
+ // list indent. The accessible name is added by assets/js/ui-enhancements.js.
581
+ .task-list-item {
582
+ list-style-type: none;
583
+ }
584
+
585
+ .task-list-item-checkbox {
586
+ width: 1.05em;
587
+ height: 1.05em;
588
+ margin: 0 0.55em 0 -1.6em;
589
+ vertical-align: -0.15em;
590
+ accent-color: var(--zer0-color-primary);
591
+ }
592
+
593
+ .task-list-item-checkbox:not(:disabled) {
594
+ cursor: pointer;
595
+ }
596
+
575
597
  // Print optimizations
576
598
  @media print {
577
599
  .btn,
@@ -42,8 +42,11 @@
42
42
  background-color: var(--bs-tertiary-bg);
43
43
  }
44
44
 
45
+ // Current page: the strong link shade on the subtle fill. #0d6efd was
46
+ // 3.42:1 on #cfe2ff; the palette skins set the same colour on these
47
+ // anchors in _sass/theme/_skins.scss.
45
48
  &.active {
46
- color: var(--bs-primary);
49
+ color: var(--bs-link-hover-color);
47
50
  background-color: var(--bs-primary-bg-subtle);
48
51
  font-weight: 500;
49
52
  }
@@ -56,6 +59,11 @@
56
59
 
57
60
  // Navigation Tree Toggle Buttons
58
61
  .nav-tree-toggle {
62
+ // WCAG 2.5.8 target size: the chevron-only toggles (`btn-sm p-1`) rendered
63
+ // 22px wide and failed axe `target-size` on every sidebar page. The
64
+ // full-width section toggles are already larger, so this only grows those.
65
+ min-width: 24px;
66
+ min-height: 24px;
59
67
  color: var(--bs-body-color);
60
68
  text-decoration: none;
61
69
  border: none;
@@ -116,7 +124,7 @@
116
124
  color: var(--bs-secondary-color);
117
125
 
118
126
  &.active {
119
- color: var(--bs-primary);
127
+ color: var(--bs-link-hover-color);
120
128
  }
121
129
  }
122
130