jekyll-theme-zer0 1.19.1 → 1.20.2

data/_includes/navigation/local-graph.html

@@ -17,7 +17,7 @@
   - Renders the current page as a single-node graph when it has no neighbors
   - Hides itself if the current page is not in the wiki-index or the index
     can't be loaded
-  - Lazily loads cytoscape.js from CDN with SRI + crossorigin
+  - Lazily loads the vendored cytoscape.js (assets/vendor/cytoscape/, no CDN)
 
   Opt-out: set `local_graph: false` in page front matter.
 
@@ -53,13 +53,29 @@
   </div>
   <div class="offcanvas-body">
     <div class="obsidian-local-graph-widget" aria-label="Local graph">
+      {%- comment -%}
+        Only show the "Full graph" link when that docs page exists in the build
+        (configurable via `obsidian_graph_url`, default `/docs/obsidian/graph/`).
+        The page lives under pages/ and isn't delivered by remote_theme, so a
+        Pages consumer would otherwise get a 404 link. See issue #204.
+      {%- endcomment -%}
+      {%- assign _graph_url = site.obsidian_graph_url | default: '/docs/obsidian/graph/' -%}
+      {%- assign _graph_page = site.html_pages | where: "url", _graph_url | first -%}
+      {%- unless _graph_page -%}
+        {%- for col in site.collections -%}
+          {%- assign _graph_page = col.docs | where: "url", _graph_url | first -%}
+          {%- if _graph_page -%}{%- break -%}{%- endif -%}
+        {%- endfor -%}
+      {%- endunless -%}
       <div class="obsidian-local-graph-meta d-flex align-items-center justify-content-between gap-2 mb-3">
         <span class="badge text-bg-secondary">Depth {{ lg_depth }}</span>
-        <a href="{{ '/docs/obsidian/graph/' | relative_url }}"
+        {%- if _graph_page -%}
+        <a href="{{ _graph_url | relative_url }}"
            class="btn btn-outline-primary btn-sm"
            title="Open the full site graph">
           <i class="bi bi-arrows-fullscreen me-1" aria-hidden="true"></i>Full graph
         </a>
+        {%- endif -%}
       </div>
       <div id="obsidian-local-graph"
            data-depth="{{ lg_depth }}"

data/_includes/obsidian/full-graph.html

@@ -160,18 +160,16 @@ and [backlinks panel]({{ "/docs/obsidian/syntax-reference/#backlinks-panel" | re
 | --- | --- |
 | Build-time index (nodes + outgoing edges) | [`assets/data/wiki-index.json`]({{ "/assets/data/wiki-index.json" | relative_url }}) (Liquid template at [`assets/data/wiki-index.json`](https://github.com/bamr87/zer0-mistakes/blob/main/assets/data/wiki-index.json)) |
 | Renderer | `assets/js/obsidian-graph.js` |
-| Layout engine | [cytoscape.js](https://js.cytoscape.org/) (loaded from CDN, only on this page) |
+| Layout engine | [cytoscape.js](https://js.cytoscape.org/) (vendored under `assets/vendor/`, loaded only on this page) |
 
 Outgoing edges come from the same `[[…]]` syntax the resolver handles —
 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 (only loaded on this page). -->
-<script src="https://cdn.jsdelivr.net/npm/cytoscape@3.30.0/dist/cytoscape.min.js"
-        integrity="sha384-kpMsYllYzyaWU69Piok08rPNktpnjqAoDMdB00fjqUkEk3lkuUbSuwJ+oXrjvN6B"
-        crossorigin="anonymous"
-        defer></script>
+<!-- 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>
 
 ## See also

data/_layouts/article.html

@@ -126,8 +126,7 @@ layout: default
       <!-- Author -->
       {% if page.author %}
         <span class="post-author" itemprop="author" itemscope itemtype="https://schema.org/Person">
-          <i class="bi bi-person me-1"></i>
-          <span itemprop="name">{{ page.author }}</span>
+          {% include components/author-card.html author=page.author style="inline" name_itemprop="name" %}
         </span>
         <span class="mx-2">•</span>
       {% endif %}
@@ -161,31 +160,59 @@ 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 %}
     {% if page.categories.size > 0 %}
+    {% assign _category_base = site.category_base | default: '/news' %}
     <div class="mb-3">
-      <a href="{{ site.baseurl }}/news/{{ page.categories | first | slugify }}/" 
+      <a href="{{ site.baseurl }}{{ _category_base }}/{{ page.categories | first | slugify }}/"
          class="badge bg-primary text-decoration-none fs-6">
         <i class="bi bi-folder me-1"></i>{{ page.categories | first }}
       </a>
     </div>
     {% endif %}
-    
+
     <!-- Tags -->
+    {% comment %} Only link tag badges when a tags index page actually exists in
+       the build (configurable via `tags_page`, default `/tags/`). On a
+       remote-theme Pages consumer the tags page is plugin/page-generated and
+       absent, so we render plain badges instead of links that 404. See #204. {% endcomment %}
     {% if page.tags and page.tags.size > 0 %}
+      {% assign _tags_base = site.tags_page | default: '/tags/' %}
+      {% assign _tags_page = site.html_pages | where: "url", _tags_base | first %}
       <div class="post-tags mb-3">
         {% for tag in page.tags %}
-          <a href="{{ site.baseurl }}/tags/#{{ tag | slugify }}" class="badge bg-secondary text-decoration-none me-1">
-            <i class="bi bi-tag me-1"></i>{{ tag }}
-          </a>
+          {% if _tags_page %}
+            <a href="{{ site.baseurl }}{{ _tags_base }}#{{ tag | slugify }}" class="badge bg-secondary text-decoration-none me-1">
+              <i class="bi bi-tag me-1"></i>{{ tag }}
+            </a>
+          {% else %}
+            <span class="badge bg-secondary me-1"><i class="bi bi-tag me-1"></i>{{ tag }}</span>
+          {% endif %}
         {% endfor %}
       </div>
     {% endif %}
   </header>
   
   {% comment %} ================================ {% endcomment %}
-  {% comment %} FEATURED HERO IMAGE             {% endcomment %}
+  {% comment %} FEATURED / BREAKING HERO IMAGE  {% endcomment %}
   {% comment %} ================================ {% endcomment %}
-  {% if post_type == "featured" and page.preview %}
+  {% comment %}
+    Render the hero image for prominent post types (featured + breaking) when a
+    preview image is set. Breaking stories were previously skipped because the
+    condition checked only post_type == "featured"; since breaking is mapped
+    before featured (see top of file), breaking+featured posts showed no hero.
+    Nested ifs keep the "only when page.preview exists" guard intact (Liquid has
+    no parentheses, so a flat `a or b and c` would misgroup).
+  {% endcomment %}
+  {% assign show_hero = false %}
+  {% if page.preview %}
+    {% if post_type == "featured" or post_type == "breaking" %}
+      {% assign show_hero = true %}
+    {% endif %}
+  {% endif %}
+  {% if show_hero %}
   <figure class="featured-hero mb-5">
     {% include components/preview-image.html 
        src=page.preview 
@@ -366,71 +393,14 @@ layout: default
   <!-- ================================ -->
   <!-- AUTHOR BIO SECTION               -->
   <!-- ================================ -->
-  {% if page.author %}
-    {% assign author_key = page.author %}
-    {% assign author_data = site.data.authors[author_key] %}
-    {% unless author_data %}
-      {% assign author_data = site.data.authors.default %}
-      {% assign author_name = page.author %}
-    {% else %}
-      {% assign author_name = author_data.name %}
-    {% endunless %}
-    
-    <aside class="author-section my-5 pt-4 border-top">
-      <h3 class="h5 mb-3">
-        <i class="bi bi-person-badge me-2"></i>About the Author
-      </h3>
-      <div class="author-card card border-0 shadow-sm">
-        <div class="card-body">
-          <div class="d-flex align-items-start">
-            {% if author_data.avatar %}
-              <img src="{{ site.baseurl }}/{{ site.public_folder }}{{ author_data.avatar }}" 
-                   alt="{{ author_name }}" 
-                   class="rounded-circle me-3" 
-                   width="80" height="80"
-                   style="object-fit: cover;">
-            {% else %}
-              <div class="rounded-circle bg-primary text-white d-flex align-items-center justify-content-center me-3" 
-                   style="width: 80px; height: 80px;">
-                <i class="bi bi-person fs-1"></i>
-              </div>
-            {% endif %}
-            <div class="flex-grow-1">
-              <h5 class="card-title mb-1">{{ author_name }}</h5>
-              {% if author_data.role %}
-                <p class="text-primary mb-2">{{ author_data.role }}</p>
-              {% endif %}
-              {% if author_data.bio %}
-                <p class="card-text text-muted">{{ author_data.bio }}</p>
-              {% endif %}
-              <div class="author-social d-flex gap-2 mt-2">
-                {% if author_data.github %}
-                  <a href="https://github.com/{{ author_data.github }}" 
-                     class="btn btn-sm btn-outline-secondary" 
-                     target="_blank" rel="noopener" title="GitHub">
-                    <i class="bi bi-github"></i>
-                  </a>
-                {% endif %}
-                {% if author_data.twitter %}
-                  <a href="https://x.com/{{ author_data.twitter }}" 
-                     class="btn btn-sm btn-outline-secondary" 
-                     target="_blank" rel="noopener" title="X" aria-label="X">
-                    <i class="bi bi-twitter-x"></i>
-                  </a>
-                {% endif %}
-                {% if author_data.website %}
-                  <a href="{{ author_data.website }}" 
-                     class="btn btn-sm btn-outline-secondary" 
-                     target="_blank" rel="noopener" title="Website">
-                    <i class="bi bi-globe"></i>
-                  </a>
-                {% endif %}
-              </div>
-            </div>
-          </div>
-        </div>
-      </div>
-    </aside>
+  {% comment %}
+    "About the Author" is honored when the post has an author and the
+    `author_profile` front-matter flag is not false (defaults to true for the
+    posts collection in _config.yml). Rendering is delegated to the shared
+    components/author-bio.html → components/author-card.html primitives.
+  {% endcomment %}
+  {% if page.author and page.author_profile != false %}
+    {% include components/author-bio.html author=page.author %}
   {% endif %}
   
   <!-- ================================ -->

data/_layouts/author.html

@@ -0,0 +1,274 @@
+---
+layout: default
+hide_intro: true
+---
+{% comment %}
+  ===================================================================
+  AUTHOR LAYOUT - Interactive author profile page (content hub)
+  ===================================================================
+
+  File: author.html
+  Path: _layouts/author.html
+  Inherits: default.html (which inherits root.html)
+  Purpose: A dedicated, interactive profile for one author — bio/blurb, social,
+           expertise, an at-a-glance stats dashboard, and a filterable /
+           searchable / sortable grid of every piece of content they've written
+           across ALL collections (posts, docs, notes, notebooks, quickstart,
+           about, quests, hobbies, …).
+
+  Front Matter Variables:
+  - author_key (required): Key into _data/authors.yml. Set automatically by
+    _plugins/author_pages_generator.rb, or by hand for a committed page.
+  - hide_intro: true (set above) — this layout renders its own hero/breadcrumb,
+    so the generic content/intro.html header is suppressed (no duplicate H1).
+
+  Interactivity is progressive-enhancement: with JS off, all content renders as
+  a plain grid (every item visible, crawlable). assets/js/author-profile.js
+  activates on the [data-author-profile] container to power the filters.
+
+  Dependencies:
+  - _data/authors.yml: Author data
+  - components/post-card.html (col=false): Content grid cards
+  - assets/js/author-profile.js: filter / search / sort controller
+  - _sass/components/_author.scss: styling
+  ===================================================================
+{% endcomment %}
+
+{% assign author_key = page.author_key %}
+{% assign author_data = site.data.authors[author_key] %}
+{% assign author_name = author_data.name | default: author_key %}
+{% comment %} Resolve avatar: full URL (e.g. GitHub) as-is, relative path prefixed,
+   or derived from the github handle. See components/author-avatar-url.html {% endcomment %}
+{% capture avatar_url %}{% include components/author-avatar-url.html data=author_data %}{% endcapture %}
+{% assign avatar_url = avatar_url | strip %}
+{% assign has_avatar = false %}{% if avatar_url != "" %}{% assign has_avatar = true %}{% endif %}
+
+{% comment %} ---------------------------------------------------------------
+   Aggregate this author's content across every collection. A document matches
+   when its `author` equals the key, the name, or the display_name.
+--------------------------------------------------------------------------- {% endcomment %}
+{% assign aliases = "" | split: "" %}
+{% assign aliases = aliases | push: author_key %}
+{% if author_data.name %}{% assign aliases = aliases | push: author_data.name %}{% endif %}
+{% if author_data.display_name %}{% assign aliases = aliases | push: author_data.display_name %}{% endif %}
+{% assign author_docs = site.documents | where_exp: "d", "aliases contains d.author" | where_exp: "d", "d.title" | sort: "date" | reverse %}
+
+{% comment %} Distinct collection labels present, unique tags, latest dated item {% endcomment %}
+{% assign collection_labels = "" | split: "" %}
+{% assign all_tags = "" | split: "" %}
+{% for doc in author_docs %}
+  {% unless collection_labels contains doc.collection %}{% assign collection_labels = collection_labels | push: doc.collection %}{% endunless %}
+  {% for t in doc.tags %}{% assign all_tags = all_tags | push: t %}{% endfor %}
+{% endfor %}
+{% assign collection_labels = collection_labels | sort %}
+{% assign unique_tags = all_tags | uniq | sort %}
+{% assign latest_date = nil %}
+{% for doc in author_docs %}{% if doc.date %}{% assign latest_date = doc.date %}{% break %}{% endif %}{% endfor %}
+
+<!-- ========================== -->
+<!-- BREADCRUMB                 -->
+<!-- ========================== -->
+<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 active" aria-current="page">{{ author_name }}</li>
+  </ol>
+</nav>
+
+<!-- ========================== -->
+<!-- PROFILE HERO               -->
+<!-- ========================== -->
+<header class="author-hero card border-0 shadow-sm mb-4" itemscope itemtype="https://schema.org/Person">
+  <div class="card-body p-4 p-md-5">
+    <div class="d-flex flex-column flex-sm-row align-items-center align-items-sm-start gap-4">
+      {% if has_avatar %}
+        <img src="{{ avatar_url }}" alt="{{ author_name }}" class="author-hero__avatar rounded-circle flex-shrink-0" width="128" height="128" style="object-fit: cover;" itemprop="image">
+      {% else %}
+        <div class="author-avatar-fallback rounded-circle bg-primary text-white d-flex align-items-center justify-content-center flex-shrink-0" style="width: 128px; height: 128px;">
+          <i class="bi bi-person fs-1" aria-hidden="true"></i>
+        </div>
+      {% endif %}
+
+      <div class="flex-grow-1 text-center text-sm-start">
+        <h1 class="author-hero__name h2 mb-1" itemprop="name">{{ author_name }}{% if author_data.ai %} <span class="badge author-ai-badge align-middle"><i class="bi bi-robot me-1" aria-hidden="true"></i>AI author</span>{% endif %}</h1>
+        {% if author_data.role %}<p class="text-primary fw-semibold mb-2" itemprop="jobTitle">{{ author_data.role }}</p>{% endif %}
+        {% if author_data.tagline %}<p class="author-hero__tagline lead mb-2" itemprop="slogan">{{ author_data.tagline }}</p>{% endif %}
+        {% if author_data.bio %}<p class="text-body-secondary mb-3" itemprop="description">{{ author_data.bio }}</p>{% endif %}
+
+        <!-- Hero meta: location + latest activity -->
+        <div class="author-hero__meta d-flex flex-wrap justify-content-center justify-content-sm-start gap-3 text-body-secondary small mb-3">
+          {% if author_data.location %}<span itemprop="homeLocation"><i class="bi bi-geo-alt me-1" aria-hidden="true"></i>{{ author_data.location }}</span>{% endif %}
+          <span><i class="bi bi-collection me-1" aria-hidden="true"></i>{{ author_docs.size }} contribution{% unless author_docs.size == 1 %}s{% endunless %}</span>
+          {% if latest_date %}<span><i class="bi bi-clock-history me-1" aria-hidden="true"></i>Last active {{ latest_date | date: "%b %Y" }}</span>{% endif %}
+        </div>
+
+        <!-- Expertise chips -->
+        {% assign hero_chips = author_data.topics | default: author_data.expertise %}
+        {% if hero_chips %}
+          <div class="author-expertise d-flex flex-wrap justify-content-center justify-content-sm-start gap-1 mb-3">
+            {% for skill in hero_chips %}
+              <span class="badge rounded-pill text-bg-light border" itemprop="knowsAbout">{{ skill }}</span>
+            {% endfor %}
+          </div>
+        {% endif %}
+
+        <!-- Social links -->
+        <div class="author-social d-flex flex-wrap justify-content-center justify-content-sm-start gap-2">
+          {% if author_data.github %}<a href="https://github.com/{{ author_data.github }}" class="btn btn-sm btn-outline-secondary" target="_blank" rel="noopener" itemprop="sameAs"><i class="bi bi-github me-1" aria-hidden="true"></i>GitHub</a>{% endif %}
+          {% if author_data.twitter %}<a href="https://x.com/{{ author_data.twitter }}" class="btn btn-sm btn-outline-secondary" target="_blank" rel="noopener" aria-label="X" itemprop="sameAs"><i class="bi bi-twitter-x me-1" aria-hidden="true"></i>X</a>{% endif %}
+          {% if author_data.linkedin %}<a href="https://linkedin.com/in/{{ author_data.linkedin }}" class="btn btn-sm btn-outline-secondary" target="_blank" rel="noopener" itemprop="sameAs"><i class="bi bi-linkedin me-1" aria-hidden="true"></i>LinkedIn</a>{% endif %}
+          {% if author_data.website %}<a href="{{ author_data.website }}" class="btn btn-sm btn-outline-secondary" target="_blank" rel="noopener" itemprop="url"><i class="bi bi-globe me-1" aria-hidden="true"></i>Website</a>{% endif %}
+          {% if author_data.email %}<a href="mailto:{{ author_data.email }}" class="btn btn-sm btn-outline-secondary"><i class="bi bi-envelope me-1" aria-hidden="true"></i>Email</a>{% endif %}
+        </div>
+
+        {% if author_data.ai and author_data.persona.disclosure %}
+          <p class="author-ai-disclosure small text-body-secondary mt-3 mb-0 d-flex align-items-start">
+            <i class="bi bi-robot me-2 mt-1 flex-shrink-0" aria-hidden="true"></i><span>{{ author_data.persona.disclosure }}</span>
+          </p>
+        {% endif %}
+      </div>
+    </div>
+  </div>
+</header>
+
+{% if author_docs.size > 0 %}
+<!-- ========================== -->
+<!-- INTERACTIVE CONTENT HUB    -->
+<!-- ========================== -->
+<section class="author-content" data-author-profile>
+
+  <h2 class="visually-hidden">Contributions by {{ author_name }}</h2>
+
+  <!-- Stats dashboard = interactive type filters (each card filters the grid) -->
+  <div class="author-stats" role="group" aria-label="Filter contributions by type">
+    <button type="button" class="author-stat is-active" data-filter="all" aria-pressed="true">
+      <span class="author-stat__num">{{ author_docs.size }}</span>
+      <span class="author-stat__label"><i class="bi bi-grid-3x3-gap me-1" aria-hidden="true"></i>All</span>
+    </button>
+    {% for clabel in collection_labels %}
+      {% assign cdocs = author_docs | where_exp: "d", "d.collection == clabel" %}
+      {% case clabel %}
+        {% when 'posts' %}{% assign cicon = 'bi-newspaper' %}
+        {% when 'docs' %}{% assign cicon = 'bi-book' %}
+        {% when 'notes' %}{% assign cicon = 'bi-journal-text' %}
+        {% when 'notebooks' %}{% assign cicon = 'bi-journal-code' %}
+        {% when 'quickstart' %}{% assign cicon = 'bi-rocket-takeoff' %}
+        {% when 'about' %}{% assign cicon = 'bi-person-lines-fill' %}
+        {% when 'quests' %}{% assign cicon = 'bi-compass' %}
+        {% when 'hobbies' %}{% assign cicon = 'bi-controller' %}
+        {% else %}{% assign cicon = 'bi-file-earmark-text' %}
+      {% endcase %}
+      <button type="button" class="author-stat" data-filter="{{ clabel }}" aria-pressed="false">
+        <span class="author-stat__num">{{ cdocs.size }}</span>
+        <span class="author-stat__label"><i class="bi {{ cicon }} me-1" aria-hidden="true"></i>{{ clabel | capitalize }}</span>
+      </button>
+    {% endfor %}
+  </div>
+
+  <!-- Controls: search + sort + live result count -->
+  <div class="author-controls d-flex flex-column flex-md-row gap-2 align-items-stretch align-items-md-center mt-3">
+    <div class="author-search flex-grow-1 position-relative">
+      <i class="bi bi-search author-search__icon" aria-hidden="true"></i>
+      <label class="visually-hidden" for="author-search-input">Search {{ author_name }}'s contributions</label>
+      <input type="search" id="author-search-input" class="form-control" placeholder="Search titles and tags…" data-author-search autocomplete="off" aria-controls="author-grid">
+    </div>
+    <div class="d-flex gap-2">
+      <label class="visually-hidden" for="author-sort">Sort contributions</label>
+      <select id="author-sort" class="form-select w-auto" data-author-sort aria-label="Sort contributions">
+        <option value="newest">Newest first</option>
+        <option value="oldest">Oldest first</option>
+        <option value="az">Title A–Z</option>
+      </select>
+      <button type="button" class="btn btn-outline-secondary" data-author-clear hidden>
+        <i class="bi bi-x-lg me-1" aria-hidden="true"></i>Clear
+      </button>
+    </div>
+  </div>
+
+  <!-- Topic / tag cloud (clickable filters) -->
+  {% if unique_tags.size > 0 %}
+  <div class="author-tagcloud mt-3" role="group" aria-label="Filter by topic">
+    <span class="author-tagcloud__label text-body-secondary small me-1"><i class="bi bi-tags me-1" aria-hidden="true"></i>Topics:</span>
+    {% for tag in unique_tags limit: 24 %}
+      <button type="button" class="badge rounded-pill author-tag" data-tag-filter="{{ tag | downcase | escape }}" aria-pressed="false">{{ tag }}</button>
+    {% endfor %}
+  </div>
+  {% endif %}
+
+  <!-- Live result count (announced to screen readers) -->
+  <p class="author-resultcount text-body-secondary small mt-3 mb-2" data-author-count aria-live="polite">
+    Showing {{ author_docs.size }} of {{ author_docs.size }}
+  </p>
+
+  <!-- Content grid -->
+  <div class="row row-cols-1 row-cols-md-2 row-cols-lg-3 g-4" id="author-grid" data-author-grid>
+    {% for doc in author_docs %}
+      {% assign dtags = doc.tags | join: "|" | downcase %}
+      <div class="col author-item"
+           data-collection="{{ doc.collection }}"
+           data-date="{{ doc.date | date: '%s' }}"
+           data-title="{{ doc.title | downcase | escape }}"
+           data-tags="{{ dtags | escape }}">
+        {% include components/post-card.html post=doc show_author=false col=false %}
+      </div>
+    {% endfor %}
+  </div>
+
+  <!-- No-results state (shown by JS when filters match nothing) -->
+  <div class="author-noresults text-center py-5 d-none" data-author-noresults>
+    <i class="bi bi-search fs-1 text-muted" aria-hidden="true"></i>
+    <p class="text-muted mt-3 mb-2">No contributions match your filters.</p>
+    <button type="button" class="btn btn-outline-primary btn-sm" data-author-clear>Clear filters</button>
+  </div>
+</section>
+
+<!-- Structured data: this author's contributions as a CollectionPage / ItemList -->
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "CollectionPage",
+  "name": {{ page.title | default: author_name | jsonify }},
+  "url": {{ page.url | absolute_url | jsonify }},
+  "about": {
+    "@type": "Person",
+    "name": {{ author_name | jsonify }}{% if author_data.website %},
+    "url": {{ author_data.website | jsonify }}{% endif %}
+  },
+  "mainEntity": {
+    "@type": "ItemList",
+    "numberOfItems": {{ author_docs.size }},
+    "itemListElement": [
+      {% for doc in author_docs limit: 100 %}{
+        "@type": "ListItem",
+        "position": {{ forloop.index }},
+        "url": {{ doc.url | absolute_url | jsonify }},
+        "name": {{ doc.title | jsonify }}
+      }{% unless forloop.last %},{% endunless %}
+      {% endfor %}
+    ]
+  }
+}
+</script>
+
+<script defer src="{{ '/assets/js/author-profile.js' | relative_url }}?v={{ site.time | date: '%s' }}"></script>
+
+{% else %}
+{% comment %} Suppress the generic empty state when the page supplies its own
+   body content (e.g. the Guest profile, which is a contribution guide). {% endcomment %}
+{% assign page_body = content | strip %}
+{% if page_body == "" %}
+<!-- Empty state -->
+<div class="text-center py-5">
+  <i class="bi bi-journal-x fs-1 text-muted" aria-hidden="true"></i>
+  <p class="text-muted mt-3">No published content from this author yet.</p>
+  <a href="{{ '/' | relative_url }}" class="btn btn-outline-primary">Back to home</a>
+</div>
+{% endif %}
+{% endif %}
+
+{% if content and content != "" %}
+<section class="author-page-body mt-4">
+  {{ content }}
+</section>
+{% endif %}

data/_layouts/authors.html

@@ -0,0 +1,55 @@
+---
+layout: default
+---
+<!--
+  ===================================================================
+  AUTHORS INDEX LAYOUT - Directory of all author profiles
+  ===================================================================
+
+  File: authors.html
+  Path: _layouts/authors.html
+  Inherits: default.html (which inherits root.html)
+  Purpose: List every author defined in _data/authors.yml, each linking to
+           their individual profile page (/authors/:key/).
+
+  Front Matter Variables:
+  - title (optional): Page title (default: "Authors")
+  - description (optional): Intro text
+
+  Opt-out: an author entry with `profile: false` in _data/authors.yml is
+  hidden from this directory (and skipped by the page generator).
+
+  Dependencies:
+  - _data/authors.yml
+  - components/author-card.html (style="compact")
+  ===================================================================
+-->
+
+<header class="authors-index-header mb-5">
+  <div class="d-flex align-items-center mb-3">
+    <i class="bi bi-people-fill fs-1 me-3 text-primary" aria-hidden="true"></i>
+    <div>
+      <h1 class="display-5 mb-0">{{ page.title | default: "Authors" }}</h1>
+      <p class="text-muted mb-0">{{ page.description | default: "Meet the people behind the content." }}</p>
+    </div>
+  </div>
+  {{ content }}
+</header>
+
+<section class="authors-index">
+  <div class="row row-cols-1 row-cols-md-2 g-4">
+    {% for author in site.data.authors %}
+      {% assign author_key = author[0] %}
+      {% assign author_data = author[1] %}
+      {% unless author_data.profile == false %}
+        <div class="col">
+          <div class="card h-100 border-0 shadow-sm">
+            <div class="card-body">
+              {% include components/author-card.html author=author_key style="compact" show_bio=true avatar_size=64 %}
+            </div>
+          </div>
+        </div>
+      {% endunless %}
+    {% endfor %}
+  </div>
+</section>

data/_layouts/news.html

@@ -121,7 +121,7 @@ source: "https://getbootstrap.com/docs/5.3/examples/blog/#"
           </small>
           {% if hero_post.author %}
             <small class="text-muted">
-              <i class="bi bi-person me-1"></i>{{ hero_post.author }}
+              {% include components/author-card.html author=hero_post.author style="inline" show_avatar=false %}
             </small>
           {% endif %}
           {% if hero_post.categories.size > 0 %}
@@ -218,7 +218,7 @@ source: "https://getbootstrap.com/docs/5.3/examples/blog/#"
               <i class="bi bi-calendar me-1"></i>{{ main_featured.date | date: "%b %d, %Y" }}
               {% if main_featured.author %}
                 <span class="mx-2">•</span>
-                <i class="bi bi-person me-1"></i>{{ main_featured.author }}
+                {% include components/author-card.html author=main_featured.author style="inline" show_avatar=false %}
               {% endif %}
             </small>
           </div>
@@ -414,7 +414,7 @@ source: "https://getbootstrap.com/docs/5.3/examples/blog/#"
               <div class="d-flex gap-3 text-muted small">
                 <span><i class="bi bi-calendar me-1"></i>{{ lpost.date | date: "%B %d, %Y" }}</span>
                 {% if lpost.author %}
-                  <span><i class="bi bi-person me-1"></i>{{ lpost.author }}</span>
+                  <span>{% include components/author-card.html author=lpost.author style="inline" show_avatar=false %}</span>
                 {% endif %}
               </div>
             </div>

data/_layouts/note.html

@@ -52,8 +52,7 @@ layout: default
       <!-- Author -->
       {% if page.author %}
         <span class="note-author" itemprop="author" itemscope itemtype="https://schema.org/Person">
-          <i class="bi bi-person me-1"></i>
-          <span itemprop="name">{{ page.author }}</span>
+          {% include components/author-card.html author=page.author style="inline" name_itemprop="name" %}
         </span>
         <span class="mx-2">•</span>
       {% endif %}
@@ -104,12 +103,21 @@ layout: default
     </div>
     
     <!-- Tags -->
+    {% comment %} Link tag badges only when a tags index exists (configurable via
+       `tags_page`); otherwise render plain badges so remote-theme consumers
+       without a /tags/ page don't get 404 links. See issue #204. {% endcomment %}
     {% if page.tags and page.tags.size > 0 %}
+      {% assign _tags_base = site.tags_page | default: '/tags/' %}
+      {% assign _tags_page = site.html_pages | where: "url", _tags_base | first %}
       <div class="note-tags mb-3">
         {% for tag in page.tags %}
-          <a href="{{ '/tags/' | relative_url }}#{{ tag | slugify }}" class="badge bg-secondary text-decoration-none me-1">
-            {{ tag }}
-          </a>
+          {% if _tags_page %}
+            <a href="{{ _tags_base | relative_url }}#{{ tag | slugify }}" class="badge bg-secondary text-decoration-none me-1">
+              {{ tag }}
+            </a>
+          {% else %}
+            <span class="badge bg-secondary me-1">{{ tag }}</span>
+          {% endif %}
         {% endfor %}
       </div>
     {% endif %}
@@ -141,7 +149,14 @@ layout: default
   <div class="note-content e-content" itemprop="articleBody">
     {{ content }}
   </div>
-  
+
+  <!-- ================================ -->
+  <!-- AUTHOR BIO SECTION               -->
+  <!-- ================================ -->
+  {% if page.author and page.author_profile != false %}
+    {% include components/author-bio.html author=page.author %}
+  {% endif %}
+
   <!-- ================================ -->
   <!-- NOTE FOOTER                      -->
   <!-- ================================ -->