jekyll-theme-zer0 1.25.0 → 1.27.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

@@ -12,6 +12,8 @@ Essential layout components that form the foundation of the site:
 - `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/`
 
@@ -40,6 +42,8 @@ Analytics and tracking integrations:
 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

data/_includes/components/README.md

@@ -91,6 +91,7 @@ If a component needs a token that doesn't exist yet, propose it in `_sass/tokens
 | `info-section.html`      | Settings offcanvas — Appearance / Site / Developer.   |
 | `js-cdn.html`            | Body-end script bundle.                               |
 | `search-modal.html`      | Global search modal.                                  |
+| `page-feedback.html`     | "Improve this page" capture widget — request type + live page context + captured console logs → GitHub issue (base prefill + optional AI enrichment). Pairs with `assets/js/page-feedback.js` and `core/console-capture.html`; types from `_data/feedback_types.yml`. |
 
 ## Adding a new component
 

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/env-switcher.html

@@ -132,7 +132,8 @@
       </div>
     </li>
 
-    <!-- Development URL -->
+    {% unless is_production %}
+    <!-- Development URL (dev builds only — never leak localhost into production HTML) -->
     <li class="list-group-item d-flex justify-content-between align-items-center gap-2">
       <div class="d-flex align-items-center min-w-0">
         <span class="badge bg-warning text-dark me-2">Dev</span>
@@ -162,6 +163,7 @@
         </button>
       </div>
     </li>
+    {% endunless %}
 
     {% if site.repository %}
     <!-- GitHub Source -->

data/_includes/components/language-toggle.html

@@ -0,0 +1,81 @@
+{% comment %} Feature: ZER0-078 {% endcomment %}
+{%- comment -%}
+  Component:   language-toggle
+  Path:        _includes/components/language-toggle.html
+  Purpose:     Navbar dropdown that switches between the English original and
+               its machine-generated translations (scripts/translate.rb).
+               Shows the source language plus every configured target
+               language; targets without a generated translation for the
+               current page render as disabled entries.
+  Params:      none — reads page.lang / page.url / page.translation_source_url
+               and the generated _data/i18n/manifest.yml.
+  Depends on:  site.translation.* config, site.data.i18n.manifest,
+               _data/i18n/languages.yml (display names), core/i18n.html,
+               Bootstrap 5 dropdown, Bootstrap Icons (bi-translate)
+  Notes:       Renders nothing when translation is disabled or no target
+               languages are configured. The chosen language is remembered in
+               localStorage("zer0-lang") for future UX (no auto-redirect).
+               Must NOT be include_cached — the menu is page-dependent.
+{%- endcomment -%}
+{%- assign _lt_langs = site.translation.languages -%}
+{%- if site.translation.enabled and _lt_langs and _lt_langs.size > 0 -%}
+{%- include core/i18n.html -%}
+{%- assign _lt_source = site.translation.source_lang | default: 'en' -%}
+{%- assign _lt_current = page.lang | default: _lt_source -%}
+{%- if _lt_current == _lt_source -%}
+  {%- assign _lt_src_url = page.url -%}
+{%- else -%}
+  {%- assign _lt_src_url = page.translation_source_url -%}
+{%- endif -%}
+{%- assign _lt_entry = site.data.i18n.manifest.pages[_lt_src_url] -%}
+{%- assign _lt_names = site.data.i18n.languages -%}
+{%- assign _lt_source_name = _lt_names[_lt_source].native | default: _lt_source -%}
+<div class="dropdown nav-lang-toggle" id="zer0-lang-toggle">
+    <button
+        class="btn nav-lang-button dropdown-toggle"
+        type="button"
+        id="langToggleButton"
+        data-bs-toggle="dropdown"
+        aria-expanded="false"
+        aria-label="{{ ui.lang_toggle_aria | default: 'Change language' }}"
+        title="{{ ui.lang_toggle_label | default: 'Language' }}"
+    >
+        <i class="{{ site.default_icon }} bi-translate" aria-hidden="true"></i>
+        <span class="nav-link-text d-none d-xl-inline ms-1 text-uppercase">{{ _lt_current | slice: 0, 2 }}</span>
+    </button>
+    <ul class="dropdown-menu dropdown-menu-end" aria-labelledby="langToggleButton">
+        <li>
+            {%- if _lt_current == _lt_source %}
+            <span class="dropdown-item active" aria-current="true">{{ _lt_source_name }}</span>
+            {%- else %}
+            <a class="dropdown-item" data-lang="{{ _lt_source }}" hreflang="{{ _lt_source }}" href="{{ _lt_src_url | default: '/' | relative_url }}">{{ _lt_source_name }}</a>
+            {%- endif %}
+        </li>
+        {%- for _lt_lang in _lt_langs -%}
+        {%- assign _lt_name = _lt_names[_lt_lang].native | default: _lt_lang -%}
+        {%- assign _lt_t = _lt_entry[_lt_lang] %}
+        <li>
+            {%- if _lt_current == _lt_lang %}
+            <span class="dropdown-item active" aria-current="true">{{ _lt_name }}</span>
+            {%- elsif _lt_t %}
+            <a class="dropdown-item" data-lang="{{ _lt_lang }}" hreflang="{{ _lt_lang }}" href="{{ _lt_t.url | relative_url }}">{{ _lt_name }}</a>
+            {%- else %}
+            <span class="dropdown-item disabled" aria-disabled="true" title="{{ ui.lang_not_available | default: 'Not yet translated' }}">{{ _lt_name }} <small class="text-body-secondary">({{ ui.lang_not_available | default: 'Not yet translated' }})</small></span>
+            {%- endif %}
+        </li>
+        {%- endfor %}
+    </ul>
+</div>
+<script>
+  // Remember the visitor's language pick (no auto-redirect — just preference).
+  (function () {
+    var toggle = document.getElementById('zer0-lang-toggle');
+    if (!toggle) return;
+    toggle.addEventListener('click', function (event) {
+      var item = event.target.closest('a.dropdown-item[data-lang]');
+      if (!item) return;
+      try { localStorage.setItem('zer0-lang', item.getAttribute('data-lang')); } catch (e) { /* private mode */ }
+    });
+  })();
+</script>
+{%- endif -%}