datalog-theme 0.9.2 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e78d28d83ac0a0f18ae06135f8d07b0523f4b1669bfe838cf7cb146a77c54307
-  data.tar.gz: 2f75e9074b965a7edfd417194145ad50ed44a03aa93d789d86ddde7ae4a7a5ec
+  metadata.gz: 5b74bf15f89adfc2aa62c676c096602c7831b07e44398fd0968d91da7f86bfb4
+  data.tar.gz: 1f696c0c8858b68c1433256bccafd16873d9f1e7dd93458e4d6264cd87218965
 SHA512:
-  metadata.gz: 00f97bd9e578136be77bffc0aa079ad80d9498a8f7becce2162d7ca948920b32fe8387e0f977f6a404a05d5c7a0960dad84f915fefe07ee2844b9d36fb7a5351
-  data.tar.gz: 469a1d9ec77a2e9379979fb392a0bd2d6888516742931599bb8fa3457375a17ec85b7b3d322b8d72018129999b7dda91e7123b6fc906eef5e8fddc4c1d952311
+  metadata.gz: dfd30ca2e0683df45f6db2fa03feafeac691e1f79defbda412e380510b746dab12d4a7abd97882c81d54290641c9a0fe1f939dd88a468fb9388a1aeaa0d7e350
+  data.tar.gz: ff0175b85f72ae03c61a71629b2c0890d440d46591bdf1bcf31e0b0a4df92d6ccea7185e5cec891fb934d7098717900a35fb8ac7bc58e9b124e84dab5ef57a11

data/CHANGELOG.md

@@ -2,6 +2,43 @@
 
 All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.10.0] - 2026-09-21
+
+### Upgrading from 0.9.x
+
+Three changes need an edit on a site that upgrades:
+
+- **`components/search-facets.html` is gone.** A site that includes it will not build. Remove the include; the search page's own application covers the same ground, with tests.
+- **The installation panel's id is the package's**, `install-<package-name>`, where it was `installation`. A link or a stylesheet that pointed at `#installation` should point at the new id — or at the page's own `## Installation` heading, which still carries that id where the Markdown has one.
+- **`package-docs__main` is a `<div>`, not a `<main>`.** The page already had a `main` landmark from the default layout, and two is one too many. A selector written as `main.package-docs__main` needs the tag dropped.
+
+Two more to know about, neither needing an edit:
+
+- `datalog new post` slugifies the way Jekyll does, so a new post with an accented title is filed under a different name than 0.9.x would have given it: `analise-de-series-temporais`, not `an-lise-de-s-ries-temporais`. Posts already published are untouched.
+- A site holding its own copy of `components/enhanced-toc.html` keeps that copy's inline script, and now also loads the contents module in the core bundle. Take the `<script>` block out of the copy, or drop the copy and use the theme's.
+
+### Added
+
+- Translations for the breadcrumbs, the footer headings, the remaining sharing buttons and the Packages menu entry, in English, Spanish and Portuguese.
+
+### Removed
+
+- `components/search-facets.html`, which no layout or page included, no stylesheet styled, and whose script would have thrown on load. The search page's own application (`assets/js/search/`) is the one that indexes posts, code and math, offers facets and is covered by tests (#341).
+
+### Fixed
+
+- Name the equation editor's LaTeX box and tie it to the description beside it. The dialog's title named the dialog, not the box, so a screen reader met an unlabelled multiline text box — and the editor is built into every page that loads MathJax, where an accessibility sweep finds it.
+- Put the site's `baseurl` in front of every bundle in the script manifest the loader reads, and in the 404 page's search form, so a site served from a subdirectory runs its JavaScript instead of importing paths at the domain root (#328).
+- Read MathJax's expressions as a list that can be iterated, so equation numbering, the copy and edit tools, the reference map and the `role="math"` labels reach a typeset page at all. Leave the number to MathJax where it numbers, rather than drawing a second one beside it, and keep the tools out of the element that carries the maths role (#329).
+- Name a scaffolded post after its title, accents and all: `datalog new post` now slugifies the way Jekyll does, so "Análise de Séries Temporais" becomes `analise-de-series-temporais` rather than `an-lise-de-s-ries-temporais`, a title in a script no transliteration covers keeps its own characters, and a title the console tagged as something other than UTF-8 no longer raises (#333).
+- Stop `datalog update` where `npm install` fails, instead of reporting that the theme's dependencies are up to date (#333).
+- Let the browser follow a table-of-contents link instead of intercepting it, so an entry for a numbered heading reaches its section, the heading clears the sticky header by its own scroll margin, and the keyboard carries on from there. The contents now ship as a module in the core bundle: the reading position is measured from the viewport, the progress indicator reports a number rather than `NaN` on a short article, the current entry is marked with `aria-current`, and the percentage no longer sits in a live region that announced every scroll (#330).
+- Ask for the translations the theme already ships. The header's search box, brand link and toggles, the primary navigation's labels and descriptions, the breadcrumbs, the sharing buttons, the contents heading and the footer's headings now read from `_data/i18n`, so a site in Spanish or Portuguese is no longer an English chrome around translated articles. `{% t %}` accepts a variable holding a key, which is how `_data/navigation.yml` names one per entry, and a key the data names but no locale defines falls back to the literal beside it instead of printing the key (#331).
+- Give the installation panel real tab semantics, so the arrow keys move between pip, conda and Git, the selected one is announced, and each panel is named by its tab. Its id is the package's rather than `installation`, which a page's own heading already had; its buttons carry a type; its labels are translated; and it copies through the core bundle's copy button instead of a second clipboard implementation. The tab labels meet the AA contrast ratio (#332).
+- Fall back to the older copy route where the clipboard API is unavailable or refused, and let a template pass the words shown after a copy (#332).
+- Give package pages a dark mode. The package stylesheet had no dark rules at all, so its panels stayed white on a dark page and everything layered on them followed: 421 axe contrast failures in dark mode, 103 in light. Its surfaces, inks and borders now read from the theme's own tokens, the tinted admonitions carry an ink that pairs with their tint in each mode, and a highlighted example no longer sits on a forced dark background that fought the light Rouge palette (#342).
+- Name the version selector on a package page, take the second `main` landmark out of the package layout, start the sidebar's section titles at the level after the page title, and let the keyboard reach an API signature that scrolls sideways (#342).
+
 ## [0.9.2] - 2026-09-20
 
 ### Fixed

data/CITATION.cff

@@ -16,8 +16,8 @@ abstract: >-
   It offers integrated notebook publishing, advanced math rendering, interactive
   visualization workflows, and reproducibility tooling optimised for open science communities.
 license: MIT
-version: 0.9.2
-date-released: 2026-09-20
+version: 0.10.0
+date-released: 2026-09-21
 keywords:
   - data-science
   - jekyll

data/README.md

@@ -208,7 +208,7 @@ Data-driven configuration allows you to publish or reorder projects, datasets, s
 Add the theme gem to your Jekyll site:
 
 ```ruby
-gem "datalog-theme", "~> 0.9.0"
+gem "datalog-theme", "~> 0.10.0"
 ```
 
 The constraint takes the patch releases of the current minor series. Until 1.0 a minor release may include breaking changes, listed in the [changelog](CHANGELOG.md).

data/_data/i18n/en.yml

@@ -96,6 +96,9 @@ navigation:
     visualizations:
       title: Visualizations
       description: Plotly, D3, and Observable notebooks
+    packages:
+      title: Packages
+      description: Software packages, libraries, and tools
     academic:
       title: Academic Ops
       description: Citation metrics, submissions, and collaboration hub
@@ -475,6 +478,7 @@ post:
     many: "{{minutes}} mins read"
   difficulty_default: Intermediate
   toc_heading: On this page
+  toc_toggle: Toggle table of contents
   notebook:
     open_external: Open Jupyter Notebook
     download: Download Jupyter Notebook
@@ -484,6 +488,11 @@ post:
     twitter: Share on X (Twitter)
     linkedin: Share on LinkedIn
     reddit: Discuss on Reddit
+    facebook: Share on Facebook
+    email: Share via email
+    copy_link: Copy link to clipboard
+    email_label: Email
+    copy_link_label: Copy link
   interactive:
     label: Interactive resources
     launch: Launch demo
@@ -693,6 +702,11 @@ project:
     last_commit: "Last commit {{commit}}."
     view_latest: View latest revision
 footer:
+  explore: Explore
+  connect: Connect
+  stay_updated: Stay updated
+  rss_description: Follow via RSS or check back for new research and tutorials.
+  rss_feed: RSS feed
   heading: Site footer
   about_title: "About {{site}}"
   orcid_label: "ORCID: {{id}}"
@@ -757,3 +771,17 @@ analytics:
       users: Users
       new_users: New users
       page_views: Page views
+breadcrumbs:
+  label: Breadcrumb
+  home: Home
+  blog: Blog
+  portfolio: Portfolio
+  datasets: Datasets
+  notebooks: Notebooks
+package_install:
+  title: Installation
+  terminal: Terminal
+  r_console: R Console
+  copy: Copy
+  copied: Copied!
+  copy_error: Could not copy

data/_data/i18n/es.yml

@@ -96,6 +96,9 @@ navigation:
     visualizations:
       title: Visualizaciones
       description: Plotly, D3 y notebooks de Observable
+    packages:
+      title: Paquetes
+      description: Paquetes de software, bibliotecas y herramientas
     academic:
       title: Operaciones académicas
       description: Métricas de citación, envíos y colaboración
@@ -475,6 +478,7 @@ post:
     many: "Lectura de {{minutes}} min"
   difficulty_default: Intermedio
   toc_heading: En esta página
+  toc_toggle: Mostrar u ocultar el índice
   notebook:
     open_external: Abrir notebook de Jupyter
     download: Descargar notebook de Jupyter
@@ -484,6 +488,11 @@ post:
     twitter: Compartir en X (Twitter)
     linkedin: Compartir en LinkedIn
     reddit: Debatir en Reddit
+    facebook: Compartir en Facebook
+    email: Compartir por correo
+    copy_link: Copiar el enlace
+    email_label: Correo
+    copy_link_label: Copiar enlace
   interactive:
     label: Recursos interactivos
     launch: Iniciar demostración
@@ -693,6 +702,11 @@ project:
     last_commit: "Último commit {{commit}}."
     view_latest: Ver revisión más reciente
 footer:
+  explore: Explorar
+  connect: Contacto
+  stay_updated: Mantente al día
+  rss_description: Sigue el RSS o vuelve para ver nuevas investigaciones y tutoriales.
+  rss_feed: Fuente RSS
   heading: Pie de página
   about_title: "Acerca de {{site}}"
   orcid_label: "ORCID: {{id}}"
@@ -757,3 +771,17 @@ analytics:
       users: Usuarios
       new_users: Usuarios nuevos
       page_views: Vistas de página
+breadcrumbs:
+  label: Ruta de navegación
+  home: Inicio
+  blog: Blog
+  portfolio: Portafolio
+  datasets: Conjuntos de datos
+  notebooks: Cuadernos
+package_install:
+  title: Instalación
+  terminal: Terminal
+  r_console: Consola de R
+  copy: Copiar
+  copied: ¡Copiado!
+  copy_error: No se pudo copiar

data/_data/i18n/pt.yml

@@ -96,6 +96,9 @@ navigation:
     visualizations:
       title: Visualizações
       description: Plotly, D3 e notebooks Observable
+    packages:
+      title: Pacotes
+      description: Pacotes de software, bibliotecas e ferramentas
     academic:
       title: Operações académicas
       description: Métricas de citação, submissões e colaboração
@@ -475,6 +478,7 @@ post:
     many: "Leitura de {{minutes}} min"
   difficulty_default: Intermédio
   toc_heading: Nesta página
+  toc_toggle: Mostrar ou ocultar o índice
   notebook:
     open_external: Abrir notebook Jupyter
     download: Transferir notebook Jupyter
@@ -484,6 +488,11 @@ post:
     twitter: Partilhar no X (Twitter)
     linkedin: Partilhar no LinkedIn
     reddit: Discutir no Reddit
+    facebook: Partilhar no Facebook
+    email: Partilhar por email
+    copy_link: Copiar a ligação
+    email_label: Email
+    copy_link_label: Copiar ligação
   interactive:
     label: Recursos interativos
     launch: Iniciar demonstração
@@ -693,6 +702,11 @@ project:
     last_commit: "Último commit {{commit}}."
     view_latest: Ver revisão mais recente
 footer:
+  explore: Explorar
+  connect: Contacto
+  stay_updated: Fique a par
+  rss_description: Siga o RSS ou volte para ver novas investigações e tutoriais.
+  rss_feed: Fonte RSS
   heading: Rodapé do site
   about_title: "Sobre {{site}}"
   orcid_label: "ORCID: {{id}}"
@@ -757,3 +771,17 @@ analytics:
       users: Usuários
       new_users: Novos usuários
       page_views: Visualizações de página
+breadcrumbs:
+  label: Caminho de navegação
+  home: Início
+  blog: Blog
+  portfolio: Portefólio
+  datasets: Conjuntos de dados
+  notebooks: Cadernos
+package_install:
+  title: Instalação
+  terminal: Terminal
+  r_console: Consola do R
+  copy: Copiar
+  copied: Copiado!
+  copy_error: Não foi possível copiar

data/_includes/components/api-function.html

@@ -19,7 +19,7 @@ Parameters:
       <code>{{ include.name }}</code>
     </h3>
     {% if include.signature %}
-      <pre class="api-function__signature"><code>{{ include.signature }}</code></pre>
+      <pre class="api-function__signature" tabindex="0"><code>{{ include.signature }}</code></pre>
     {% endif %}
   </div>
 

data/_includes/components/breadcrumbs.html

@@ -9,12 +9,12 @@ Parameters:
 {%- assign show_current = include.show_current | default: true -%}
 {%- assign separator = include.separator | default: " / " -%}
 
-<nav class="breadcrumbs" aria-label="Breadcrumb">
+<nav class="breadcrumbs" aria-label="{% t 'breadcrumbs.label' %}">
   <ol class="breadcrumbs__list" itemscope itemtype="https://schema.org/BreadcrumbList">
     {%- comment -%} Home link {%- endcomment -%}
     <li class="breadcrumbs__item" itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
       <a href="{{ '/' | relative_url }}" class="breadcrumbs__link" itemprop="item">
-        <span itemprop="name">Home</span>
+        <span itemprop="name">{% t 'breadcrumbs.home' %}</span>
       </a>
       <meta itemprop="position" content="1" />
       <span class="breadcrumbs__separator" aria-hidden="true">{{ separator }}</span>
@@ -27,7 +27,7 @@ Parameters:
         {%- when 'posts' -%}
           <li class="breadcrumbs__item" itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
             <a href="{{ '/blog' | relative_url }}" class="breadcrumbs__link" itemprop="item">
-              <span itemprop="name">Blog</span>
+              <span itemprop="name">{% t 'breadcrumbs.blog' %}</span>
             </a>
             <meta itemprop="position" content="{{ position }}" />
             <span class="breadcrumbs__separator" aria-hidden="true">{{ separator }}</span>
@@ -35,7 +35,7 @@ Parameters:
         {%- when 'portfolio' -%}
           <li class="breadcrumbs__item" itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
             <a href="{{ '/portfolio' | relative_url }}" class="breadcrumbs__link" itemprop="item">
-              <span itemprop="name">Portfolio</span>
+              <span itemprop="name">{% t 'breadcrumbs.portfolio' %}</span>
             </a>
             <meta itemprop="position" content="{{ position }}" />
             <span class="breadcrumbs__separator" aria-hidden="true">{{ separator }}</span>
@@ -43,7 +43,7 @@ Parameters:
         {%- when 'datasets' -%}
           <li class="breadcrumbs__item" itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
             <a href="{{ '/datasets' | relative_url }}" class="breadcrumbs__link" itemprop="item">
-              <span itemprop="name">Datasets</span>
+              <span itemprop="name">{% t 'breadcrumbs.datasets' %}</span>
             </a>
             <meta itemprop="position" content="{{ position }}" />
             <span class="breadcrumbs__separator" aria-hidden="true">{{ separator }}</span>
@@ -51,7 +51,7 @@ Parameters:
         {%- when 'notebooks' -%}
           <li class="breadcrumbs__item" itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
             <a href="{{ '/notebooks' | relative_url }}" class="breadcrumbs__link" itemprop="item">
-              <span itemprop="name">Notebooks</span>
+              <span itemprop="name">{% t 'breadcrumbs.notebooks' %}</span>
             </a>
             <meta itemprop="position" content="{{ position }}" />
             <span class="breadcrumbs__separator" aria-hidden="true">{{ separator }}</span>

data/_includes/components/enhanced-toc.html

@@ -73,7 +73,7 @@ Parameters:
            aria-hidden="true">
         <polyline points="6 9 12 15 18 9"></polyline>
       </svg>
-      <span class="visually-hidden">Toggle table of contents</span>
+      <span class="visually-hidden">{% t 'post.toc_toggle' %}</span>
     </button>
     {%- endif -%}
   </div>
@@ -82,127 +82,11 @@ Parameters:
     {{ toc_markup }}
   </div>
 
-  <div class="enhanced-toc__stats" aria-live="polite">
+  <div class="enhanced-toc__stats">
     <span class="enhanced-toc__reading-progress" data-reading-progress>
-      <span class="visually-hidden">Reading progress: </span>
+      <span class="visually-hidden">{% t 'header.reading_progress' %} </span>
       <span data-progress-percent>0</span>% complete
     </span>
   </div>
 </nav>
-
-<script>
-  (function() {
-    'use strict';
-
-    document.addEventListener('DOMContentLoaded', function() {
-      const toc = document.querySelector('[data-toc-enhanced]');
-      if (!toc) return;
-
-      const tocContent = toc.querySelector('.enhanced-toc__content');
-      const tocLinks = toc.querySelectorAll('.enhanced-toc__content a');
-      const tocToggle = toc.querySelector('[data-toc-toggle]');
-      const progressBar = toc.querySelector('[data-toc-progress]');
-      const progressPercent = toc.querySelector('[data-progress-percent]');
-
-      // Collapsible functionality
-      if (tocToggle) {
-        tocToggle.addEventListener('click', function() {
-          const isExpanded = tocToggle.getAttribute('aria-expanded') === 'true';
-          tocToggle.setAttribute('aria-expanded', !isExpanded);
-          tocContent.hidden = isExpanded;
-          toc.classList.toggle('is-collapsed', isExpanded);
-        });
-      }
-
-      // Get all headings that are in the TOC
-      const headings = Array.from(document.querySelectorAll('.post-content h2[id], .post-content h3[id], .post-content h4[id]'));
-
-      if (headings.length === 0) return;
-
-      // Scroll spy - highlight active section
-      function updateActiveLink() {
-        const scrollPosition = window.scrollY + 100; // Offset for better UX
-
-        let currentHeading = null;
-        for (let i = headings.length - 1; i >= 0; i--) {
-          if (headings[i].offsetTop <= scrollPosition) {
-            currentHeading = headings[i];
-            break;
-          }
-        }
-
-        tocLinks.forEach(link => {
-          link.classList.remove('is-active');
-          if (currentHeading && link.getAttribute('href') === '#' + currentHeading.id) {
-            link.classList.add('is-active');
-          }
-        });
-      }
-
-      // Reading progress
-      function updateProgress() {
-        const windowHeight = window.innerHeight;
-        const documentHeight = document.documentElement.scrollHeight;
-        const scrollTop = window.scrollY;
-        const trackLength = documentHeight - windowHeight;
-        const percentScrolled = Math.floor((scrollTop / trackLength) * 100);
-
-        if (progressBar) {
-          progressBar.style.width = percentScrolled + '%';
-        }
-        if (progressPercent) {
-          progressPercent.textContent = percentScrolled;
-        }
-      }
-
-      // Scroll to TOC targets. The stylesheet's scroll-behavior decides whether
-      // the scroll is smooth, so reduced-motion preferences are respected.
-      tocLinks.forEach(link => {
-        link.addEventListener('click', function(e) {
-          const targetId = this.getAttribute('href');
-          if (targetId && targetId.startsWith('#')) {
-            e.preventDefault();
-            const targetElement = document.querySelector(targetId);
-            if (targetElement) {
-              const offsetTop = targetElement.offsetTop - 80; // Account for sticky header
-              window.scrollTo({ top: offsetTop });
-              // Update URL without jumping
-              if (history.pushState) {
-                history.pushState(null, null, targetId);
-              }
-            }
-          }
-        });
-      });
-
-      // Throttle scroll events for performance
-      let scrollTimeout;
-      function throttledScroll() {
-        if (scrollTimeout) {
-          window.cancelAnimationFrame(scrollTimeout);
-        }
-        scrollTimeout = window.requestAnimationFrame(function() {
-          updateActiveLink();
-          updateProgress();
-        });
-      }
-
-      window.addEventListener('scroll', throttledScroll, { passive: true });
-
-      // Initial update
-      updateActiveLink();
-      updateProgress();
-
-      // Make TOC sticky on scroll
-      const tocTop = toc.offsetTop;
-      window.addEventListener('scroll', function() {
-        if (window.scrollY > tocTop - 20) {
-          toc.classList.add('is-sticky');
-        } else {
-          toc.classList.remove('is-sticky');
-        }
-      }, { passive: true });
-    });
-  })();
-</script>
 {%- endif -%}