jekyll-theme-zer0 1.21.0 → 1.23.0

data/_includes/components/search-modal.html

@@ -2,19 +2,43 @@
   ===================================================================
   SEARCH MODAL - Site-wide Search Popup
   ===================================================================
-  
+
   File: search-modal.html
   Path: _includes/components/search-modal.html
   Purpose: Provide a modal search experience with keyboard shortcut support
-  
+
   Notes:
-  - Uses /sitemap/ for query-based search results
+  - Form action targets /sitemap/ when that page exists in the build;
+    falls back to /sitemap.xml if available, otherwise '#' (safe no-op).
+    JS (search-modal.js) always intercepts submit and keeps results
+    in-modal, so the action is only a no-JS fallback.  The gate here
+    prevents a dead link on remote-theme Pages builds that lack /sitemap/.
   - Keyboard shortcut handled by navigation keyboard module ("/")
   ===================================================================
 -->
 
 {%- assign ui_text = site.data.ui-text[site.locale] | default: site.data.ui-text.en -%}
 {%- assign search_placeholder = ui_text.search_placeholder_text | default: "Enter your search term..." -%}
+{%- comment -%}
+  Existence-gate the form action to /sitemap/ only when that page is present
+  in the build (mirroring the footer Quick Links guard, and the section-sidebar
+  /tags/ gate).  Remote-theme Pages consumers that haven't committed a /sitemap/
+  stub get a safe '#' fallback; the JS always intercepts submit anyway, so this
+  only affects the no-JS code path.
+{%- endcomment -%}
+{%- assign _search_sitemap_url  = "/sitemap/" -%}
+{%- assign _search_sitemap_page = site.html_pages | where: "url", _search_sitemap_url | first -%}
+{%- unless _search_sitemap_page -%}
+  {%- for col in site.collections -%}
+    {%- assign _search_sitemap_page = col.docs | where: "url", _search_sitemap_url | first -%}
+    {%- if _search_sitemap_page -%}{%- break -%}{%- endif -%}
+  {%- endfor -%}
+{%- endunless -%}
+{%- if _search_sitemap_page -%}
+  {%- assign _search_form_action = "/sitemap/" | relative_url -%}
+{%- else -%}
+  {%- assign _search_form_action = "#" -%}
+{%- endif -%}
 
 <div class="modal fade search-modal" id="siteSearchModal" tabindex="-1" aria-labelledby="siteSearchModalLabel" aria-hidden="true">
     <div class="modal-dialog modal-dialog-centered">
@@ -26,7 +50,7 @@
                 <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
             </div>
             <div class="modal-body">
-                <form action="{{ '/sitemap/' | relative_url }}" method="get" data-search-form>
+                <form action="{{ _search_form_action }}" method="get" data-search-form>
                     <label class="visually-hidden" for="site-search-input">Search</label>
                     <div class="input-group">
                         <span class="input-group-text">

data/_includes/content/backlinks.html

@@ -21,11 +21,26 @@
   ===================================================================
 {%- endcomment -%}
 
-{%- if page.backlinks != false -%}
+{%- if page.backlinks != false and site.obsidian.enabled != false -%}
   {%- assign _self_url = page.url -%}
   {%- assign _self_title = page.title | default: "" | downcase | strip -%}
   {%- assign _self_basename = page.path | split: "/" | last | replace: ".md", "" | replace: ".markdown", "" | downcase -%}
 
+  {%- comment -%}
+    Needles = every name another page could wiki-link this page by: title,
+    file basename, and any frontmatter aliases. Normalized to lowercase + strip
+    to match the resolver. A backlink is a [[needle]] with a terminator
+    (]] | # ^) so [[Foobar]] does NOT match the needle "foo".
+  {%- endcomment -%}
+  {%- assign _needles = "" | split: "" -%}
+  {%- if _self_title != "" -%}{%- assign _needles = _needles | push: _self_title -%}{%- endif -%}
+  {%- if _self_basename != "" -%}{%- assign _needles = _needles | push: _self_basename -%}{%- endif -%}
+  {%- for _alias in page.aliases -%}
+    {%- assign _an = _alias | downcase | strip -%}
+    {%- if _an != "" -%}{%- assign _needles = _needles | push: _an -%}{%- endif -%}
+  {%- endfor -%}
+  {%- assign _needles = _needles | uniq -%}
+
   {%- assign _candidates = "" | split: "" -%}
   {%- for _coll in site.collections -%}
     {%- for _doc in _coll.docs -%}
@@ -46,31 +61,44 @@
       {%- if _doc.published == false or _doc.draft == true -%}{%- continue -%}{%- endif -%}
     {%- endunless -%}
     {%- assign _body = _doc.content | default: "" -%}
-    {%- assign _body_lower = _body | downcase -%}
     {%- assign _matched = false -%}
 
+    {%- comment -%} A markdown link to this page's permalink is a backlink. {%- endcomment -%}
     {%- if _self_url and _self_url != "" and _self_url != "/" -%}
       {%- if _body contains _self_url -%}
         {%- assign _matched = true -%}
       {%- endif -%}
     {%- endif -%}
 
+    {%- comment -%}
+      Wiki-link match: strip fenced (```) and inline (`) code first so a page
+      that merely *documents* [[syntax]] doesn't register as a backlink, then
+      require a terminator after the needle.
+    {%- endcomment -%}
     {%- unless _matched -%}
-      {%- if _self_title != "" -%}
-        {%- assign _needle = "[[" | append: _self_title -%}
-        {%- if _body_lower contains _needle -%}
+      {%- assign _nb = "" -%}
+      {%- assign _fp = _body | split: "```" -%}
+      {%- for _p in _fp -%}
+        {%- assign _m = forloop.index0 | modulo: 2 -%}
+        {%- if _m == 0 -%}{%- assign _nb = _nb | append: _p -%}{%- endif -%}
+      {%- endfor -%}
+      {%- assign _nb2 = "" -%}
+      {%- assign _ip = _nb | split: "`" -%}
+      {%- for _p in _ip -%}
+        {%- assign _m = forloop.index0 | modulo: 2 -%}
+        {%- if _m == 0 -%}{%- assign _nb2 = _nb2 | append: _p -%}{%- endif -%}
+      {%- endfor -%}
+      {%- assign _body_lower = _nb2 | downcase -%}
+      {%- for _n in _needles -%}
+        {%- assign _v1 = "[[" | append: _n | append: "]]" -%}
+        {%- assign _v2 = "[[" | append: _n | append: "|" -%}
+        {%- assign _v3 = "[[" | append: _n | append: "#" -%}
+        {%- assign _v4 = "[[" | append: _n | append: "^" -%}
+        {%- if _body_lower contains _v1 or _body_lower contains _v2 or _body_lower contains _v3 or _body_lower contains _v4 -%}
           {%- assign _matched = true -%}
+          {%- break -%}
         {%- endif -%}
-      {%- endif -%}
-    {%- endunless -%}
-
-    {%- unless _matched -%}
-      {%- if _self_basename != "" -%}
-        {%- assign _needle2 = "[[" | append: _self_basename -%}
-        {%- if _body_lower contains _needle2 -%}
-          {%- assign _matched = true -%}
-        {%- endif -%}
-      {%- endif -%}
+      {%- endfor -%}
     {%- endunless -%}
 
     {%- if _matched -%}
@@ -92,11 +120,12 @@
               <strong>{{ _ref.title | default: _ref.path | split: "/" | last }}</strong>
             </a>
             {%- if _ref.collection -%}
-              <span class="badge bg-light text-dark ms-1">{{ _ref.collection }}</span>
+              <span class="badge rounded-pill border text-body-secondary ms-1">{{ _ref.collection }}</span>
             {%- endif -%}
-            {%- if _ref.description -%}
+            {%- assign _ref_excerpt = _ref.description | default: _ref.excerpt | strip_html | strip | truncate: 160 -%}
+            {%- if _ref_excerpt and _ref_excerpt != "" -%}
               <div class="obsidian-backlink-excerpt small text-muted">
-                {{ _ref.description | strip_html | truncate: 160 }}
+                {{ _ref_excerpt }}
               </div>
             {%- endif -%}
           </li>

data/_includes/content/giscus.html

@@ -1,49 +1,35 @@
 <!--
-╔═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════╗
-║                                                giscus.html                                                        ║
-║                                         GitHub Discussions Comment System                                         ║
-╠═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════╣
-║                                                                                                                   ║
-║ Purpose:      Integrates Giscus comment system powered by GitHub Discussions                                     ║
-║ Location:     /_includes/content/giscus.html                                                                     ║
-║ Usage:        include content/giscus.html (Liquid tag; braces omitted — Liquid                                   ║
-║               parses include tags even inside HTML comments, which would error) ║
-║ Dependencies: GitHub repository with Discussions enabled, site.repository, site.giscus configuration           ║
-║                                                                                                                   ║
-║ Features:                                                                                                         ║
-║ • GitHub Discussions-based commenting system                                                                     ║
-║ • Automatic theme detection (preferred_color_scheme)                                                             ║
-║ • Pathname-based mapping for unique comment threads                                                              ║
-║ • Reaction support for enhanced user engagement                                                                  ║
-║ • Top-positioned input for better UX                                                                             ║
-║                                                                                                                   ║
-║ Configuration Options:                                                                                            ║
-║ • data-repo: GitHub repository (site.repository)                                                                 ║
-║ • data-repo-id: GitHub repository ID (site.giscus.data-repo-id)                                                 ║
-║ • data-category-id: Discussions category ID (site.giscus.data-category-id)                                      ║
-║ • data-mapping: "pathname" - maps comments to page URL                                                           ║
-║ • data-strict: "1" - enables strict mapping mode                                                                 ║
-║                                                                                                                   ║
-║ Setup Requirements:                                                                                               ║
-║ • GitHub repository with Discussions feature enabled                                                             ║
-║ • Giscus app installed on the repository                                                                         ║
-║ • Correct repo-id and category-id in _config.yml                                                                 ║
-║                                                                                                                   ║
-║ Reference: Feature Request #FR000001                                                                              ║
-║ Documentation: https://giscus.app/                                                                                ║
-║                                                                                                                   ║
-╚═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════╝
--->
+  giscus.html — GitHub Discussions comment system
+  ===============================================
+
+  Purpose:      Embeds the Giscus widget so page comments are stored as
+                GitHub Discussions (no database, privacy-friendly).
+  Location:     _includes/content/giscus.html
+  Usage:        Rendered by the article / note / notebook layouts, gated on
+                `page.comments != false and site.giscus.enabled`.
+                To include manually elsewhere, use the FULL path:
+                  include content/giscus.html   (wrap in Liquid tags)
+  Dependencies: site.repository, site.giscus.* (see _config.yml), a public
+                repo with Discussions enabled + the Giscus app installed.
+
+  Features:
+  • GitHub Discussions-based commenting
+  • Automatic light/dark theme (preferred_color_scheme)
+  • Pathname-based mapping for one thread per page (data-strict)
+  • Reactions enabled, input positioned at the top
 
-<!-- ===================================================================================================== -->
-<!--                                      GISCUS COMMENT SYSTEM                                           -->
-<!-- ===================================================================================================== -->
-<!-- GitHub Discussions-powered comment system integration                                                -->
-<!-- Feature Request: #FR000001                                                                           -->
-<!-- Documentation: https://giscus.app/                                                                   -->
-<!-- Async loading: Non-blocking comment system initialization                                            -->
+  Config-driven attributes (from _config.yml `giscus:` block):
+  • data-repo        ← site.repository
+  • data-repo-id     ← site.giscus.data-repo-id
+  • data-category-id ← site.giscus.data-category-id
 
-<!-- giscus app - https://giscus.app/ - Feature # FR000001 -->
+  Docs:      pages/_docs/features/giscus-comments.md
+  Reference: https://giscus.app/ (Feature Request #FR000001)
+
+  NOTE: do not write a bare `include giscus.html` example with live Liquid
+  braces inside this file — Liquid evaluates tags even inside HTML comments,
+  which would recursively (and wrongly) try to include "giscus.html".
+-->
 
 <script src="https://giscus.app/client.js"
         data-repo="{{ site.repository }}"
@@ -58,4 +44,4 @@
         data-lang="en"
         crossorigin="anonymous"
         async>
-</script>
+</script>

data/_includes/core/color-mode-init.html

@@ -0,0 +1,35 @@
+{%- comment -%}
+  Component:   color-mode-init
+  Path:        _includes/core/color-mode-init.html
+  Purpose:     Early inline script that applies data-bs-theme BEFORE Bootstrap CSS
+               loads, preventing FOUC (flash of unstyled/wrong-themed content).
+  Params:      none — reads data-color-mode-default from the <html> element,
+               which root.html sets from site.color_mode_default.
+  Depends on:  root.html (sets data-color-mode-default attribute server-side)
+  Notes:       Must be included BEFORE any Bootstrap CSS link tag. The script
+               is tiny, synchronous, and runs inline before the browser requests
+               external stylesheets, so the correct theme is already applied
+               when Bootstrap's [data-bs-theme] selectors are first evaluated.
+
+  Priority order (highest → lowest):
+    1. localStorage["theme"]    — user's explicit override via Appearance panel
+    2. data-color-mode-default  — site.color_mode_default config value
+    3. "auto" fallback          — resolves via prefers-color-scheme
+{%- endcomment -%}
+<script>
+(function () {
+  'use strict';
+  try {
+    var root = document.documentElement;
+    var configDefault = root.getAttribute('data-color-mode-default') || 'auto';
+    var stored = window.localStorage.getItem('theme');
+    var mode = stored || configDefault;
+    if (mode === 'auto') {
+      root.setAttribute('data-bs-theme',
+        window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light');
+    } else {
+      root.setAttribute('data-bs-theme', mode);
+    }
+  } catch (e) { /* localStorage / matchMedia unavailable — server-rendered value stands */ }
+})();
+</script>

data/_includes/core/footer-fabs.html

@@ -23,6 +23,9 @@
 {%- assign _root_only_layouts = "landing,welcome,stats,sitemap-collection,setup,section,news,index,home,admin" | split: "," -%}
 {%- unless _root_only_layouts contains page.layout -%}
   {% include navigation/toc-fab.html %}
-  {% include navigation/local-graph-fab.html %}
-  {% include navigation/local-graph.html %}
+  {%- comment -%} Local-graph FAB/panel are part of the Obsidian feature. {%- endcomment -%}
+  {%- if site.obsidian.enabled != false -%}
+    {% include navigation/local-graph-fab.html %}
+    {% include navigation/local-graph.html %}
+  {%- endif -%}
 {%- endunless -%}

data/_includes/core/head.html

@@ -127,6 +127,15 @@ window.MathJax = {
 <!-- CSS FRAMEWORKS AND LIBRARIES   -->
 <!-- ================================ -->
 
+<!-- ========================== -->
+<!-- COLOR MODE INIT (FOUC FIX) -->
+<!-- ========================== -->
+<!-- Must run BEFORE Bootstrap CSS so the correct data-bs-theme is applied
+     when [data-bs-theme=dark/light] selectors are first evaluated.
+     Reads site.color_mode_default (via data-color-mode-default attr on <html>)
+     and falls back to localStorage["theme"] for the user's explicit preference. -->
+{% include core/color-mode-init.html %}
+
 <!-- ========================== -->
 <!-- BOOTSTRAP 5 FRAMEWORK     -->
 <!-- ========================== -->

data/_includes/core/tokens-inline.html

@@ -35,6 +35,11 @@
 {%- endif -%}
 
 {%- comment -%}
+  NOTE: The data-bs-theme FOUC-prevention script lives in
+  _includes/core/color-mode-init.html (included from head.html BEFORE Bootstrap
+  CSS) so the correct theme is applied before any [data-bs-theme] selectors are
+  evaluated. Do not duplicate it here.
+
   Restore any user-saved Appearance overrides before paint to avoid a flash
   of the default palette. The Appearance panel (Track 6) writes JSON like
   {"primary":"#ff5722"} to localStorage["zer0-appearance"].

data/_includes/navigation/local-graph-fab.html

@@ -11,7 +11,7 @@
   {%- endif -%}
 {%- endif -%}
 {%- if page.local_graph != false and _effective_sidebar != false -%}
-<div class="obsidian-local-graph-fab d-print-none" data-obsidian-local-graph-toggle>
+<div id="obsidianLocalGraphFab" class="obsidian-local-graph-fab d-print-none" data-obsidian-local-graph-toggle hidden>
   <button class="btn btn-primary rounded-circle shadow-lg p-0 obsidian-local-graph-toggle"
           type="button"
           data-bs-toggle="offcanvas"

data/_includes/navigation/local-graph.html

@@ -40,7 +40,8 @@
        aria-labelledby="obsidianLocalGraphLabel"
        data-bs-scroll="true"
        data-bs-backdrop="false"
-       data-obsidian-local-graph-panel>
+       data-obsidian-local-graph-panel
+       hidden>
   <div class="offcanvas-header">
     <h2 class="offcanvas-title h5 mb-0" id="obsidianLocalGraphLabel">
       <i class="bi bi-diagram-3 me-2" aria-hidden="true"></i>Local graph
@@ -80,7 +81,7 @@
       <div id="obsidian-local-graph"
            data-depth="{{ lg_depth }}"
            data-index-url="{{ '/assets/data/wiki-index.json' | relative_url }}"
-           role="img"
+           role="group"
            aria-label="Local graph of pages linked to this page"></div>
       <p class="obsidian-local-graph-status small text-secondary mt-2 mb-0"
          data-obsidian-local-graph-status
@@ -88,5 +89,5 @@
     </div>
   </div>
 </aside>
-<script src="{{ '/assets/js/obsidian-local-graph.js' | relative_url }}" defer></script>
+<script src="{{ '/assets/js/obsidian-local-graph.js' | relative_url }}?v={{ site.time | date: '%s' }}" defer></script>
 {%- endif -%}

data/_includes/navigation/section-sidebar.html

@@ -64,9 +64,14 @@
           {% endfor %}
         </nav>
       </div>
-      {% if sub_categories.size > 15 %}
+      {% comment %} Existence-gate the tags index: a remote-theme consumer without
+         the (plugin-generated) /tags/ page must not get a 404 link. Mirrors the
+         footer Quick-Links guard and honours the documented site.tags_page. {% endcomment %}
+      {% assign _tags_url = site.tags_page | default: "/tags/" %}
+      {% assign _tags_page = site.html_pages | where: "url", _tags_url | first %}
+      {% if sub_categories.size > 15 and _tags_page %}
       <div class="card-footer bg-transparent">
-        <a href="{{ site.baseurl }}/tags/" class="btn btn-sm btn-outline-secondary w-100">
+        <a href="{{ _tags_url | relative_url }}" class="btn btn-sm btn-outline-secondary w-100">
           View All Tags <i class="bi bi-arrow-right ms-1"></i>
         </a>
       </div>
@@ -123,11 +128,13 @@
         {% endif %}
       {% endfor %}
     </nav>
+    {% if _tags_page %}
     <div class="p-3">
-      <a href="{{ site.baseurl }}/tags/" class="btn btn-outline-primary w-100">
+      <a href="{{ _tags_url | relative_url }}" class="btn btn-outline-primary w-100">
         <i class="bi bi-tags me-2"></i>Browse All Tags
       </a>
     </div>
+    {% endif %}
   </div>
 </div>
 

data/_includes/obsidian/full-graph.html

@@ -136,7 +136,7 @@ and [backlinks panel]({{ "/docs/obsidian/syntax-reference/#backlinks-panel" | re
   <span id="obsidian-graph-status" role="status"></span>
 </div>
 
-<div id="obsidian-graph" role="img" aria-label="Site knowledge graph"></div>
+<div id="obsidian-graph" role="group" aria-label="Site knowledge graph"></div>
 
 <div class="obsidian-graph-legend" aria-label="Graph legend">
   <span><span class="swatch" style="background:#0d6efd"></span>Posts</span>
@@ -167,10 +167,12 @@ unresolved targets show up as dashed red nodes so you can find dangling
 links at a glance. The graph is regenerated every Jekyll build; nothing
 runs client-side except cytoscape's force layout.
 
-<!-- Cytoscape.js (vendored, only loaded on this page) — no CDN so the graph
-     works under strict CSP and offline. See assets/vendor/cytoscape/. -->
-<script src="{{ '/assets/vendor/cytoscape/cytoscape.min.js' | relative_url }}" defer></script>
-<script src="{{ '/assets/js/obsidian-graph.js' | relative_url }}" defer></script>
+<!-- Cytoscape.js is vendored (no runtime CDN) and lazy-loaded by
+     obsidian-graph.js from window.OBSIDIAN_CONFIG.cytoscapeUrl, only on this
+     page, with an in-page recovery message if the fetch fails. -->
+{% if site.obsidian.enabled != false %}
+<script src="{{ '/assets/js/obsidian-graph.js' | relative_url }}?v={{ site.time | date: '%s' }}" defer></script>
+{% endif %}
 
 ## See also
 

data/_layouts/article.html

@@ -160,16 +160,33 @@ layout: default
     </div>
     
     <!-- Category Link -->
-    {% comment %} Category base is configurable (`category_base`, default `/news`)
-       so remote-theme consumers whose category index lives elsewhere
-       (e.g. `/categories`) don't get a hardcoded 404. See issue #204. {% endcomment %}
+    {% comment %} Category base is configurable (`category_base`, default `/news`).
+       Only link the badge when that category index page actually exists in the
+       build; on a remote-theme Pages consumer the category section is
+       plugin/page-generated and absent, so we render a plain badge instead of a
+       link that 404s (mirrors the tag-badge and footer Quick-Links guard).
+       See issue #204. {% endcomment %}
     {% if page.categories.size > 0 %}
     {% assign _category_base = site.category_base | default: '/news' %}
+    {% assign _primary_category = page.categories | first %}
+    {% capture _category_url %}{{ _category_base }}/{{ _primary_category | slugify }}/{% endcapture %}
+    {% comment %} Category index pages can live in site.pages (a regular page) or
+       site.posts (a dated section index), so check both. {% endcomment %}
+    {% assign _category_page = site.html_pages | where: "url", _category_url | first %}
+    {% unless _category_page %}
+      {% assign _category_page = site.posts | where: "url", _category_url | first %}
+    {% endunless %}
     <div class="mb-3">
-      <a href="{{ site.baseurl }}{{ _category_base }}/{{ page.categories | first | slugify }}/"
+      {% if _category_page %}
+      <a href="{{ site.baseurl }}{{ _category_url }}"
          class="badge bg-primary text-decoration-none fs-6">
-        <i class="bi bi-folder me-1"></i>{{ page.categories | first }}
+        <i class="bi bi-folder me-1"></i>{{ _primary_category }}
       </a>
+      {% else %}
+      <span class="badge bg-primary fs-6">
+        <i class="bi bi-folder me-1"></i>{{ _primary_category }}
+      </span>
+      {% endif %}
     </div>
     {% endif %}
 
@@ -512,7 +529,7 @@ layout: default
   <!-- ================================ -->
   <!-- COMMENT SYSTEM                   -->
   <!-- ================================ -->
-  {% if page.comments != false and site.giscus %}
+  {% if page.comments != false and site.giscus.enabled %}
     <section class="post-comments mt-5 pt-4 border-top" id="comments">
       <h2 class="h4 mb-4">
         <i class="bi bi-chat-dots me-2"></i>Comments

data/_layouts/author.html

@@ -68,10 +68,31 @@ hide_intro: true
 <!-- ========================== -->
 <!-- BREADCRUMB                 -->
 <!-- ========================== -->
+{%- comment -%}
+  Only link the /authors/ breadcrumb crumb when that index page actually exists
+  in the build. A pure remote-theme Pages consumer doesn't get the
+  plugin-generated /authors/ index, so rendering the link would produce a 404.
+  Mirror the existence guard used in _includes/navigation/breadcrumbs.html
+  and _includes/components/author-bio.html. See issue #204.
+{%- endcomment -%}
+{%- assign _authors_url = '/authors/' -%}
+{%- assign _authors_page = site.html_pages | where: "url", _authors_url | first -%}
+{%- unless _authors_page -%}
+  {%- for _col in site.collections -%}
+    {%- assign _authors_page = _col.docs | where: "url", _authors_url | first -%}
+    {%- if _authors_page -%}{%- break -%}{%- endif -%}
+  {%- endfor -%}
+{%- endunless -%}
 <nav aria-label="breadcrumb" class="mb-3">
   <ol class="breadcrumb">
     <li class="breadcrumb-item"><a href="{{ '/' | relative_url }}">Home</a></li>
-    <li class="breadcrumb-item"><a href="{{ '/authors/' | relative_url }}">Authors</a></li>
+    <li class="breadcrumb-item">
+      {%- if _authors_page -%}
+        <a href="{{ _authors_url | relative_url }}">Authors</a>
+      {%- else -%}
+        Authors
+      {%- endif -%}
+    </li>
     <li class="breadcrumb-item active" aria-current="page">{{ author_name }}</li>
   </ol>
 </nav>

data/_layouts/root.html

@@ -31,7 +31,21 @@
 -->
 
 <!doctype html>
-<html lang="{{ site.locale | slice: 0,2 | default: 'en' }}" class="no-js" data-bs-theme="dark" data-theme-skin="{{ site.theme_skin | default: 'dark' }}" data-zer0-bg="{{ site.theme_background.enabled | default: true }}">
+{%- comment -%}
+  Resolve the server-side data-bs-theme:
+    dark  → dark
+    light → light
+    auto  → dark  (inline script in tokens-inline.html corrects this before first paint)
+  We also store the raw config value in data-color-mode-default so the inline
+  script can read it without a Liquid evaluation.
+{%- endcomment -%}
+{%- assign _cm = site.color_mode_default | default: 'auto' -%}
+{%- if _cm == 'light' -%}
+  {%- assign _bs_theme = 'light' -%}
+{%- else -%}
+  {%- assign _bs_theme = 'dark' -%}
+{%- endif -%}
+<html lang="{{ site.locale | slice: 0,2 | default: 'en' }}" class="no-js" data-bs-theme="{{ _bs_theme }}" data-color-mode-default="{{ _cm }}" data-theme-skin="{{ site.theme_skin | default: 'dark' }}" data-zer0-bg="{{ site.theme_background.enabled | default: true }}">
     <head>
         <!-- =============================================== -->
         <!-- HEAD SECTION: Meta tags, styles, and SEO setup -->