jekyll-theme-zer0 1.26.0 → 1.28.0

data/_includes/components/theme-customizer.html

@@ -14,8 +14,14 @@
   ===================================================================
 -->
 
-{% assign current_skin = site.theme_skin | default: site.data.theme_skins.default | default: "dark" %}
-{% assign skins = site.data.theme_skins.order %}
+{%- comment -%}
+  _data/theme_skins.yml is optional for consumers (remote_theme cannot ship
+  _data), so fall back to the compiled skin registry. Keep this list in sync
+  with the [data-theme-skin] blocks in _sass/theme/_skins.scss.
+{%- endcomment -%}
+{% assign _skin_fallback = "air|aqua|dirt|neon|mint|plum|sunrise" | split: "|" %}
+{% assign current_skin = site.theme_skin | default: site.data.theme_skins.default | default: "air" %}
+{% assign skins = site.data.theme_skins.order | default: _skin_fallback %}
 
 <p class="text-body-secondary mb-3">
   Current skin: <strong>{{ current_skin }}</strong>. Click a card to preview (page-level only — does not persist).

data/_includes/components/translation-notice.html

@@ -0,0 +1,27 @@
+{% comment %} Feature: ZER0-078 {% endcomment %}
+{%- comment -%}
+  Component:   translation-notice
+  Path:        _includes/components/translation-notice.html
+  Purpose:     Disclosure banner shown at the top of machine-generated
+               translations: tells the reader the page was translated
+               automatically and links back to the English original.
+  Params:      none — renders only when page.machine_translated is true
+               (set by scripts/translate.rb on generated pages).
+  Depends on:  core/i18n.html, Bootstrap 5 alert, Bootstrap Icons
+  Notes:       No-op on every human-authored page, so it is safe to include
+               unconditionally from the root layout.
+{%- endcomment -%}
+{%- if page.machine_translated -%}
+{%- include core/i18n.html -%}
+<div class="container-xl mt-3 translation-notice">
+    <div class="alert alert-info d-flex align-items-start gap-2 mb-0" role="note">
+        <i class="bi bi-translate flex-shrink-0 mt-1" aria-hidden="true"></i>
+        <span>
+            {{ ui.machine_translation_notice | default: "This page was translated automatically from the English original." }}
+            {%- if page.translation_source_url %}
+            <a class="alert-link" href="{{ page.translation_source_url | relative_url }}" hreflang="{{ site.translation.source_lang | default: 'en' }}">{{ ui.machine_translation_view_source | default: "View the original" }}</a>
+            {%- endif %}
+        </span>
+    </div>
+</div>
+{%- endif -%}

data/_includes/content/intro.html

@@ -12,7 +12,8 @@
     - Responsive flex layout: full-width content block, frosted metadata footer with reading time and action buttons
     - Balanced padding and typography hierarchy via bd-intro-* classes
     - Metadata row: author, dates, category, difficulty, tags, view source
---> 
+-->
+{%- include core/i18n.html -%}
 {% if page.collection %}
   {% capture page_dir %}{{ site.collections_dir }}{% endcapture %}
   {% assign testvar = "collection exists" %}
@@ -133,7 +134,7 @@
 {% endif %}
 
 <div class="bd-intro" style="
-  background: linear-gradient(rgba(0, 0, 0, 0.5), rgba(0, 0, 0, 0.5)), url('{{ preview_path | relative_url }}') no-repeat center center / cover;">
+  background: linear-gradient(rgba(0, 0, 0, 0.5), rgba(0, 0, 0, 0.5)), url('{{ preview_path }}') no-repeat center center / cover;">
 
   <div class="bd-intro-inner">
     <div class="bd-intro-content">
@@ -161,7 +162,7 @@
         <li class="bd-intro-meta-item">
           <i class="bi bi-calendar3 bd-intro-meta-icon" aria-hidden="true"></i>
           <time datetime="{{ intro_published | date_to_xmlschema }}" itemprop="datePublished">
-            Published {{ intro_published | date: "%b %d, %Y" }}
+            {{ ui.published_label | default: "Published" }} {{ intro_published | date: "%b %d, %Y" }}
           </time>
         </li>
         {% endif %}
@@ -170,7 +171,7 @@
         <li class="bd-intro-meta-item">
           <i class="bi bi-pencil bd-intro-meta-icon" aria-hidden="true"></i>
           <time datetime="{{ intro_updated | date_to_xmlschema }}" itemprop="dateModified">
-            Updated {{ intro_updated | date: "%b %d, %Y" }}
+            {{ ui.updated_label | default: "Updated" }} {{ intro_updated | date: "%b %d, %Y" }}
           </time>
         </li>
         {% endif %}
@@ -212,7 +213,7 @@
         {% if intro_source_url %}
         <li class="bd-intro-meta-item bd-intro-meta-item--source d-none d-md-inline-flex">
           <i class="bi bi-file-earmark-code bd-intro-meta-icon" aria-hidden="true"></i>
-          <a class="bd-intro-meta-link" href="{{ intro_source_url }}" target="_blank" rel="noopener noreferrer">View source</a>
+          <a class="bd-intro-meta-link" href="{{ intro_source_url }}" target="_blank" rel="noopener noreferrer">{{ ui.view_source | default: "View source" }}</a>
         </li>
         {% endif %}
       </ul>
@@ -221,9 +222,9 @@
         <p class="bd-intro-meta">
           <i class="bi bi-clock me-1" aria-hidden="true"></i>
           {% if page.estimated_reading_time %}
-          Estimated reading time: {{ page.estimated_reading_time }}
+          {{ ui.reading_time_label | default: "Estimated reading time:" }} {{ page.estimated_reading_time }}
           {% else %}
-          Estimated reading time: {{ intro_read_mins }} minute{% if intro_read_mins != 1 %}s{% endif %}
+          {{ ui.reading_time_label | default: "Estimated reading time:" }} {{ intro_read_mins }} {{ ui.reading_time_minute | default: "minute" }}{% if intro_read_mins != 1 %}s{% endif %}
           {% endif %}
         </p>
 
@@ -233,12 +234,12 @@
     <div class="dropdown">
       <button class="btn btn-sm btn-info dropdown-toggle" type="button" id="shareDropdownBottom" data-bs-toggle="dropdown" aria-expanded="false">
         <i class="bi bi-share" aria-hidden="true"></i>
-        <span class="d-none d-sm-inline ms-1">Share</span>
+        <span class="d-none d-sm-inline ms-1">{{ ui.share_label | default: "Share" }}</span>
       </button>
       <ul class="dropdown-menu dropdown-menu-end" aria-labelledby="shareDropdownBottom">
         <li>
           <a class="dropdown-item" href="https://reddit.com/submit?url={{ page_absolute_url | uri_escape }}&amp;title={{ page.title | uri_escape }}" target="_blank" rel="noopener noreferrer">
-            <i class="bi bi-reddit me-2"></i>Share on Reddit
+            <i class="bi bi-reddit me-2"></i>{{ ui.share_on_label | default: "Share on" }} Reddit
           </a>
         </li>
         <li>
@@ -250,12 +251,12 @@
              data-share-url="{{ page_absolute_url | escape }}"
              data-share-title="{{ linkedin_share_title | escape }}"
              data-share-description="{{ linkedin_share_description | escape }}">
-            <i class="bi bi-linkedin me-2"></i>Share on LinkedIn
+            <i class="bi bi-linkedin me-2"></i>{{ ui.share_on_label | default: "Share on" }} LinkedIn
           </a>
         </li>
         <li>
-          <a class="dropdown-item" href="https://x.com/intent/tweet?url={{ site.url | append: page.url | url_encode }}&text={{ page.title | url_encode }}" target="_blank" aria-label="Share on X">
-            <i class="bi bi-twitter-x me-2"></i>Share on X
+          <a class="dropdown-item" href="https://x.com/intent/tweet?url={{ site.url | append: page.url | url_encode }}&text={{ page.title | url_encode }}" target="_blank" aria-label="{{ ui.share_on_label | default: 'Share on' }} X">
+            <i class="bi bi-twitter-x me-2"></i>{{ ui.share_on_label | default: "Share on" }} X
           </a>
         </li>
         <li><hr class="dropdown-divider"></li>
@@ -266,7 +267,7 @@
             the blocking alert() the legacy markup used.
           {%- endcomment -%}
           <button class="dropdown-item" type="button" data-copy="{{ site.url | append: page.url }}">
-            <i class="bi bi-clipboard me-2" aria-hidden="true"></i>Copy Link
+            <i class="bi bi-clipboard me-2" aria-hidden="true"></i>{{ ui.copy_link_label | default: "Copy Link" }}
           </button>
         </li>
       </ul>
@@ -284,7 +285,7 @@
        rel="noopener noreferrer"
        title="Report a problem or suggest an improvement for this page">
       <i class="bi bi-megaphone" aria-hidden="true"></i>
-      <span class="d-none d-sm-inline ms-1">Improve</span>
+      <span class="d-none d-sm-inline ms-1">{{ ui.improve_label | default: "Improve" }}</span>
     </a>
     {% endif %}
 
@@ -294,7 +295,7 @@
        target="_blank"
        rel="noopener noreferrer">
       <i class="bi bi-github" aria-hidden="true"></i>
-      <span class="d-none d-sm-inline ms-1">Edit on GitHub</span>
+      <span class="d-none d-sm-inline ms-1">{{ ui.edit_on_github | default: "Edit on GitHub" }}</span>
     </a>
         </div>
       </div>

data/_includes/content/seo.html

@@ -37,17 +37,23 @@
   {%- assign assets_prefix = site.preview_images.assets_prefix | default: '/assets' -%}
   {%- assign auto_prefix = site.preview_images.auto_prefix | default: true -%}
 
+  {%- comment -%}
+    Guard with truthiness AND blank: in Liquid 4 `nil != blank` is TRUE, so a
+    bare `!= blank` check on an unset variable takes the branch and assigns a
+    nil seo_image — og:image was silently dropped on every page without a
+    page.header image, defeating the site.og_image fallback entirely.
+  {%- endcomment -%}
   {%- if page_teaser_image contains '://' -%}
     {%- comment -%} External URL - use as-is {%- endcomment -%}
-  {%- elsif auto_prefix and page_teaser_image != blank -%}
+  {%- elsif auto_prefix and page_teaser_image and page_teaser_image != blank -%}
     {%- unless page_teaser_image contains assets_prefix -%}
       {%- assign page_teaser_image = assets_prefix | append: page_teaser_image -%}
     {%- endunless -%}
   {%- endif -%}
 
-  {%- if page_large_image != blank -%}
+  {%- if page_large_image and page_large_image != blank -%}
     {%- assign seo_image = page_large_image | absolute_url | escape -%}
-  {%- elsif page_teaser_image != blank -%}
+  {%- elsif page_teaser_image and page_teaser_image != blank -%}
     {%- assign seo_image = page_teaser_image | absolute_url | escape -%}
   {%- endif -%}
 

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

@@ -13,9 +13,12 @@
                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
+    1. site.color_mode_lock     — when true, config wins unconditionally:
+                                  visitor preference and OS scheme are ignored
+                                  (data-color-mode-lock attribute, set by root.html)
+    2. localStorage["theme"]    — user's explicit override via Appearance panel
+    3. data-color-mode-default  — site.color_mode_default config value
+    4. "auto" fallback          — resolves via prefers-color-scheme
 {%- endcomment -%}
 <script>
 (function () {
@@ -23,8 +26,14 @@
   try {
     var root = document.documentElement;
     var configDefault = root.getAttribute('data-color-mode-default') || 'auto';
-    var stored = window.localStorage.getItem('theme');
+    var locked = root.getAttribute('data-color-mode-lock') === 'true';
+    var stored = locked ? null : window.localStorage.getItem('theme');
     var mode = stored || configDefault;
+    if (mode === 'auto' && locked) {
+      {%- comment -%} A locked "auto" is contradictory; treat it as dark so
+          the brand-pinned mode never flips with the OS. {%- endcomment %}
+      mode = 'dark';
+    }
     if (mode === 'auto') {
       root.setAttribute('data-bs-theme',
         window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light');

data/_includes/core/favicon.html

@@ -0,0 +1,46 @@
+{% comment %} Feature: ZER0-079 {% endcomment %}
+{%- comment -%}
+  Component:   favicon
+  Path:        _includes/core/favicon.html
+  Purpose:     Emit the browser-identity tags (favicon, SVG icon, Apple touch
+               icon, web manifest, theme-color) for every page. Before this
+               include existed, sites relied on the browser's implicit
+               /favicon.ico probe — which silently 404s on sites without the
+               file and never works for baseurl (project-page) deployments.
+  Params:      none — reads the optional `favicon:` block in _config.yml:
+
+               favicon:
+                 ico         : /favicon.ico                    # legacy .ico (default)
+                 svg         : /assets/images/favicon.svg      # scalable icon (optional)
+                 png         : /assets/images/favicon-32.png   # PNG icon (optional)
+                 png_size    : 32x32                           # sizes attr for png (optional)
+                 apple_touch : /assets/images/apple-touch.png  # iOS home-screen icon (optional)
+                 manifest    : /site.webmanifest               # PWA manifest (optional)
+                 theme_color : "#0d1117"                       # browser chrome color (optional)
+
+               With NO config at all this still emits the explicit
+               /favicon.ico link (every consumer site carries one at root),
+               and theme_color falls back to site.theme_color.main so the
+               mobile address bar matches the site's design tokens.
+  Notes:       Page-invariant — safe to render via include_cached. All paths
+               run through relative_url so baseurl deployments resolve.
+{%- endcomment -%}
+{%- assign _fav = site.favicon -%}
+{%- assign _fav_ico = _fav.ico | default: '/favicon.ico' -%}
+<link rel="icon" href="{{ _fav_ico | relative_url }}" sizes="32x32">
+{%- if _fav.svg %}
+<link rel="icon" type="image/svg+xml" href="{{ _fav.svg | relative_url }}">
+{%- endif %}
+{%- if _fav.png %}
+<link rel="icon" type="image/png" href="{{ _fav.png | relative_url }}"{% if _fav.png_size %} sizes="{{ _fav.png_size }}"{% endif %}>
+{%- endif %}
+{%- if _fav.apple_touch %}
+<link rel="apple-touch-icon" href="{{ _fav.apple_touch | relative_url }}">
+{%- endif %}
+{%- if _fav.manifest %}
+<link rel="manifest" href="{{ _fav.manifest | relative_url }}">
+{%- endif %}
+{%- assign _fav_theme_color = _fav.theme_color | default: site.theme_color.main -%}
+{%- if _fav_theme_color %}
+<meta name="theme-color" content="{{ _fav_theme_color }}">
+{%- endif %}

data/_includes/core/footer.html

@@ -22,15 +22,20 @@
   - site.powered_by: Framework and service credits
   - site.links: Social media and affiliate links
   - site.default_icon: Icon framework (Bootstrap Icons)
-  - site.data.ui-text: Internationalization support for RSS label
+  - core/i18n.html: UI strings (per-page language via the `lang` param)
   - Bootstrap 5 classes provided by the theme
-  
+
+  Params:
+  - lang (optional): page language. Root layout renders this include via
+    include_cached, so it MUST pass lang=page.lang for per-language caching.
+
   Notes:
   - Guard optional fields (address/phone/email) to avoid empty output
   - Use relative_url for internal links to respect baseurl
   ===================================================================
 -->
 
+{%- include core/i18n.html lang=include.lang -%}
 <footer class="bd-footer border-top" role="contentinfo">
   {% assign footer_page_urls = site.html_pages | map: "url" | join: "|" | prepend: "|" | append: "|" %}
   <!-- Powered by Row -->
@@ -40,7 +45,7 @@
     </p>
     <div class="footer-powered-by-row">
       <span class="footer-powered-by-label" id="footer-powered-by-label">
-        {{ site.data.ui-text[site.locale].powered_by | default: "Powered by" }}:
+        {{ ui.powered_by | default: "Powered by" }}:
       </span>
       <ul class="footer-powered-by-links list-unstyled mb-0"
           aria-labelledby="footer-powered-by-label">
@@ -197,7 +202,7 @@
               <li class="list-inline-item">
                 <a class="text-light text-decoration-none" href="{{ '/feed.xml' | relative_url }}">
                   <i class="{{ site.default_icon }} bi-rss" aria-hidden="true"></i>
-                  <span class="d-none d-md-inline">{{ site.data.ui-text[site.locale].feed_label | default: "Feed" }}</span>
+                  <span class="d-none d-md-inline">{{ ui.feed_label | default: "Feed" }}</span>
                 </a>
               </li>
             </ul>

data/_includes/core/head.html

@@ -19,6 +19,7 @@
   - seo.html: SEO meta tags and Open Graph data
   - google-analytics.html: Google Analytics tracking
   - google-tag-manager-head.html: GTM head section
+  - posthog.html: PostHog product analytics (opt-in via site.posthog.enabled)
   
   Performance Notes:
   - Scripts loaded in head for immediate availability
@@ -86,6 +87,10 @@ window.MathJax = {
 <meta http-equiv="X-UA-Compatible" content="IE=edge">
 <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
 
+<!-- Favicon + browser identity (config-driven via `favicon:`; explicit
+     /favicon.ico fallback so baseurl deployments resolve) — page-invariant, cached. -->
+{% include_cached core/favicon.html %}
+
 <!-- ================================ -->
 <!-- SEO SUPPLEMENT                  -->
 <!-- ================================ -->
@@ -93,6 +98,10 @@ window.MathJax = {
      Outputs custom og:image with assets_prefix normalisation and non-Google site verification. -->
 {% include content/seo.html %}
 
+<!-- hreflang alternates for machine-generated translations (no-op when the
+     page has none) — see _data/i18n/manifest.yml + scripts/translate.rb -->
+{% include core/hreflang.html %}
+
 <!-- ========================== -->
 <!-- STRUCTURED DATA MARKUP    -->
 <!-- ========================== -->
@@ -127,6 +136,10 @@ window.MathJax = {
 <!-- Only load in production AND when an ID is configured; the include also guards against dev hostnames -->
 {% if jekyll.environment == "production" and site.google_analytics %}{% include analytics/google-analytics.html %}{% endif %}
 
+<!-- PostHog analytics - Configured via the `posthog:` block in _config.yml -->
+<!-- Only load in production AND when explicitly enabled; the include itself also respects Do Not Track -->
+{% if jekyll.environment == "production" and site.posthog.enabled %}{% include analytics/posthog.html %}{% endif %}
+
 
 <!-- ================================ -->
 <!-- CSS FRAMEWORKS AND LIBRARIES   -->
@@ -177,6 +190,11 @@ window.MathJax = {
 <link rel="stylesheet" href="{{ '/assets/css/stats.css' | relative_url }}">
 {% endif %}
 
+<!-- Consumer hook: end of <head>. Inject JSON-LD, font preloads, verification
+     tags, or extra meta by shadowing _includes/custom/head.html in your site —
+     no fork of this file needed. The theme ships the stub empty. -->
+{% include custom/head.html %}
+
 <!-- ========================== -->
 <!-- EXPERIMENTAL FRAMEWORKS   -->
 <!-- ========================== -->

data/_includes/core/header.html

@@ -41,9 +41,11 @@
 <!-- ================================ -->
 <!-- SKIP TO CONTENT LINK            -->
 <!-- ================================ -->
+<!-- UI strings resolve per page language (core/i18n.html sets `ui`) -->
+{%- include core/i18n.html -%}
 <!-- Accessibility: allows keyboard users to skip navigation -->
 <a href="#main-content" class="visually-hidden-focusable position-absolute top-0 start-0 z-3 m-3 btn btn-primary">
-  Skip to main content
+  {{ ui.skip_main_content | default: "Skip to main content" }}
 </a>
 
 <header id="navbar" class="container-fluid text-center fixed-top" role="banner">
@@ -149,17 +151,20 @@
             <!-- UTILITY CONTROLS          -->
             <!-- ========================== -->
             <div class="navbar-utility-controls d-flex align-items-center flex-shrink-0" role="group" aria-label="Utility controls">
+                <!-- Language Toggle (renders only when translation.languages is set) -->
+                {% include components/language-toggle.html %}
+
                 <!-- Search Modal Toggle -->
                 <button
                     class="btn nav-search-button"
                     type="button"
                     data-search-toggle
-                    aria-label="Open search"
+                    aria-label="{{ ui.shortcuts_search | default: 'Open search' }}"
                     aria-haspopup="dialog"
-                    title="Search site content"
+                    title="{{ ui.search_button_label | default: 'Search' }}"
                 >
                     <i class="{{site.default_icon}} bi-search" aria-hidden="true"></i>
-                    <span class="nav-link-text d-none d-xl-inline ms-1">Search</span>
+                    <span class="nav-link-text d-none d-xl-inline ms-1">{{ ui.search_button_label | default: "Search" }}</span>
                 </button>
 
                 <!-- Settings Offcanvas Toggle -->

data/_includes/core/hreflang.html

@@ -0,0 +1,33 @@
+{% comment %} Feature: ZER0-078 {% endcomment %}
+{%- comment -%}
+  Component:   hreflang
+  Path:        _includes/core/hreflang.html
+  Purpose:     Emit <link rel="alternate" hreflang> tags for pages that have
+               machine-generated translations, so search engines associate
+               the English original with its /fr/ (etc.) alternates.
+  Params:      none — reads page.lang / page.translation_source_url and the
+               generated _data/i18n/manifest.yml (scripts/translate.rb).
+  Depends on:  site.translation.* config, site.data.i18n.manifest
+  Notes:       Renders nothing when translation is disabled, the manifest is
+               absent, or the current page has no translations. x-default
+               always points at the English original.
+{%- endcomment -%}
+{%- if site.translation.enabled -%}
+  {%- assign _hl_source = site.translation.source_lang | default: 'en' -%}
+  {%- if page.lang and page.lang != _hl_source -%}
+    {%- assign _hl_src_url = page.translation_source_url -%}
+  {%- else -%}
+    {%- assign _hl_src_url = page.url -%}
+  {%- endif -%}
+  {%- assign _hl_entry = site.data.i18n.manifest.pages[_hl_src_url] -%}
+  {%- if _hl_src_url and _hl_entry %}
+<link rel="alternate" hreflang="{{ _hl_source }}" href="{{ _hl_src_url | absolute_url }}">
+    {%- for _hl_lang in site.translation.languages -%}
+      {%- assign _hl_t = _hl_entry[_hl_lang] -%}
+      {%- if _hl_t %}
+<link rel="alternate" hreflang="{{ _hl_lang }}" href="{{ _hl_t.url | absolute_url }}">
+      {%- endif -%}
+    {%- endfor %}
+<link rel="alternate" hreflang="x-default" href="{{ _hl_src_url | absolute_url }}">
+  {%- endif -%}
+{%- endif -%}

data/_includes/core/i18n.html

@@ -0,0 +1,36 @@
+{% comment %} Feature: ZER0-078 {% endcomment %}
+{%- comment -%}
+  Component:   i18n
+  Path:        _includes/core/i18n.html
+  Purpose:     Resolve the active UI-string set into the `ui` variable,
+               per-page-language aware. English strings come from
+               _data/ui-text.yml (the human-maintained source of truth);
+               alternate languages come from _data/i18n/<lang>.yml, which is
+               GENERATED by scripts/translate.rb — never hand-edited.
+  Params:      lang (string, optional) — overrides page.lang. REQUIRED when
+               the caller is rendered via {% include_cached %} (pass
+               lang=page.lang there) so each language gets its own cache
+               entry instead of sharing one page-invariant render.
+  Depends on:  _data/ui-text.yml, _data/i18n/<lang>.yml (generated),
+               site.translation.* config
+  Notes:       Liquid assigns made inside an include are visible to the
+               caller, so after {% include core/i18n.html %} simply use
+               {{ ui.some_key | default: "English fallback" }}. Missing
+               languages or keys degrade to English/literal defaults.
+{%- endcomment -%}
+{%- comment -%}
+  Resolve using the FULL configured language code (e.g. "fr", "pt-BR"), not a
+  2-char slice: scripts/translate.rb writes _data/i18n/<code>.yml and sets
+  page.lang to that exact code, so a regional code like "pt-BR" must look up
+  site.data.i18n["pt-BR"] — slicing to "pt" would silently miss the file and
+  fall back to English.
+{%- endcomment -%}
+{%- assign _i18n_lang = include.lang | default: page.lang | default: site.translation.source_lang | default: site.locale | default: 'en' -%}
+{%- assign _i18n_source = site.translation.source_lang | default: 'en' -%}
+{%- assign ui = site.data.ui-text[site.locale] | default: site.data.ui-text.en -%}
+{%- unless _i18n_lang == _i18n_source -%}
+  {%- assign _i18n_generated = site.data.i18n[_i18n_lang] -%}
+  {%- if _i18n_generated -%}
+    {%- assign ui = _i18n_generated -%}
+  {%- endif -%}
+{%- endunless -%}

data/_includes/custom/body-end.html

@@ -0,0 +1,18 @@
+{%- comment -%}
+  ===================================================================
+  CUSTOM HOOK — body-end
+  ===================================================================
+
+  Path: _includes/custom/body-end.html
+  Purpose: Consumer extension point rendered as the LAST thing before
+           </body> — after the theme's JS bundle and analytics. Use it
+           for site-specific scripts, third-party widgets, or anything
+           that must load after the theme's JavaScript.
+
+  The theme ships this file EMPTY. Create _includes/custom/body-end.html
+  in YOUR site to shadow this stub. No theme layout needs forking.
+
+  Companion hooks: custom/head.html, custom/body-start.html,
+  custom/footer.html. See _includes/README.md § Custom hooks.
+  ===================================================================
+{%- endcomment -%}

data/_includes/custom/body-start.html

@@ -0,0 +1,17 @@
+{%- comment -%}
+  ===================================================================
+  CUSTOM HOOK — body-start
+  ===================================================================
+
+  Path: _includes/custom/body-start.html
+  Purpose: Consumer extension point rendered immediately AFTER the
+           opening <body> tag — the required position for snippets like
+           Google Tag Manager's <noscript> iframe.
+
+  The theme ships this file EMPTY. Create _includes/custom/body-start.html
+  in YOUR site to shadow this stub. No theme layout needs forking.
+
+  Companion hooks: custom/head.html, custom/footer.html,
+  custom/body-end.html. See _includes/README.md § Custom hooks.
+  ===================================================================
+{%- endcomment -%}

data/_includes/custom/footer.html

@@ -0,0 +1,18 @@
+{%- comment -%}
+  ===================================================================
+  CUSTOM HOOK — footer
+  ===================================================================
+
+  Path: _includes/custom/footer.html
+  Purpose: Consumer extension point rendered directly AFTER the theme
+           footer (and its FAB tail), before the cookie-consent banner.
+           Use it for an extra footer strip, badges, or legal links the
+           theme footer doesn't model.
+
+  The theme ships this file EMPTY. Create _includes/custom/footer.html
+  in YOUR site to shadow this stub. No theme layout needs forking.
+
+  Companion hooks: custom/head.html, custom/body-start.html,
+  custom/body-end.html. See _includes/README.md § Custom hooks.
+  ===================================================================
+{%- endcomment -%}

data/_includes/custom/head.html

@@ -0,0 +1,18 @@
+{%- comment -%}
+  ===================================================================
+  CUSTOM HOOK — head
+  ===================================================================
+
+  Path: _includes/custom/head.html
+  Purpose: Consumer extension point rendered at the END of the theme's
+           <head> (after main.css, tokens-inline, and user-overrides).
+
+  The theme ships this file EMPTY. To inject site-specific markup —
+  structured data (JSON-LD), font preloads, verification tags, extra
+  meta — create _includes/custom/head.html in YOUR site and it will
+  shadow this stub. No theme layout or core include needs forking.
+
+  Companion hooks: custom/body-start.html, custom/footer.html,
+  custom/body-end.html. See _includes/README.md § Custom hooks.
+  ===================================================================
+{%- endcomment -%}

data/_includes/navigation/breadcrumbs.html

@@ -14,7 +14,7 @@
   ===================================================================
 {%- endcomment -%}
 {% if page.url != "/" and site.breadcrumbs %}
-  {%- assign ui = site.data.ui-text[site.locale] | default: site.data.ui-text.en -%}
+  {%- include core/i18n.html -%}
   {%- assign label_root = ui.breadcrumbs_root | default: "Home" -%}
   {%- assign label_aria = ui.breadcrumbs_aria | default: "Breadcrumb" -%}
   {%- assign crumbs = page.url | remove:'/index.html' | split: '/' -%}

data/_includes/navigation/local-graph.html

@@ -23,6 +23,8 @@
   Opt-out: set `local_graph: false` in page front matter.
 
   Configurable depth: `local_graph_depth: 2` in page front matter (default 1).
+  The panel's depth selector (1–3) and incoming/outgoing switches override it
+  per-browser via localStorage (zer0.obsidianLocalGraph.v1).
   ===================================================================
 {%- endcomment -%}
 {%- comment -%} Shared visibility resolver — sets sidebar_enabled {%- endcomment -%}
@@ -63,8 +65,18 @@
           {%- 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>
+      <div class="obsidian-local-graph-meta d-flex flex-wrap align-items-center justify-content-between gap-2 mb-2">
+        <div class="d-flex align-items-center gap-2">
+          <span class="small text-secondary">Depth</span>
+          <div class="btn-group btn-group-sm" role="group" aria-label="Graph depth">
+            {%- for d in (1..3) -%}
+            <input type="radio" class="btn-check" name="obsidianLgDepth"
+                   id="obsidian-lg-depth-{{ d }}" autocomplete="off"
+                   {% if d == lg_depth %}checked{% endif %} />
+            <label class="btn btn-outline-secondary" for="obsidian-lg-depth-{{ d }}">{{ d }}</label>
+            {%- endfor -%}
+          </div>
+        </div>
         {%- if _graph_page -%}
         <a href="{{ _graph_url | relative_url }}"
            class="btn btn-outline-primary btn-sm"
@@ -73,6 +85,20 @@
         </a>
         {%- endif -%}
       </div>
+      <div class="d-flex flex-wrap column-gap-3 mb-2"
+           role="group"
+           aria-label="Link directions shown in the local graph">
+        <div class="form-check form-switch mb-0">
+          <input class="form-check-input" type="checkbox" role="switch"
+                 id="obsidian-lg-outgoing" checked />
+          <label class="form-check-label small" for="obsidian-lg-outgoing">Outgoing</label>
+        </div>
+        <div class="form-check form-switch mb-0">
+          <input class="form-check-input" type="checkbox" role="switch"
+                 id="obsidian-lg-incoming" checked />
+          <label class="form-check-label small" for="obsidian-lg-incoming">Incoming</label>
+        </div>
+      </div>
       <div id="obsidian-local-graph"
            data-depth="{{ lg_depth }}"
            data-index-url="{{ '/assets/data/wiki-index.json' | relative_url }}"

data/_includes/navigation/nav-tree.html

@@ -36,7 +36,7 @@
 <ul class="list-unstyled fw-normal pb-2 small nav-tree-root">
   {% for item in navigation %}
     {% assign item_id = item.title | slugify | prepend: "nav-" %}
-    {% assign is_active = page.url == item.url %}
+    {% assign is_active = false %}{% if page.url == item.url %}{% assign is_active = true %}{% endif %}
     {% assign is_expanded = item.expanded | default: false %}
     {% assign has_children = item.children and item.children.size > 0 %}
     
@@ -78,7 +78,7 @@
           <ul class="list-unstyled fw-normal ps-3 nav-tree-children">
             {% for child in item.children %}
               {% assign child_id = child.title | slugify | prepend: "nav-" %}
-              {% assign child_active = page.url == child.url %}
+              {% assign child_active = false %}{% if page.url == child.url %}{% assign child_active = true %}{% endif %}
               {% assign child_expanded = child.expanded | default: false %}
               {% assign child_has_children = child.children and child.children.size > 0 %}
               
@@ -118,7 +118,7 @@
                   <div class="collapse{% if child_expanded %} show{% endif %}" id="{{ child_id }}">
                     <ul class="list-unstyled fw-normal ps-3 nav-tree-children">
                       {% for grandchild in child.children %}
-                        {% assign gc_active = page.url == grandchild.url %}
+                        {% assign gc_active = false %}{% if page.url == grandchild.url %}{% assign gc_active = true %}{% endif %}
                         <li class="mb-1 nav-tree-item" data-depth="2">
                           {% if grandchild.url %}
                             <a href="{{ grandchild.url | relative_url }}"