jekyll-theme-zer0 1.26.0 → 1.28.0

data/_data/ui-text.yml

@@ -1,6 +1,16 @@
-# User interface text and labels
-# Used by: Various includes and layouts throughout the theme
-# Purpose: Multilingual UI strings for internationalization (i18n)
+# User interface text and labels — ENGLISH SOURCE OF TRUTH
+# Used by: _includes/core/i18n.html (and through it, layouts/includes)
+#
+# Multilingual model (ZER0-078): this file holds ONLY the English strings.
+# Alternate languages are NOT hand-maintained here anymore — they are
+# machine-generated into _data/i18n/<lang>.yml by scripts/translate.rb
+# (Claude Code OAuth) via .github/workflows/translate.yml. To change a
+# translated label, edit the English string here and let the translate
+# workflow regenerate the alternates. Languages are configured under
+# `translation.languages` in _config.yml.
+#
+# (The former hand-written es/fr/de/ar blocks were removed in favor of the
+# generated pipeline — see docs/systems/multilingual-translation.md.)
 
 # English (default)
 # -----------------
@@ -8,6 +18,7 @@ en: &DEFAULT_EN
   skip_links                 : "Skip links"
   skip_primary_nav           : "Skip to primary navigation"
   skip_content               : "Skip to content"
+  skip_main_content          : "Skip to main content"
   skip_footer                : "Skip to footer"
   page                       : "Page"
   pagination_previous        : "Previous"
@@ -79,7 +90,28 @@ en: &DEFAULT_EN
   shortcuts_toggle_sidebar   : "Toggle sidebar"
   shortcuts_toggle_toc       : "Toggle table of contents"
   shortcuts_show_help        : "Show this help"
-  
+  # Header / navbar chrome (ZER0-078)
+  home_label                 : "Home"
+  main_nav_label             : "Main Navigation"
+  search_button_label        : "Search"
+  settings_button_label      : "Settings"
+  toc_title                  : "Table of Contents"
+  # Article intro / metadata chrome (ZER0-078)
+  published_label            : "Published"
+  updated_label              : "Updated"
+  reading_time_label         : "Estimated reading time:"
+  reading_time_minute        : "minute"
+  share_label                : "Share"
+  copy_link_label            : "Copy Link"
+  improve_label              : "Improve"
+  edit_on_github             : "Edit on GitHub"
+  # Language toggle & machine translation (ZER0-078)
+  lang_toggle_label          : "Language"
+  lang_toggle_aria           : "Change language"
+  lang_not_available         : "Not yet translated"
+  machine_translation_notice : "This page was translated automatically from the English original."
+  machine_translation_view_source : "View the original"
+
 en-US:
   <<: *DEFAULT_EN
 en-CA:
@@ -88,245 +120,3 @@ en-GB:
   <<: *DEFAULT_EN
 en-AU:
   <<: *DEFAULT_EN
-
-# Spanish
-# -------
-es: &DEFAULT_ES
-  skip_links                 : "Saltar enlaces"
-  skip_primary_nav           : "Saltar a navegación principal"
-  skip_content               : "Saltar a contenido"
-  skip_footer                : "Saltar a pie"
-  page                       : "Página"
-  pagination_previous        : "Anterior"
-  pagination_next            : "Siguiente"
-  breadcrumb_home_label      : "Inicio"
-  breadcrumb_separator       : "/"
-  menu_label                 : "Alternar menú"
-  search_label               : "Alternar búsqueda"
-  toc_label                  : "En esta página"
-  ext_link_label             : "Enlace directo"
-  less_than                  : "menos de"
-  minute_read                : "minuto(s) de lectura"
-  share_on_label             : "Compartir en"
-  meta_label                 :
-  tags_label                 : "Etiquetas:"
-  categories_label           : "Categorías:"
-  date_label                 : "Actualizado:"
-  author_label               : "Autor:"
-  comments_label             : "Deja un comentario"
-  comments_title             : "Comentarios"
-  more_label                 : "Ver más"
-  related_label              : "Puede que también te interese"
-  follow_label               : "Seguir:"
-  feed_label                 : "Feed"
-  powered_by                 : "Funciona con"
-  website_label              : "Sitio web"
-  email_label                : "Correo electrónico"
-  recent_posts               : "Entradas recientes"
-  undefined_wpm              : "El parámetro words_per_minute (palabras por minuto) no está definido en _config.yml"
-  comment_form_info          : "Tu dirección de correo electrónico no se publicará. Los campos obligatorios están marcados"
-  comment_form_comment_label : "Comentario"
-  comment_form_md_info       : "Puedes utilizar Markdown"
-  comment_form_name_label    : "Nombre"
-  comment_form_email_label   : "Dirección de correo electrónico"
-  comment_form_website_label : "Sitio web (opcional)"
-  comment_btn_submit         : "Enviar comentario"
-  comment_btn_submitted      : "Enviado"
-  comment_success_msg        : "¡Gracias por tu comentario! Se mostrará en el sitio una vez que haya sido aprobado."
-  comment_error_msg          : "Lo sentimos, ha habido un error con tu envío. Por favor, asegúrate de que todos los campos obligatorios se han completado e inténtalo de nuevo."
-  loading_label              : "Cargando..."
-  search_label_text          : "Introduce tu término de búsqueda..."
-  search_placeholder_text    : "Introduce tu término de búsqueda..."
-  search_no_results          : "Sin resultados"
-  results_found              : "Resultado(s) encontrado(s)"
-  back_to_top                : "Volver arriba"
-  # Statistics labels
-  stats_total_posts          : "Total de Publicaciones"
-  stats_total_pages          : "Total de Páginas"
-  stats_categories           : "Categorías"
-  stats_tags                 : "Etiquetas"
-  stats_last_updated         : "Última Actualización"
-  stats_overview             : "Resumen"
-  stats_content_breakdown    : "Desglose de Contenido"
-  # Theme-specific labels
-  theme_toggle               : "Cambiar tema"
-  dark_mode                  : "Modo oscuro"
-  light_mode                 : "Modo claro"
-  view_source                : "Ver código fuente"
-  edit_page                  : "Editar esta página"
-  report_issue               : "Reportar un problema"
-
-es-ES:
-  <<: *DEFAULT_ES
-es-MX:
-  <<: *DEFAULT_ES
-
-# French
-# ------
-fr: &DEFAULT_FR
-  skip_links                 : "Liens de saut"
-  skip_primary_nav           : "Aller à la navigation principale"
-  skip_content               : "Aller au contenu"
-  skip_footer                : "Aller au pied de page"
-  page                       : "Page"
-  pagination_previous        : "Précédent"
-  pagination_next            : "Suivant"
-  breadcrumb_home_label      : "Accueil"
-  breadcrumb_separator       : "/"
-  menu_label                 : "Basculer le menu"
-  search_label               : "Basculer la recherche"
-  toc_label                  : "Sur cette page"
-  ext_link_label             : "Lien direct"
-  less_than                  : "moins de"
-  minute_read                : "minute(s) de lecture"
-  share_on_label             : "Partager sur"
-  meta_label                 :
-  tags_label                 : "Tags :"
-  categories_label           : "Catégories :"
-  date_label                 : "Mis à jour :"
-  author_label               : "Auteur :"
-  comments_label             : "Laisser un commentaire"
-  comments_title             : "Commentaires"
-  more_label                 : "En savoir plus"
-  related_label              : "Vous pourriez aussi aimer"
-  follow_label               : "Suivre :"
-  feed_label                 : "Flux"
-  powered_by                 : "Propulsé par"
-  website_label              : "Site web"
-  email_label                : "Email"
-  recent_posts               : "Articles récents"
-  back_to_top                : "Retour en haut"
-  # Statistics labels
-  stats_total_posts          : "Total des Publications"
-  stats_total_pages          : "Total des Pages"
-  stats_categories           : "Catégories"
-  stats_tags                 : "Tags"
-  stats_last_updated         : "Dernière Mise à Jour"
-  stats_overview             : "Aperçu"
-  stats_content_breakdown    : "Répartition du Contenu"
-  # Theme-specific labels
-  theme_toggle               : "Changer de thème"
-  dark_mode                  : "Mode sombre"
-  light_mode                 : "Mode clair"
-  view_source                : "Voir la source"
-  edit_page                  : "Modifier cette page"
-  report_issue               : "Signaler un problème"
-
-fr-FR:
-  <<: *DEFAULT_FR
-fr-CA:
-  <<: *DEFAULT_FR
-
-# German
-# ------
-de: &DEFAULT_DE
-  skip_links                 : "Links überspringen"
-  skip_primary_nav           : "Zur Hauptnavigation springen"
-  skip_content               : "Zum Inhalt springen"
-  skip_footer                : "Zur Fußzeile springen"
-  page                       : "Seite"
-  pagination_previous        : "Zurück"
-  pagination_next            : "Weiter"
-  breadcrumb_home_label      : "Startseite"
-  breadcrumb_separator       : "/"
-  menu_label                 : "Menü umschalten"
-  search_label               : "Suche umschalten"
-  toc_label                  : "Auf dieser Seite"
-  ext_link_label             : "Direktlink"
-  less_than                  : "weniger als"
-  minute_read                : "Minute(n) Lesezeit"
-  share_on_label             : "Teilen auf"
-  meta_label                 :
-  tags_label                 : "Tags:"
-  categories_label           : "Kategorien:"
-  date_label                 : "Aktualisiert:"
-  author_label               : "Autor:"
-  comments_label             : "Einen Kommentar hinterlassen"
-  comments_title             : "Kommentare"
-  more_label                 : "Mehr erfahren"
-  related_label              : "Das könnte Sie auch interessieren"
-  follow_label               : "Folgen:"
-  feed_label                 : "Feed"
-  powered_by                 : "Betrieben mit"
-  website_label              : "Webseite"
-  email_label                : "E-Mail"
-  recent_posts               : "Neueste Beiträge"
-  back_to_top                : "Nach oben"
-  # Statistics labels
-  stats_total_posts          : "Gesamte Beiträge"
-  stats_total_pages          : "Gesamte Seiten"
-  stats_categories           : "Kategorien"
-  stats_tags                 : "Tags"
-  stats_last_updated         : "Zuletzt Aktualisiert"
-  stats_overview             : "Übersicht"
-  stats_content_breakdown    : "Inhaltsaufschlüsselung"
-  # Theme-specific labels
-  theme_toggle               : "Thema wechseln"
-  dark_mode                  : "Dunkler Modus"
-  light_mode                 : "Heller Modus"
-  view_source                : "Quelle ansehen"
-  edit_page                  : "Diese Seite bearbeiten"
-  report_issue               : "Ein Problem melden"
-
-de-DE:
-  <<: *DEFAULT_DE
-de-AT:
-  <<: *DEFAULT_DE
-de-CH:
-  <<: *DEFAULT_DE
-
-# Arabic
-# ------
-ar: &DEFAULT_AR
-  skip_links                 : "تخطي الروابط"
-  skip_primary_nav           : "انتقل إلى التنقل الرئيسي"
-  skip_content               : "انتقل إلى المحتوى"
-  skip_footer                : "انتقل إلى التذييل"
-  page                       : "صفحة"
-  pagination_previous        : "السابق"
-  pagination_next            : "التالي"
-  breadcrumb_home_label      : "الرئيسية"
-  breadcrumb_separator       : "/"
-  menu_label                 : "تبديل القائمة"
-  search_label               : "تبديل البحث"
-  toc_label                  : "في هذه الصفحة"
-  ext_link_label             : "رابط مباشر"
-  less_than                  : "أقل من"
-  minute_read                : "دقيقة للقراءة"
-  share_on_label             : "مشاركة على"
-  meta_label                 :
-  tags_label                 : "الوسوم:"
-  categories_label           : "الأقسام:"
-  date_label                 : "تاريخ التحديث:"
-  author_label               : "الكاتب:"
-  comments_label             : "اترك تعليقاً"
-  comments_title             : "التعليقات"
-  more_label                 : "اقرأ المزيد"
-  related_label              : "قد يعجبك أيضاً"
-  follow_label               : "تابعنا:"
-  feed_label                 : "الخلاصة"
-  powered_by                 : "يعمل بواسطة"
-  website_label              : "الموقع"
-  email_label                : "البريد الإلكتروني"
-  recent_posts               : "المنشورات الأخيرة"
-  back_to_top                : "العودة للأعلى"
-  # Statistics labels
-  stats_total_posts          : "إجمالي المنشورات"
-  stats_total_pages          : "إجمالي الصفحات"
-  stats_categories           : "الأقسام"
-  stats_tags                 : "الوسوم"
-  stats_last_updated         : "آخر تحديث"
-  stats_overview             : "نظرة عامة"
-  stats_content_breakdown    : "تفصيل المحتوى"
-  # Theme-specific labels
-  theme_toggle               : "تبديل المظهر"
-  dark_mode                  : "الوضع الداكن"
-  light_mode                 : "الوضع الفاتح"
-  view_source                : "عرض المصدر"
-  edit_page                  : "تحرير هذه الصفحة"
-  report_issue               : "الإبلاغ عن مشكلة"
-
-ar-SA:
-  <<: *DEFAULT_AR
-ar-EG:
-  <<: *DEFAULT_AR

data/_includes/README.md

@@ -9,9 +9,12 @@ This directory has been reorganized for better maintainability and clarity. File
 Essential layout components that form the foundation of the site:
 
 - `head.html` - HTML document head with meta tags, scripts, and styles
+- `favicon.html` - Favicon / browser-identity tags (icon links, apple-touch, manifest, theme-color) driven by the optional `favicon:` config block
 - `header.html` - Main site header with navigation
 - `footer.html` - Site footer (if exists)
 - `branding.html` - Site branding and title display
+- `i18n.html` - Resolves the per-page-language UI-string set into the `ui` variable (generated translations fall back to English)
+- `hreflang.html` - `<link rel="alternate" hreflang>` tags for pages with machine-generated translations
 
 ### `navigation/`
 
@@ -32,14 +35,16 @@ All navigation-related components:
 Analytics and tracking integrations:
 
 - `google-analytics.html` - Google Analytics tracking
-- `google-tag-manager-head.html` - GTM head section
-- `google-tag-manager-body.html` - GTM body section
+- `google-tag-manager-head.html` - GTM head section (emits nothing unless `google_tag_manager:` is set in `_config.yml`)
+- `google-tag-manager-body.html` - GTM body section (same config gate)
 
 ### `components/`
 
 Reusable UI components and widgets:
 
 - `searchbar.html` - Deprecated search stub (superseded by `search-modal.html`)
+- `language-toggle.html` - Navbar dropdown switching between the English original and its machine-generated translations
+- `translation-notice.html` - Disclosure banner on machine-translated pages linking back to the English original
 - `powered-by.html` - "Powered by" credits display
 - `quick-index.html` - Quick page index
 - `dev-shortcuts.html` - Developer shortcuts
@@ -51,6 +56,13 @@ Reusable UI components and widgets:
 - `js-cdn.html` - CDN JavaScript libraries
 - `preview-image.html` - Consistent preview image rendering with lazy loading
 - `post-card.html` - Reusable post card component for listings
+- `data-card.html` - One generic card rendered from a plain data hash (title/url/icon/badge/meta/buttons schema in its header)
+- `card-grid.html` - Responsive grid of `data-card`s from any data array — hub dashboards, fleet registries, service grids
+- `bookshelf.html` - Grid of every book in the `books` collection (home-page library)
+- `book-card.html` - One book's portrait cover card (bookshelf tile)
+- `book-toc.html` - Ordered story/chapter list for one book
+- `book-nav.html` - Prev/next-story + contents navigation inside a book
+- `book-plate.html` - Full-width illustration figure with optional caption for story pages
 
 ### `content/`
 
@@ -75,6 +87,17 @@ Documentation and reference materials:
 
 - `bootstrap-docs.html` - Bootstrap documentation (moved from style.html)
 
+### `custom/` — consumer extension hooks
+
+Empty stubs the theme includes at fixed points in the page chrome. A consumer site creates a file at the same path to inject markup there — **no fork of `root.html`, `head.html`, or `footer.html` needed**, so theme updates keep flowing without merge drift:
+
+- `custom/head.html` - end of `<head>` (JSON-LD, font preloads, verification tags, extra meta)
+- `custom/body-start.html` - immediately after `<body>` (e.g. GTM `<noscript>`)
+- `custom/footer.html` - after the theme footer, before the cookie-consent banner
+- `custom/body-end.html` - last thing before `</body>` (site scripts, third-party widgets)
+
+The stubs ship empty (comment-only) and render nothing until shadowed.
+
 ## Usage
 
 When including files in layouts or other templates, use the full path:

data/_includes/analytics/google-tag-manager-body.html

@@ -1,9 +1,18 @@
 {% comment %} Feature: ZER0-039 {% endcomment %}
+{%- comment -%}
+  Component:   google-tag-manager-body
+  Path:        _includes/analytics/google-tag-manager-body.html
+  Purpose:     Google Tag Manager noscript fallback (body section). Config-driven:
+               emits nothing unless the site sets a container ID.
+  Params:      none — reads `google_tag_manager: "<container-id>"` from _config.yml
+  Depends on:  google-tag-manager-head.html (loader)
+{%- endcomment -%}
+{%- if site.google_tag_manager -%}
 <!-- Google Tag Manager (noscript) -->
     <noscript>
-        <iframe src="https://www.googletagmanager.com/ns.html?id=GTM-NN8P7RZ" 
+        <iframe src="https://www.googletagmanager.com/ns.html?id={{ site.google_tag_manager }}"
                 height="0" width="0" style="display:none;visibility:hidden">
         </iframe>
     </noscript>
 <!-- End Google Tag Manager (noscript) -->
-<!-- source https://tagmanager.google.com/#/admin/accounts/6005859084/containers/58386588/install?containerDraftId=2 -->
+{%- endif -%}

data/_includes/analytics/google-tag-manager-head.html

@@ -1,8 +1,17 @@
 {% comment %} Feature: ZER0-039 {% endcomment %}
-<!-- 
-  title: Google Tag Manager 
-  file: 
--->
+{%- comment -%}
+  Component:   google-tag-manager-head
+  Path:        _includes/analytics/google-tag-manager-head.html
+  Purpose:     Google Tag Manager loader (head section). Config-driven: emits
+               nothing unless the site sets a container ID, so consumer sites
+               never inherit this theme's own GTM container.
+  Params:      none — reads `google_tag_manager: "<container-id>"` from _config.yml
+  Depends on:  google-tag-manager-body.html (optional noscript counterpart)
+  Notes:       Previously the container ID was hardcoded, silently enrolling
+               every consumer site's production build into the theme owner's
+               GTM container. Set your own ID (or leave unset for no GTM).
+{%- endcomment -%}
+{%- if site.google_tag_manager -%}
 <script>
     // Skip GTM on local/dev hostnames even if a prod build is served locally (Docker/CI preview).
     (function () {
@@ -13,7 +22,8 @@
         new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
         j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
         'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
-        })(window,document,'script','dataLayer','GTM-NN8P7RZ');
+        })(window,document,'script','dataLayer','{{ site.google_tag_manager }}');
     })();
     </script>
-    <!-- End Google Tag Manager -->
+    <!-- End Google Tag Manager -->
+{%- endif -%}

data/_includes/analytics/posthog.html

@@ -64,6 +64,9 @@ Privacy: Respects Do Not Track and provides opt-out mechanisms
     capturePageleave: {{ site.posthog.capture_pageleave | default: true }},
     disableCookie: {{ site.posthog.disable_cookie | default: false }},
     respectDnt: {{ site.posthog.respect_dnt | default: true }},
+    respectGpc: {{ site.posthog.privacy.respect_gpc | default: true }},
+    requireConsent: {{ site.posthog.privacy.require_consent | default: false }},
+    geoipDisable: {{ site.posthog.privacy.geoip_disable | default: false }},
     crossSubdomainCookie: {{ site.posthog.cross_subdomain_cookie | default: false }},
     secureCookie: {{ site.posthog.secure_cookie | default: true }},
     persistence: '{{ site.posthog.persistence | default: "localStorage+cookie" }}',
@@ -74,9 +77,28 @@ Privacy: Respects Do Not Track and provides opt-out mechanisms
     }
   };
 
-  {% comment %} Check for Do Not Track before loading {% endcomment %}
-  if (window.posthogConfig.respectDnt && navigator.doNotTrack === '1') {
-    console.log('PostHog: Respecting Do Not Track setting');
+  {% comment %} Consent gate (privacy.require_consent): until the visitor
+     accepts the "analytics" category in the theme's cookie-consent banner
+     (localStorage "zer0-cookie-consent"), PostHog starts opted OUT with
+     memory-only persistence — no cookies, nothing stored. The banner's
+     applyConsent() flips opt-in/opt-out live once a choice is made. {% endcomment %}
+  window.__phHasAnalyticsConsent = true;
+  if (window.posthogConfig.requireConsent) {
+    window.__phHasAnalyticsConsent = false;
+    try {
+      var __phStored = window.localStorage.getItem('zer0-cookie-consent');
+      if (__phStored) {
+        var __phConsent = JSON.parse(__phStored);
+        window.__phHasAnalyticsConsent = __phConsent && __phConsent.analytics === true;
+      }
+    } catch (e) { /* localStorage unavailable — stay opted out */ }
+  }
+
+  {% comment %} Honor browser privacy signals before loading: Do Not Track
+     and Global Privacy Control (GPC is a legal signal under CCPA/CPRA). {% endcomment %}
+  if ((window.posthogConfig.respectDnt && navigator.doNotTrack === '1') ||
+      (window.posthogConfig.respectGpc && window.navigator.globalPrivacyControl === true)) {
+    console.log('PostHog: respecting browser privacy signal (DNT/GPC)');
   } else {
     {% comment %} PostHog Loading Script {% endcomment %}
     !function(t,e){var o,n,p,r;e.__SV||(window.posthog && window.posthog.__loaded)||(window.posthog=e,e._i=[],e.init=function(i,s,a){function g(t,e){var o=e.split(".");2==o.length&&(t=t[o[0]],e=o[1]),t[e]=function(){t.push([e].concat(Array.prototype.slice.call(arguments,0)))}}(p=t.createElement("script")).type="text/javascript",p.crossOrigin="anonymous",p.async=!0,p.src=s.api_host.replace(".i.posthog.com","-assets.i.posthog.com")+"/static/array.js",(r=t.getElementsByTagName("script")[0]).parentNode.insertBefore(p,r);var u=e;for(void 0!==a?u=e[a]=[]:a="posthog",u.people=u.people||[],u.toString=function(t){var e="posthog";return"posthog"!==a&&(e+="."+a),t||(e+=" (stub)"),e},u.people.toString=function(){return u.toString(1)+".people (stub)"},o="init Rr Mr fi Or Ar ci Tr Cr capture Mi calculateEventProperties Lr register register_once register_for_session unregister unregister_for_session Hr getFeatureFlag getFeatureFlagPayload isFeatureEnabled reloadFeatureFlags updateEarlyAccessFeatureEnrollment getEarlyAccessFeatures on onFeatureFlags onSurveysLoaded onSessionId getSurveys getActiveMatchingSurveys renderSurvey displaySurvey canRenderSurvey canRenderSurveyAsync identify setPersonProperties group resetGroups setPersonPropertiesForFlags resetPersonPropertiesForFlags setGroupPropertiesForFlags resetGroupPropertiesForFlags reset get_distinct_id getGroups get_session_id get_session_replay_url alias set_config startSessionRecording stopSessionRecording sessionRecordingStarted captureException loadToolbar get_property getSessionProperty Ur jr createPersonProfile zr kr Br opt_in_capturing opt_out_capturing has_opted_in_capturing has_opted_out_capturing get_explicit_consent_status is_capturing clear_opt_in_out_capturing Dr debug M Nr getPageViewId captureTraceFeedback captureTraceMetric $r".split(" "),n=0;n<o.length;n++)g(u,o[n]);e._i.push([i,s,a])},e.__SV=1)}(document,window.posthog||[]);
@@ -91,7 +113,8 @@ Privacy: Respects Do Not Track and provides opt-out mechanisms
       disable_cookie: window.posthogConfig.disableCookie,
       cross_subdomain_cookie: window.posthogConfig.crossSubdomainCookie,
       secure_cookie: window.posthogConfig.secureCookie,
-      persistence: window.posthogConfig.persistence,
+      persistence: window.__phHasAnalyticsConsent ? window.posthogConfig.persistence : 'memory',
+      opt_out_capturing_by_default: !window.__phHasAnalyticsConsent,
       session_recording: window.posthogConfig.sessionRecording,
       {% if site.posthog.privacy.ip_anonymization %}
       ip: false,
@@ -100,6 +123,12 @@ Privacy: Respects Do Not Track and provides opt-out mechanisms
         {% comment %} PostHog loaded successfully {% endcomment %}
         console.log('PostHog analytics loaded successfully');
 
+        {% comment %} privacy.geoip_disable: stop PostHog from resolving
+           IP to location on every event {% endcomment %}
+        if (window.posthogConfig.geoipDisable) {
+          posthog.register({ '$geoip_disable': true });
+        }
+
         {% comment %} Track Jekyll-specific page properties {% endcomment %}
         posthog.register({
           'site_title': '{{ site.title }}',

data/_includes/components/abc-letter.html

@@ -0,0 +1,43 @@
+{% comment %} Feature: ZER0-081 {% endcomment %}
+{%- comment -%}
+  Component:   abc-letter
+  Path:        _includes/components/abc-letter.html
+  Purpose:     One card of an ABC board book — the illustration (or a friendly
+               "coming soon" placeholder), a big letter badge, the word, and the
+               read-aloud tagline. Rendered once per `alphabet:` entry by
+               _layouts/book-abc.html.
+  Params:      entry (hash, required) — an alphabet entry with keys:
+               letter, word, tagline, image, alt, status ("planned"|"rendered")
+  Depends on:  components/preview-image.html,
+               _sass/components/_book.scss (.abc-letter, .abc-letter-*)
+  Notes:       The big letter is HTML typography, never baked into the art (so
+               raster models never garble it). A `status: planned` entry (no
+               rendered plate yet) shows a coloured placeholder tile instead of
+               a broken image, so the book reads end-to-end before any art runs.
+{%- endcomment -%}
+{%- if include.entry == nil -%}
+  {%- comment -%} ERROR: abc-letter requires `entry` {%- endcomment -%}
+{%- else -%}
+{%- assign _e = include.entry -%}
+{%- assign _letter = _e.letter -%}
+{%- comment -%} A plate counts as rendered only when it has an image AND is not
+    still "planned". Branch inline: Liquid's assign does not reliably apply the
+    "not-equals" comparison, so the condition lives in the if-tag below. {%- endcomment -%}
+<article class="abc-letter" id="letter-{{ _letter | downcase }}">
+  <div class="abc-letter-plate">
+    {%- if _e.image and _e.status != "planned" -%}
+      {%- include components/preview-image.html src=_e.image alt=_e.alt class="abc-letter-img" loading="lazy" -%}
+    {%- else -%}
+      <div class="abc-letter-placeholder" role="img" aria-label="{{ _e.alt | default: _e.word | escape }} — illustration coming soon">
+        <span class="abc-letter-glyph" aria-hidden="true">{{ _letter }}</span>
+        <span class="abc-letter-planned">illustration coming soon</span>
+      </div>
+    {%- endif -%}
+    <span class="abc-letter-badge" aria-hidden="true">{{ _letter }}</span>
+  </div>
+  <p class="abc-letter-word">{{ _e.word }}</p>
+  {%- if _e.tagline -%}
+  <p class="abc-letter-tagline">{{ _e.tagline }}</p>
+  {%- endif -%}
+</article>
+{%- endif -%}

data/_includes/components/author-avatar-url.html

@@ -10,7 +10,9 @@
      reference an external avatar, e.g. a GitHub one:
      avatar: "https://avatars.githubusercontent.com/u/10567847?v=4"
   2. `avatar` is a relative path (e.g. /images/authors/me.png) — prefixed with
-     the site's assets path ({{ site.baseurl }}/{{ site.public_folder }}).
+     the site's public_folder and passed through relative_url, so baseurl is
+     applied and the slashes never double into a protocol-relative //… URL
+     (even when public_folder and/or baseurl are empty or unset).
   3. No `avatar`, but a `github` handle is set — falls back to that account's
      GitHub avatar: https://github.com/<handle>.png
   4. Otherwise — empty output (the caller renders a fallback icon).
@@ -22,7 +24,7 @@
 {%- endcomment -%}
 {%- assign _avatar = include.data.avatar -%}
 {%- if _avatar and _avatar != "" -%}
-  {%- if _avatar contains "://" -%}{{ _avatar }}{%- else -%}{{ site.baseurl }}/{{ site.public_folder }}{{ _avatar }}{%- endif -%}
+  {%- if _avatar contains "://" -%}{{ _avatar }}{%- else -%}{%- capture _avatar_path -%}/{{ site.public_folder }}{{ _avatar }}{%- endcapture -%}{{ _avatar_path | replace: "//", "/" | relative_url }}{%- endif -%}
 {%- elsif include.data.github and include.data.github != "" -%}
 https://github.com/{{ include.data.github }}.png
 {%- endif -%}

data/_includes/components/book-card.html

@@ -0,0 +1,42 @@
+{% comment %} Feature: ZER0-080 {% endcomment %}
+{%- comment -%}
+  Component:   book-card
+  Path:        _includes/components/book-card.html
+  Purpose:     Bookshelf card for one book — portrait cover, title, subtitle,
+               chapter count, and audience badge, linking to the book page.
+  Params:      book (document, required) — a `books` collection doc with
+               `layout: book` (the book's landing page)
+  Depends on:  components/preview-image.html,
+               _sass/components/_book.scss (.book-card, .book-cover-frame)
+  Notes:       Chapter count is derived live from the collection so the card
+               never goes stale. Whole card is one link for a big tap target.
+{%- endcomment -%}
+{%- if include.book == nil -%}
+  {%- comment -%} ERROR: book-card requires `book` {%- endcomment -%}
+{%- else -%}
+{%- assign _book = include.book -%}
+{%- assign _slug = _book.book | default: _book.slug -%}
+{%- assign _is_abc = _book.layout == "book-abc" -%}
+{%- assign _chapters = site.books | where: "book", _slug | where_exp: "doc", "doc.chapter" -%}
+{%- assign _cover = _book.cover_image | default: _book.preview | default: site.teaser -%}
+<article class="book-card h-100">
+  <a href="{{ _book.url | relative_url }}" class="d-block text-decoration-none text-body h-100">
+    <div class="book-cover-frame mb-3">
+      {%- include components/preview-image.html src=_cover alt=_book.title class="" -%}
+    </div>
+    <h3 class="h5 mb-1">{{ _book.title }}</h3>
+    {%- if _book.subtitle -%}
+    <p class="text-body-secondary small mb-2">{{ _book.subtitle }}</p>
+    {%- endif -%}
+    <p class="small text-body-secondary mb-0">
+      {%- if _is_abc -%}
+      {%- assign _letters = _book.alphabet | size -%}
+      <i class="bi bi-type me-1" aria-hidden="true"></i>{{ _letters }} {% if _letters == 1 %}letter{% else %}letters{% endif %}
+      {%- else -%}
+      <i class="bi bi-book me-1" aria-hidden="true"></i>{{ _chapters.size }} {% if _chapters.size == 1 %}story{% else %}stories{% endif %}
+      {%- endif -%}
+      {%- if _book.audience %} <span class="mx-1" aria-hidden="true">•</span> {{ _book.audience }}{% endif -%}
+    </p>
+  </a>
+</article>
+{%- endif -%}