Telar v1.5.1

Telar v1.5.1

Patch release: glossary auto-linking fixes.

Versión en español abajo

Fixes

Glossary links in story step text
The [[term]] syntax now creates a glossary link when written in a story step's answer text, not only inside layer panels. Previously the brackets published as plain text. The question line is a heading and is intentionally left as plain text.

Case-insensitive glossary terms
[[Term]], [[term]], and [[TERM]] now all resolve to the same glossary entry, matching whatever id the glossary defines — so an acronym written [[IIIF]] links correctly.

Migration

Automated upgrade from v1.5.0:

1. Go to your repository's Actions tab
2. Select the "Upgrade Telar" workflow
3. Click "Run workflow"
4. Review the upgrade issue and merge the pull request

No manual steps required — your site picks up the fix automatically the next time it builds (GitHub Pages), or after a local rebuild.

Documentation

• Documentation: https://telar.org/docs
• Example Site: https://ampl.clair.ucsb.edu/telar
• Report Issues: https://github.com/UCSB-AMPLab/telar/issues

Acknowledgments

Telar is developed by Adelaida Ávila, Juan Cobo Betancourt, Natalie Cobo, Santiago Muñoz, and students and scholars at the UCSB Archives, Memory, and Preservation Lab, the UT Archives, Mapping, and Pedagogy Lab, and Neogranadina.

We gratefully acknowledge the support of the Caribbean Digital Scholarship Collective, the Center for Innovative Teaching, Research, and Learning (CITRAL) at the University of California, Santa Barbara, the UCSB Library, the Routes of Enslavement in the Americas University of California MRPI, and the Department of History of The University of Texas at Austin.

---

Español

Versión de parche: correcciones en los enlaces de glosario.

Correcciones

Enlaces de glosario en el texto del paso
La sintaxis [[término]] ahora crea un enlace de glosario cuando se escribe en la respuesta de un paso, no solo dentro de los paneles. Antes, los corchetes se publicaban como texto plano. La pregunta es un encabezado y se deja como texto plano a propósito.

Términos sin distinción de mayúsculas
[[Término]], [[término]] y [[TÉRMINO]] ahora resuelven a la misma entrada del glosario, sin importar cómo esté definido el id — así, una sigla escrita [[IIIF]] enlaza correctamente.

Migración

Actualización automática desde v1.5.0:

1. Ve a la pestaña Actions de tu repositorio
2. Selecciona el flujo de trabajo "Upgrade Telar"
3. Haz clic en "Run workflow"
4. Revisa el issue de actualización y fusiona el pull request

No requiere pasos manuales: tu sitio aplica la corrección automáticamente la próxima vez que se construye (GitHub Pages), o tras una reconstrucción local.

Documentación

• Documentación: https://telar.org/guia
• Sitio de ejemplo: https://ampl.clair.ucsb.edu/telar
• Reportar problemas: https://github.com/UCSB-AMPLab/telar/issues

Agradecimientos

Telar es desarrollado por Adelaida Ávila, Juan Cobo Betancourt, Natalie Cobo, Santiago Muñoz, y estudiantes e investigadores del UCSB Archives, Memory, and Preservation Lab, el UT Archives, Mapping, and Pedagogy Lab, y Neogranadina.

Agradecemos el apoyo del Caribbean Digital Scholarship Collective, el Center for Innovative Teaching, Research, and Learning (CITRAL) de la University of California, Santa Barbara, la UCSB Library, el Routes of Enslavement in the Americas University of California MRPI, y el Departamento de Historia de la Universidad de Texas en Austin.

---

Release Date: 2026-06-10
Previous Version: v1.5.0

Telar v1.5.0 — Robustness & Security

Telar v1.5.0 — Robustness & Security

Runtime and tooling hardening with no content changes: existing stories, objects, and
configuration keep working unchanged. The automatic upgrade applies everything except
two manual steps.

Security

• Author content is escaped at every render sink (Python build and JavaScript runtime); widget autoescaping enabled
• TLS certificate verification restored on all Google Sheets and IIIF fetches
• Protected stories: the build stops instead of shipping plaintext when a story can't be encrypted; PBKDF2 100k → 210k; no byline/description/SEO leak; the unlock cache no longer stores decrypted content
• Hardened upgrade workflow: tooling is downloaded as a checksum-verified release asset and run in isolation
• KaTeX constrained to safe links; path-traversal guards and caps on all remote reads

Changes

• WaveSurfer is vendored (no CDN) so audio works offline
• Framework files install atomically; migrations chain strictly and stop on any error
• Dependency floors raised (pandas, markdown, cryptography, pytest, pytest-cov)

Fixes

• IIIF plate stays visible on same-object navigation; consistent panel handling; deep-link timers cancelled on interaction
• YouTube and Google Drive video sizing; audio and scroll-engine lifecycle
• Story steps render in step-number order; theme button text is visible again

Migration

Migration v140_to_v150.py upgrades automatically from v1.4.0. Two manual steps after upgrading:

1. Hand-update the two GitHub Actions workflow files (upgrade.yml, build.yml) — GitHub doesn't allow the automated upgrade to modify workflows. Your site keeps building if you skip this; these changes only harden your workflows.
2. Re-apply any customizations to the language packs (en.yml / es.yml).

See the CHANGELOG for full details.

Acknowledgments

Telar is developed by Adelaida Ávila, Juan Cobo Betancourt, Natalie Cobo, Santiago Muñoz, and students and scholars at the UCSB Archives, Memory, and Preservation Lab, the UT Archives, Mapping, and Pedagogy Lab, and Neogranadina.

We gratefully acknowledge the support of the Caribbean Digital Scholarship Collective, the Center for Innovative Teaching, Research, and Learning (CITRAL) at the University of California, Santa Barbara, the UCSB Library, the Routes of Enslavement in the Americas University of California MRPI, and the Department of History of The University of Texas at Austin.

---

Telar v1.5.0 — Robustez y seguridad

Refuerzo del motor y las herramientas, sin cambios de contenido: las historias, los
objetos y la configuración que ya tienes siguen funcionando igual. La actualización
automática aplica todo salvo dos pasos manuales.

Seguridad

• El contenido de autoría se escapa en cada punto de salida (construcción en Python y ejecución en JavaScript); se activó el autoescape en los widgets
• Se restauró la verificación de certificados TLS en todas las descargas de Google Sheets e IIIF
• Historias protegidas: si una historia no se puede cifrar, la construcción se detiene en vez de publicarla sin cifrar; PBKDF2 pasa de 100.000 a 210.000 iteraciones; ya no se filtran autoría, descripción ni metadatos de SEO; la caché de desbloqueo dejó de guardar contenido descifrado
• Flujo de actualización más seguro: las herramientas se descargan como un recurso verificado con su suma de control y se ejecutan de forma aislada
• KaTeX queda limitado a enlaces seguros; barreras contra el path traversal y límites en todas las lecturas remotas

Cambios

• WaveSurfer ahora va incluido en el sitio (sin CDN), así el audio funciona sin conexión
• Los archivos del marco se instalan de forma atómica; las migraciones se encadenan de forma estricta y se detienen ante cualquier error
• Se subieron las versiones mínimas de las dependencias (pandas, markdown, cryptography, pytest, pytest-cov)

Correcciones

• La imagen IIIF se mantiene visible al navegar entre pasos del mismo objeto; manejo de paneles más coherente; los temporizadores de enlaces directos se cancelan al interactuar
• Tamaño de los videos de YouTube y Google Drive; ciclo de vida del audio y del motor de desplazamiento
• Los pasos de las historias se muestran en el orden de su número; el texto de los botones de tema vuelve a verse

Migración

La migración v140_to_v150.py actualiza automáticamente desde v1.4.0. Dos pasos manuales después de actualizar:

1. Actualizar a mano los dos archivos de flujo de trabajo de GitHub Actions (upgrade.yml, build.yml) — GitHub no permite que la actualización automática modifique los flujos de trabajo. Tu sitio sigue construyéndose si te saltas este paso; estos cambios solo refuerzan tus flujos de trabajo.
2. Volver a aplicar las personalizaciones de los paquetes de idioma (en.yml / es.yml).

Consulta el CHANGELOG para todos los detalles.

Agradecimientos

Telar es desarrollado por Adelaida Ávila, Juan Cobo Betancourt, Natalie Cobo, Santiago Muñoz, y estudiantes e investigadores del UCSB Archives, Memory, and Preservation Lab, el UT Archives, Mapping, and Pedagogy Lab, y Neogranadina.

Agradecemos el apoyo del Caribbean Digital Scholarship Collective, el Center for Innovative Teaching, Research, and Learning (CITRAL) de la University of California, Santa Barbara, la UCSB Library, el Routes of Enslavement in the Americas University of California MRPI, y el Departamento de Historia de la Universidad de Texas en Austin.

Telar v1.4.0 — Responsive System & Cross-Device Centering

Runtime upgrade — no action required. Existing stories, objects, and site configuration work unchanged. There are no content migration steps.

What's new

Cross-device image centering fixed

The focal-point algorithm has been rewritten from the ground up. Previously, depending on the device and viewport size, images could drift off-center, clip near the bottom at high zoom, or pin incorrectly on iPad in portrait orientation.

This was the largest piece of work in the release. Rather than eyeball it, we measured — down to the pixel — where each authored focal point actually landed versus where it was meant to land, across many screen sizes, both orientations, and three separate test environments: automated browsers, Safari on iPhone and iPad, and a live desktop browser. Those measurements drove a complete rewrite of the centering algorithm, which now derives a device-independent focal radius from the aspect ratio each story was authored at, so the framed subject stays put across phones, tablets, and desktops. To keep it that way, the corrected geometry is locked in by unit tests that run in continuous integration on every change to the centering code.

Lighter and faster

Tify, the previous IIIF image viewer, has been replaced by a custom viewer built on OpenSeadragon 6.0.2 — the same viewer used by the Telar Compositor. The swap removes the Tify CDN load and its Vue dependency: Tify's ~529 KB payload (469 KB of JavaScript plus 60 KB of CSS) gives way to a 337 KB OpenSeadragon build — about 190 KB less viewer code. The viewer now loads from a vendored local file, eliminating the CDN dependency entirely. Existing IIIF stories and objects are unaffected; the viewer API is compatible.

iOS Safari stability and safe-area support

Layout heights now use dvh (with a vh fallback), which prevents the reflow that occurred when the Safari URL bar appeared or disappeared on scroll. Notch safe-area clearance has also been applied to the credits badge, mobile navigation buttons, and the mobile text card, verified on iPhone in both portrait and landscape orientations.

Other improvements

• Touch-device hover fix: hover styles no longer stick on touch devices — all :hover rules are now guarded by @media (hover: hover) and (pointer: fine).
• Reduced-motion support: smooth scrolling and IIIF pan/zoom animations are disabled when prefers-reduced-motion is active.
• CSS cascade cleanup: Bootstrap is now loaded inside a cascade layer, removing the need for over 150 !important overrides across the Telar stylesheets.
• Breakpoints recalibrated: the vertical layout now activates at widths narrower than 1024px or aspect ratios narrower than 3:4, giving better coverage for tablets in portrait orientation.

Upgrading

Upgrading is automated through GitHub. In your site's repository, open the Actions tab and run the Upgrade Telar workflow: it detects your current version and opens a pull request with the changes for you to review and merge. Because v1.4.0 is a runtime upgrade with no content migration, there are no manual steps — your existing stories render unchanged. For the full walkthrough, see Upgrading Telar.

Acknowledgments

Telar is developed by Adelaida Ávila, Juan Cobo Betancourt, Natalie Cobo, Santiago Muñoz, and students and scholars at the UCSB Archives, Memory, and Preservation Lab, the UT Archives, Mapping, and Pedagogy Lab, and Neogranadina.

We gratefully acknowledge the support of the Caribbean Digital Scholarship Collective, the Center for Innovative Teaching, Research, and Learning (CITRAL) at the University of California, Santa Barbara, the UCSB Library, the Routes of Enslavement in the Americas University of California MRPI, and the Department of History of The University of Texas at Austin.

---

Español

Actualización de Telar, sin pasos de migración. Las historias, los objetos y la configuración del sitio siguen funcionando igual. No hay que migrar ningún contenido.

Novedades

Centrado de imágenes corregido en todos los dispositivos

Reescribimos por completo el algoritmo del punto focal. Antes, según el dispositivo y el tamaño de la ventana, las imágenes podían quedar mal centradas, cortarse cerca del borde inferior al ampliarlas mucho, o anclarse de forma incorrecta en el iPad en orientación vertical.

Fue el trabajo más grande de esta versión. En lugar de ajustar el centrado a ojo, medimos —al píxel— dónde caía realmente cada punto focal frente a dónde debía caer, en muchos tamaños de pantalla, en las dos orientaciones y en tres entornos distintos: navegadores automatizados, Safari en iPhone y iPad, y un navegador de escritorio en vivo. Con esas mediciones reescribimos el algoritmo de centrado desde cero: ahora calcula un radio focal independiente del dispositivo a partir de la relación de aspecto con la que se creó cada historia, así el sujeto encuadrado se mantiene bien centrado en teléfonos, tabletas y computadores de escritorio. Y para que siga así, protegemos esa geometría con pruebas unitarias que se ejecutan en la integración continua con cada cambio del código de centrado.

Más liviano y más rápido

Reemplazamos el visor IIIF anterior, Tify, por un visor propio basado en OpenSeadragon 6.0.2 — el mismo que usa el Compositor de Telar. Así eliminamos la descarga de Tify desde un CDN y su dependencia de Vue: el paquete de Tify, de unos 529 KB (469 KB de JavaScript más 60 KB de CSS), da paso a OpenSeadragon, de 337 KB — unos 190 KB menos de código de visor. Ahora el visor se carga desde un archivo local del repositorio, sin depender de ningún CDN. Mantiene la misma interfaz, así que las historias y los objetos IIIF que ya tienes siguen funcionando sin cambios.

Estabilidad en Safari para iOS y compatibilidad con el área segura

Las alturas del diseño ahora usan dvh (con vh como alternativa), lo que elimina el salto del diseño que ocurría cuando la barra de direcciones de Safari aparecía o se ocultaba al desplazarse. Además, aplicamos la separación de área segura para la muesca en la insignia de créditos, los botones de navegación en móvil y la tarjeta de texto en móvil, y lo verificamos en iPhone en orientación vertical y horizontal.

Otras mejoras

• Corrección de estilos hover en pantallas táctiles: los estilos :hover ya no quedan activos al tocar la pantalla: ahora envolvemos todas las reglas en @media (hover: hover) and (pointer: fine).
• Compatibilidad con movimiento reducido: desactivamos el desplazamiento suave y las animaciones de panorámica y zoom del visor IIIF cuando prefers-reduced-motion está activo.
• Limpieza de la cascada CSS: ahora cargamos Bootstrap dentro de una capa de cascada, lo que nos permitió eliminar más de 150 declaraciones !important en las hojas de estilo de Telar.
• Puntos de quiebre recalibrados: el diseño vertical se activa ahora en ventanas más angostas que 1024 px o con una relación de aspecto menor que 3:4, con lo que las tabletas en posición vertical quedan mejor cubiertas.

Cómo actualizar

La actualización es automática y se hace desde GitHub. En el repositorio de tu sitio, abre la pestaña Actions y ejecuta el flujo de trabajo Upgrade Telar: detecta tu versión actual y abre un pull request con los cambios para que los revises y hagas merge. Como la v1.4.0 no incluye migración de contenido, no hay pasos manuales y tus historias se siguen viendo igual. Para el paso a paso completo, consulta la guía para actualizar Telar.

Agradecimientos

Telar es desarrollado por Adelaida Ávila, Juan Cobo Betancourt, Natalie Cobo, Santiago Muñoz, y estudiantes e investigadores del UCSB Archives, Memory, and Preservation Lab, el UT Archives, Mapping, and Pedagogy Lab, y Neogranadina.

Agradecemos el apoyo del Caribbean Digital Scholarship Collective, el Center for Innovative Teaching, Research, and Learning (CITRAL) de la University of California, Santa Barbara, la UCSB Library, el Routes of Enslavement in the Americas University of California MRPI, y el Departamento de Historia de la Universidad de Texas en Austin.

Telar v1.3.0

Telar v1.3.0

i18n hygiene release. Telar has shipped English and Spanish language packs for several versions, but a number of layouts and includes still carried hardcoded English literals. This release wires them up so sites with telar_language: es render in Spanish throughout. It also refreshes the default content of the welcome and "About" pages to reflect what Telar can do today (multimedia, the Telar Compositor, narrative exhibitions and small digital collections), and introduces a sister-file convention so site owners can localize their own user pages.

Versión en español abajo

Fixed

Homepage headings rendered in English for Spanish-language sites
_layouts/index.html now resolves the stories and objects headings with a fallback chain: page.X | default: lang.pages.X | default: "<English literal>". Previously the layout skipped the language pack entirely when no page.* override was present, and the template index.md shipped with English page-overrides — so any site with telar_language: es saw English headings for no apparent reason.

Empty-state messages and IIIF URL warning hardcoded in English
_layouts/index.html, _layouts/objects-index.html, _layouts/glossary-index.html and _includes/iiif-url-warning.html now reference the lang.empty_states.* and lang.errors.iiif_mismatch.* keys that already existed in both language packs but were never used. Spanish-language sites now show the "no content yet" guidance and the IIIF mismatch troubleshooting modal in Spanish.

Thumbnail load fallback strings hardcoded in English
_layouts/index.html and _layouts/objects-index.html now inject TelarI18n and TelarI18nIIIF constants from the language pack, so the strings shown when a thumbnail fails to load ("Failed to load", "No image") now appear in the active language.

Empty-state messages pointed at the wrong content directory
The guidance read "add files to _stories/" / _objects/ / _glossary/. Those directories are generated by the build; the actual user-content paths are under telar-content/spreadsheets/ and telar-content/texts/glossary/. The lang values had the correct paths — wiring them up fixed both the i18n bug and the misleading guidance.

Migration script language detection for Spanish sites
BaseMigration._detect_language() looked for telar_language nested under the telar: block in _config.yml, but the key has always been top-level. Every Spanish-language site silently fell through to the English default for migration manual steps. The base class now reads the correct top-level key, so Spanish sites get Spanish manual steps in UPGRADE_SUMMARY.md and (in v1.3.0 specifically) the conditional acerca.md creation guard now sees the correct language.

Added

Sister-file localization for user pages (telar-content/texts/pages/)
scripts/generate_collections.py now recognizes markdown files with frontmatter localized_for: <canonical>.md and language: <code>. When site.telar_language matches the sister's language, the build uses the sister's content but writes the output under the canonical filename — so /about/ resolves to the right language without duplicating URLs. The v1.3.0 template ships with acerca.md as the Spanish sister of about.md; you can add siblings for other languages following the same convention.

New key lang.index_page.welcome carrying the homepage welcome content as a multi-line markdown block, in EN and ES. The default index.md body now renders {{ lang.index_page.welcome | markdownify }} with a bilingual EN/ES override comment that explains how site owners replace it with their own content.

New key lang.pages.glossary_intro for the glossary page intro sentence, with EN and ES values.

Two added keys in lang.errors.iiif_mismatch.* (local_fix_check_config and local_fix_run_with_note) that were missing from the IIIF warning's local-development fallback section.

Migration script v121_to_v130.py and matching migration.json manifest
Conditional content cleanup: removes the three stale index.md frontmatter keys and replaces user-content bodies (welcome, glossary, objects, About) with the v1.3.0 lang-key templates only when a SHA-256 hash check confirms the file is byte-for-byte identical to the v1.2.1 default. Any user customization — even a whitespace-only edit — preserves the file untouched. For sites with telar_language: es whose about.md is unchanged from the v1.2.1 default, the migration also creates acerca.md (the new Spanish sister) so the site immediately renders Spanish content at /about/. Sites with a customised about.md skip this — otherwise the new sister file would shadow the customisation at build time.

Changed

Default content of the welcome and About pages refreshed
Both pages now describe Telar as it is today: they name both modes (scroll-driven narrative exhibitions and publishing small digital collections), name the content types they weave (IIIF images, video, audio, narrative text, contextual layers), present the three setup paths (Telar Compositor, GitHub template + Google Sheets, hands-on local) and link to the Telar Compositor. The previous content described Telar as it stood around v0.7 (single-mode, GitHub template only, no audio/video, no Compositor).

pages/glossary.md, pages/objects.md, index.md rewritten to render via lang keys rather than hardcoded English. Each file carries a bilingual EN/ES HTML override comment explaining how to replace the default with custom content. The pattern uses {% assign lang = site.data.languages[site.telar_language] | default: site.data.languages.en %} at the top of the page (the layout's own lang assignment isn't visible to the page body, which Jekyll renders before wrapping it in the layout).

telar-content/texts/pages/about.md rewritten with the refreshed copy and a sentence in the Customize alert documenting the sister-file convention for site owners adding additional languages.

Removed

Stale lang.pages.home_title key removed from en.yml and es.yml. Defined since v1.0.0-beta but never referenced from any layout, include, or script.

Migration

Automated upgrade from v1.2.1:

1. Go to your repository's Actions tab
2. Select the Upgrade Telar workflow
3. Click Run workflow
4. Review the upgrade issue and merge the pull request

Or run locally: python3 scripts/upgrade.py

The script verifies a SHA-256 hash of each user-content file before touching it. If you customized your welcome page, About page, glossary intro or objects intro, those files are preserved unchanged. For Spanish-language sites with an unchanged About page, the migration also creates acerca.md automatically so /about/ immediately renders the new Spanish content. If you customised about.md, the migration leaves it alone and does NOT create acerca.md (which would otherwise shadow your customisation).

Migration script: scripts/migrations/v121_to_v130.py

Documentation

• Documentation: https://telar.org/docs
• Example Site: https://ampl.clair.ucsb.edu/telar
• Report Issues: https://github.com/UCSB-AMPLab/telar/issues

Acknowledgments

Telar is developed by Adelaida Ávila, Juan Cobo Betancourt, Natalie Cobo, Santiago Muñoz, and students and scholars at the UCSB Archives, Memory, and Preservation Lab, the UT Archives, Mapping, and Pedagogy Lab, and Neogranadina.

We gratefully acknowledge the support of the Caribbean Digital Scholarship Collective, the Center for Innovative Teaching, Research, and Learning (CITRAL) at the University of California, Santa Barbara, the UCSB Library, the Routes of Enslavement in the Americas University of California MRPI, and the Department of History of The University of Texas at Austin.

---

Español

Versión de limpieza i18n. Telar tenía paquetes de idioma para inglés y español desde hace varias versiones, pero algunos layouts e includes seguían con texto literal en inglés. Esta versión los cablea para que los sitios con telar_language: es muestren todo en español. Además: actualiza el contenido por defecto de las páginas de bienvenida y "Acerca de" para reflejar lo que Telar puede hacer hoy (multimedia, Compositor, exhibiciones narrativas y colecciones digitales), e introduce una convención de archivos hermanos para que cualquiera pueda localizar sus propias páginas.

Corregido

Encabezados de la página de inicio en inglés para sitios en español
El layout _layouts/index.html ahora resuelve los encabezados de historias y objetos con fallback: page.X | default: lang.pages.X | default: "<texto en inglés>". Antes se saltaba el paquete de idioma cuando no había un page.* override, y la plantilla index.md traía esos overrides en inglés de fábrica — así que cualquier sitio con telar_language: es veía los encabezados en inglés sin razón aparente.

Mensajes de "vacío" y alerta de IIIF en inglés
_layouts/index.html, _layouts/objects-index.html, _layouts/glossary-index.html y _includes/iiif-url-warning.html ahora referencian las claves lang.empty_states.* y lang.errors.iiif_mismatch.* que ya existían en ambos paquetes de idioma pero que nunca se usaban. Los sitios en español ahora muestran las guías de "no hay contenido todavía" y la alerta de IIIF en español.

Textos de carga de miniaturas en inglés
_layouts/index.html y _layouts/objects-index.html ahora inyectan constantes TelarI18n y TelarI18nIIIF desde el paquete de idioma, así que los textos que aparecen cuando una miniatura no carga ("Failed to load", "No image") ahora salen en el idioma activo.

Mensajes de "vacío" que apuntaban al directorio equivocado
La guía decía "agrega archivos en _stories/" / _objects/ / _glossary/. Esos directorios son generados por el build; las rutas reales para el contenido de los usuarios están bajo telar-content/spreadsheets/ y `tel...

Telar v1.2.1

Telar v1.2.1

Patch release with a demo content fetch fix and project metadata additions.

Versión en español abajo

Fixed

Demo content fetch tolerates v-prefixed telar.version
The demo content fetcher (scripts/fetch_demo_content.py) previously raised an internal ValueError when _config.yml had a v-prefixed version string (e.g. version: "v1.2.0") and silently built sites with no demo content. An earlier version of the Telar Compositor's upgrade flow wrote v-prefixed strings into some sites; the compositor was fixed, but historical bad values persisted in upgraded sites. The fetcher now strips a leading v (or V) when reading the site version and again as defence-in-depth when parsing entries from the remote versions.json index. A new warning surfaces in the build log if a site version cannot be parsed for any other reason. Sites with stale v-prefixed values continue to work unchanged; the value can optionally be cleaned up to a bare numeric version.

Added

• CITATION.cff with author and ORCID metadata for academic citation
• Migration script v120_to_v121.py and matching migration.json manifest for the demo content fetch fix

Changed

• Expanded package.json metadata (version, description, license, author, contributors, homepage, repository, bugs) for clarity in the npm/GitHub ecosystem

Migration

Automated upgrade from v1.2.0:

1. Go to your repository Actions tab
2. Select Upgrade Telar workflow
3. Click Run workflow
4. Review the upgrade issue and merge the pull request

Or run locally: python3 scripts/upgrade.py

Migration script: scripts/migrations/v120_to_v121.py

Documentation

• Documentation: https://telar.org/docs
• Example Site: https://ampl.clair.ucsb.edu/telar
• Report Issues: https://github.com/UCSB-AMPLab/telar/issues

Acknowledgments

Telar is developed by Adelaida Ávila, Juan Cobo Betancourt, Natalie Cobo, Santiago Muñoz, and students and scholars at the UCSB Archives, Memory, and Preservation Lab, the UT Archives, Mapping, and Pedagogy Lab, and Neogranadina.

We gratefully acknowledge the support of the Caribbean Digital Scholarship Collective, the Center for Innovative Teaching, Research, and Learning (CITRAL) at the University of California, Santa Barbara, the UCSB Library, the Routes of Enslavement in the Americas University of California MRPI, and the Department of History of The University of Texas at Austin.

---

Español

Corrección a la descarga de contenido de demostración y adiciones a los metadatos del proyecto.

Corregido

Descarga de contenido de demostración: tolerancia a versiones con "v"
El script que descarga el contenido de demostración (scripts/fetch_demo_content.py) lanzaba un ValueError interno y dejaba los sitios sin contenido de demostración cuando _config.yml tenía una versión que empezaba con "v" (por ejemplo, version: "v1.2.0"). Una versión anterior del flujo de actualización del Compositor de Telar escribía esos valores con "v" en algunos sitios; el Compositor ya se corrigió, pero los valores antiguos quedaron en los sitios que se habían actualizado antes del arreglo. El script ahora quita la "v" (o "V") inicial al leer la versión del sitio, y también al procesar las entradas del índice remoto versions.json (como precaución adicional). Si por cualquier otra razón una versión no se puede leer, ahora aparece un aviso en la salida del build. Los sitios con valores antiguos siguen funcionando sin cambios; si quieres, puedes quitar la "v" a mano para dejar la versión en el formato más reciente de Telar.

Agregado

• CITATION.cff con metadatos del autor y ORCID para citas académicas
• Script de migración v120_to_v121.py y manifiesto migration.json correspondientes a la corrección

Cambiado

• Metadatos de package.json ampliados (version, description, license, author, contributors, homepage, repository, bugs) para más claridad en el ecosistema de npm/GitHub

Migración

Actualización automática desde v1.2.0:

1. Ve a la pestaña Actions de tu repositorio
2. Selecciona el flujo de trabajo Upgrade Telar
3. Haz clic en Run workflow
4. Revisa el issue de actualización y fusiona el pull request

O ejecuta localmente: python3 scripts/upgrade.py

Script de migración: scripts/migrations/v120_to_v121.py

Documentación

• Documentación: https://telar.org/guia
• Sitio de ejemplo: https://ampl.clair.ucsb.edu/telar
• Reportar problemas: https://github.com/UCSB-AMPLab/telar/issues

Agradecimientos

Telar es desarrollado por Adelaida Ávila, Juan Cobo Betancourt, Natalie Cobo, Santiago Muñoz, y estudiantes e investigadores del UCSB Archives, Memory, and Preservation Lab, el UT Archives, Mapping, and Pedagogy Lab, y Neogranadina.

Agradecemos el apoyo del Caribbean Digital Scholarship Collective, el Center for Innovative Teaching, Research, and Learning (CITRAL) de la University of California, Santa Barbara, la UCSB Library, el Routes of Enslavement in the Americas University of California MRPI, y el Departamento de Historia de la Universidad de Texas en Austin.

---

Release Date: 2026-05-08
Previous Version: v1.2.0

Telar v1.2.0

Telar v1.2.0

Story structure and UX improvements.

Version en español abajo

Added

Section card table of contents
Stories with show_sections: yes in project.csv display a navigable TOC on the title card, listing every section card as a clickable link. The title card uses the layer 2 panel background color when TOC is enabled. Add mostrar_secciones: si for Spanish-language sites.

Back to Start button
The "Back to Home" button in the top-left corner now switches to "Back to Start" once readers scroll past the title card. Clicking it returns to the title card. On mobile, the button shows a contextual icon (home or up-arrow).

In-story navigation
New navigateToStep() and navigateToIntro() functions allow jumping between steps from within the story, used by the TOC links and the Back to Start button.

Migration manifest
Each release now includes a machine-readable migration.json describing content transforms, attached as a GitHub Release asset. The Telar Compositor uses these manifests to upgrade sites through its web interface.

Changed

• Story card placeholders - Homepage thumbnails now show the first letter of the story title instead of an auto-generated ordinal number. Related story links on object pages show the title only.

Fixed

• Deep link parent panel stacking - Deep links to layer 2 panels (e.g. #s3l2) now correctly open layer 1 underneath, so all parent panels are visible when arriving via a shared link.

Migration

Automated upgrade from v1.1.0:

1. Go to your repository Actions tab
2. Select Upgrade Telar workflow
3. Click Run workflow
4. Review the upgrade issue and merge the pull request

Or run locally: python3 scripts/upgrade.py

Migration script: scripts/migrations/v110_to_v120.py

Documentation

• Documentation: https://telar.org/docs
• Example Site: https://ampl.clair.ucsb.edu/telar
• Report Issues: https://github.com/UCSB-AMPLab/telar/issues

Acknowledgments

Telar is developed by Adelaida Avila, Juan Cobo Betancourt, Natalie Cobo, Santiago Munoz, and students and scholars at the UCSB Archives, Memory, and Preservation Lab, the UT Archives, Mapping, and Pedagogy Lab, and Neogranadina.

We gratefully acknowledge the support of the Caribbean Digital Scholarship Collective, the Center for Innovative Teaching, Research, and Learning (CITRAL) at the University of California, Santa Barbara, the UCSB Library, the Routes of Enslavement in the Americas University of California MRPI, and the Department of History of The University of Texas at Austin.

---

Español

Mejoras en la estructura de historias y experiencia de usuario.

Agregado

Tabla de contenidos en tarjetas de sección
Las historias con mostrar_secciones: si en project.csv muestran una tabla de contenidos navegable en la tarjeta de título, con un enlace a cada tarjeta de sección. La tarjeta de título usa el color de fondo del panel de nivel 2 cuando la tabla de contenidos está activada. Usa show_sections: yes para sitios en inglés.

Botón de volver al comienzo
El botón "Volver al inicio" en la esquina superior izquierda cambia a "Comienzo" una vez que se avanza más allá de la tarjeta de título. Al hacer clic regresa a la tarjeta de título. En móvil, el botón muestra un ícono contextual (inicio o flecha hacia arriba).

Navegación dentro de la historia
Las nuevas funciones navigateToStep() y navigateToIntro() permiten saltar entre pasos desde dentro de la historia, utilizadas por los enlaces de la tabla de contenidos y el botón de volver al comienzo.

Manifiesto de migración
Cada versión ahora incluye un archivo migration.json legible por máquina que describe las transformaciones de contenido, adjunto como recurso en la publicación de GitHub. El Compositor de Telar usa estos manifiestos para actualizar sitios a través de su interfaz web.

Cambiado

• Marcadores de tarjetas de historia - Las miniaturas de la página principal ahora muestran la primera letra del título de la historia en lugar de un número ordinal generado automáticamente. Los enlaces a historias relacionadas en las páginas de objetos muestran solo el título.

Corregido

• Apilamiento de paneles en enlaces directos - Los enlaces directos a paneles de nivel 2 (ej. #s3l2) ahora abren correctamente el nivel 1 debajo, de modo que todos los paneles superiores quedan visibles al llegar mediante un enlace compartido.

Migración

Actualización automática desde v1.1.0:

1. Ve a la pestaña Actions de tu repositorio
2. Selecciona el flujo de trabajo Upgrade Telar
3. Haz clic en Run workflow
4. Revisa el issue de actualización y fusiona el pull request

O ejecuta localmente: python3 scripts/upgrade.py

Script de migración: scripts/migrations/v110_to_v120.py

Documentación

• Documentación: https://telar.org/guia
• Sitio de ejemplo: https://ampl.clair.ucsb.edu/telar
• Reportar problemas: https://github.com/UCSB-AMPLab/telar/issues

Agradecimientos

Telar es desarrollado por Adelaida Avila, Juan Cobo Betancourt, Natalie Cobo, Santiago Munoz, y estudiantes e investigadores del UCSB Archives, Memory, and Preservation Lab, el UT Archives, Mapping, and Pedagogy Lab, y Neogranadina.

Agradecemos el apoyo del Caribbean Digital Scholarship Collective, el Center for Innovative Teaching, Research, and Learning (CITRAL) de la University of California, Santa Barbara, la UCSB Library, el Routes of Enslavement in the Americas University of California MRPI, y el Departamento de Historia de la Universidad de Texas en Austin.

---

Release Date: 2026-04-16
Previous Version: v1.1.0

Telar v1.1.0

Structural and navigational features for richer storytelling.

Version en español abajo

Added

Deep linking
Story URLs now update as readers scroll through a story. Copy and share a URL that points to a specific step, optionally with a panel layer open. Shared links open directly at the right position. Uses history.replaceState exclusively — back/forward buttons navigate between pages, not between story steps.

Title cards
Chapter heading cards for section breaks within stories. Leave the object column empty for a step row and the question column becomes the heading text. Title cards participate fully in scroll, keyboard, and button navigation.

Collection mode
Set collection_mode: true in _config.yml to flip the homepage to a collection-first layout. Objects appear first with large thumbnails; stories appear below with smaller thumbnails. Default mode is unchanged.

Bibliography styling
Use the :::bibliography widget block in panel markdown content to format references with hanging indent (first line flush, subsequent lines indented).

Share panel "this view" tab
The share panel now includes a tab that copies the current URL with the reader's exact position.

Fixed

• Panel scroll — Wheel events inside open panels are no longer intercepted by the scroll engine. Users can scroll panel content freely without the story advancing
• Keyboard navigation in panels — Arrow keys, Page Up/Down, and Spacebar now scroll panel content when a panel is open, instead of navigating story steps
• Video/audio not paused on title cards — Media players now properly deactivate when scrolling from a video or audio card into a title card, in both directions
• IIIF viewer background on object pages — The Telar weave pattern now shows correctly behind the IIIF viewer on object pages
• Audio object detection — Audio objects are now correctly detected even without the audiowaveform system dependency
• ArrowRight on first step — Fixed an issue where pressing ArrowRight immediately after arriving at step 1 from the intro could fail

Migration

Automated upgrade from v1.0.0-beta:

1. Go to your repository's Actions tab
2. Select "Upgrade Telar" workflow
3. Click Run workflow
4. Review the upgrade issue and merge the pull request

Migration script: scripts/migrations/v100_to_v110.py

If you work with your site locally:

python3 scripts/upgrade.py

Documentation

• Documentation: https://telar.org/docs
• Example Site: https://ampl.clair.ucsb.edu/telar
• Report Issues: https://github.com/UCSB-AMPLab/telar/issues

Acknowledgments

Telar is developed by Adelaida Ávila, Juan Cobo Betancourt, Natalie Cobo, Santiago Muñoz, and students and scholars at the UCSB Archives, Memory, and Preservation Lab, the UT Archives, Mapping, and Pedagogy Lab, and Neogranadina.

We gratefully acknowledge the support of the Caribbean Digital Scholarship Collective, the Center for Innovative Teaching, Research, and Learning (CITRAL) at the University of California, Santa Barbara, the UCSB Library, the Routes of Enslavement in the Americas University of California MRPI, and the Department of History of The University of Texas at Austin.

---

Español

Funciones estructurales y de navegación para una narrativa más rica.

Agregado

Enlaces directos
Las URLs de las historias ahora se actualizan a medida que se desplaza por ellas. Se puede copiar y compartir una URL que apunte a un paso específico, opcionalmente con un panel abierto. Los enlaces compartidos abren directamente en la posición correcta. Usa history.replaceState exclusivamente — al presionar atrás/adelante se navega entre páginas, no entre pasos de la historia.

Tarjetas de título
Tarjetas de encabezado para marcar secciones dentro de las historias. Deja vacía la columna de objeto en una fila de paso y la columna de pregunta se convierte en el texto del encabezado. Las tarjetas de título participan completamente en la navegación por desplazamiento, teclado y botones.

Modo colección
Agrega collection_mode: true en _config.yml para cambiar la página de inicio a un diseño que prioriza la colección. Los objetos aparecen primero con miniaturas grandes; las historias aparecen debajo con miniaturas más pequeñas. El modo predeterminado no cambia.

Estilo bibliográfico
Usa el bloque :::bibliography en el contenido markdown de los paneles para dar formato de sangría francesa a las referencias (primera línea al margen, líneas siguientes con sangría).

Pestaña "esta vista" en el panel de compartir
El panel de compartir ahora incluye una pestaña que copia la URL actual con la posición exacta del lector.

Corregido

• Desplazamiento en paneles — El motor de desplazamiento ya no intercepta los eventos de la rueda del ratón dentro de los paneles abiertos. Se puede desplazar el contenido del panel libremente sin que la historia avance
• Navegación por teclado en paneles — Las teclas de flecha, Page Up/Down y la barra espaciadora ahora desplazan el contenido del panel cuando hay uno abierto, en lugar de navegar entre pasos
• Video/audio no se pausaba en tarjetas de título — Los reproductores de medios ahora se desactivan correctamente al pasar de una tarjeta de video o audio a una tarjeta de título, en ambas direcciones
• Fondo del visor IIIF en páginas de objetos — El patrón de tejido de Telar ahora se muestra correctamente detrás del visor IIIF en las páginas de objetos
• Detección de objetos de audio — Los objetos de audio ahora se detectan correctamente incluso sin la dependencia del sistema audiowaveform
• ArrowRight en el primer paso — Se corrigió un problema en el que presionar ArrowRight inmediatamente después de llegar al paso 1 desde la introducción podía fallar

Migración

Actualización automática desde v1.0.0-beta:

1. Ve a la pestaña Actions de tu repositorio
2. Selecciona el flujo "Upgrade Telar"
3. Haz clic en Run workflow
4. Revisa el issue de actualización y fusiona el pull request

Script de migración: scripts/migrations/v100_to_v110.py

Si trabajas con tu sitio localmente:

python3 scripts/upgrade.py

Documentación

• Documentación: https://telar.org/guia
• Sitio de ejemplo: https://ampl.clair.ucsb.edu/telar
• Reportar problemas: https://github.com/UCSB-AMPLab/telar/issues

Agradecimientos

Telar es desarrollado por Adelaida Ávila, Juan Cobo Betancourt, Natalie Cobo, Santiago Muñoz, y estudiantes e investigadores del UCSB Archives, Memory, and Preservation Lab, el UT Archives, Mapping, and Pedagogy Lab, y Neogranadina.

Agradecemos el apoyo del Caribbean Digital Scholarship Collective, el Center for Innovative Teaching, Research, and Learning (CITRAL) de la University of California, Santa Barbara, la UCSB Library, el Routes of Enslavement in the Americas University of California MRPI, y el Departamento de Historia de la Universidad de Texas en Austin.

---

Release Date: 2026-04-12
Previous Version: v1.0.0-beta

Telar v1.0.0-beta

Telar v1.0.0-beta

A new milestone.

Versión en español abajo

This is Telar's twenty-fourth release. For the first time, Telar can weave together images, video, and audio — a major new stage that we hope will help you tell all sorts of new stories. Together with a fluid scroll engine (no more jumping!), a new card-stack architecture, and the WYSIWYG Telar Compositor, these features round out the roadmap we first sketched when we started building Telar. It finally feels like a 1.0.

None of this would have happened without all of you who tested early versions, reported what was broken, and told us what you needed. Thank you.

— Juan

Added

• Video support: YouTube, Vimeo, and Google Drive videos in stories and on object pages. Clip control (start, end, loop) lets you highlight specific segments

• Audio support: Audio files with WaveSurfer waveform visualization in stories and on object pages. Clip regions for selecting segments

• Clip time picker: Interactive tool on object pages for setting video and audio clip boundaries. Copy start/end times directly into your spreadsheet

• Card-stack scroll architecture: Stories now use a continuous scroll model with magnetic waypoints instead of the previous step-by-step navigation. Cards slide over previous ones, creating a fluid reading experience

• Media type detection and filtering: Objects are automatically classified as Image, Video, or Audio. The gallery page has separate type and medium filters

• Alt text support: New alt_text column in story and object spreadsheets for accessibility descriptions, with automatic fallback to object titles

• Inline Lucide SVG icons: All icons are now self-hosted inline SVGs, replacing the Google Material Symbols and Bootstrap Icons CDN dependencies

• Audio build pipeline: New process_audio.py script for clip extraction and waveform peak data generation, integrated into the local build script and GitHub Actions workflow

Changed

• Scroll system: Replaced the discrete step accumulator with Lenis continuous scroll and magnetic snap waypoints

• Card rendering: New per-scene card pool with z-index banding replaces the previous split-column viewer/narrative layout

• Mobile layout: Text cards are bottom-anchored on mobile with frosted glass styling

• Object pages: Media-type-conditional rendering — images get the IIIF viewer with coordinate panel, videos get embeds with clip picker, audio gets waveform with region-based clip picker

• Gallery: Video and audio objects show icon placeholders. Two separate filter sections (Type and Medium/Genre)

• Viewer preloading: max_viewer_cards default reduced from 10 to 8

Removed

• Google Material Symbols CDN dependency: Replaced by inline Lucide SVGs
• Bootstrap Icons CDN dependency: Replaced by inline Lucide SVGs

Upgrading

If you use GitHub Pages:

1. Go to your repository's Actions tab
2. Select Upgrade Telar
3. Click Run workflow
4. Review the upgrade issue and merge the pull request
5. Replace your .github/workflows/build.yml with the latest version

If you work with your site locally:

python3 scripts/upgrade.py
npm install

Optional — if your site includes audio objects:

brew install ffmpeg audiowaveform      # macOS
sudo apt install ffmpeg audiowaveform  # Ubuntu

Documentation

• Documentation: https://telar.org/docs
• Example site: https://ampl.clair.ucsb.edu/telar
• Report issues: https://github.com/UCSB-AMPLab/telar/issues

Acknowledgments

Telar is developed by Adelaida Ávila, Juan Cobo Betancourt, Natalie Cobo, Santiago Muñoz, and students and scholars at the UCSB Archives, Memory, and Preservation Lab, the UT Archives, Mapping, and Pedagogy Lab, and Neogranadina.

We gratefully acknowledge the support of the Caribbean Digital Scholarship Collective, the Center for Innovative Teaching, Research, and Learning (CITRAL) at the University of California, Santa Barbara, the UCSB Library, the Routes of Enslavement in the Americas University of California MRPI, and the Department of History of The University of Texas at Austin.

---

Español

Un nuevo hito.

Esta es la vigésima cuarta versión de Telar. Por primera vez, Telar puede entrelazar imágenes, video y audio — una nueva etapa que esperamos ayude a contar todo tipo de nuevas historias. Junto con un motor de scroll fluido (¡no más saltos!), una nueva arquitectura de tarjetas apiladas y el Compositor de Telar, estas funciones completan la hoja de ruta que trazamos cuando empezamos a construir Telar. Por fin se siente como un 1.0.

Nada de esto hubiera sido posible sin todos ustedes que probaron versiones tempranas, reportaron lo que no funcionaba y nos dijeron lo que necesitaban. Gracias.

— Juan

Novedades

• Soporte de video: Videos de YouTube, Vimeo y Google Drive en historias y páginas de objetos. Control de clips (inicio, fin, bucle) para resaltar segmentos específicos

• Soporte de audio: Archivos de audio con visualización de forma de onda WaveSurfer en historias y páginas de objetos. Regiones de clip para seleccionar segmentos

• Selector de tiempos de clip: Herramienta interactiva en las páginas de objetos para definir los límites de clips de video y audio. Copia los tiempos de inicio y fin directamente a la hoja de cálculo

• Arquitectura de scroll con tarjetas apiladas: Las historias ahora usan un modelo de scroll continuo con puntos de anclaje magnéticos en lugar de la navegación paso a paso anterior. Las tarjetas se deslizan sobre las anteriores, creando una experiencia de lectura fluida

• Detección y filtrado por tipo de medio: Los objetos se clasifican automáticamente como Imagen, Video o Audio. La galería tiene filtros separados por tipo y medio/género

• Texto alternativo: Nueva columna alt_text en las hojas de cálculo de historias y objetos para descripciones de accesibilidad, con respaldo automático a los títulos de los objetos

• Íconos SVG Lucide en línea: Todos los íconos ahora son SVGs en línea autoalojados, reemplazando las dependencias CDN de Google Material Symbols y Bootstrap Icons

• Pipeline de procesamiento de audio: Nuevo script process_audio.py para extracción de clips y generación de datos de forma de onda, integrado en el script de construcción local y en el flujo de GitHub Actions

Cambios

• Sistema de scroll: El acumulador de pasos discretos fue reemplazado por scroll continuo con Lenis y puntos de anclaje magnéticos

• Renderizado de tarjetas: Un nuevo pool de tarjetas por escena con bandas de z-index reemplaza el diseño anterior de columnas divididas

• Diseño móvil: Las tarjetas de texto están ancladas en la parte inferior en móvil con estilo de vidrio esmerilado

• Páginas de objetos: Renderizado condicional por tipo de medio — las imágenes muestran el visor IIIF con panel de coordenadas, los videos muestran incrustaciones con selector de clips, el audio muestra forma de onda con selector de regiones

• Galería: Los objetos de video y audio muestran íconos como miniaturas. Dos secciones de filtro separadas (Tipo y Medio/Género)

• Precarga del visor: El valor predeterminado de max_viewer_cards se redujo de 10 a 8

Eliminado

• Dependencia CDN de Google Material Symbols: Reemplazada por SVGs Lucide en línea
• Dependencia CDN de Bootstrap Icons: Reemplazada por SVGs Lucide en línea

Actualización

Si usas GitHub Pages:

1. Ve a la pestaña Actions del repositorio
2. Selecciona Upgrade Telar
3. Haz clic en Run workflow
4. Revisa el issue de actualización y fusiona el pull request
5. Reemplaza tu .github/workflows/build.yml con la versión más reciente

Si trabajas con tu sitio localmente:

python3 scripts/upgrade.py
npm install

Opcional — si el sitio incluye objetos de audio:

brew install ffmpeg audiowaveform      # macOS
sudo apt install ffmpeg audiowaveform  # Ubuntu

Documentación

• Documentación: https://telar.org/guia
• Sitio de ejemplo: https://ampl.clair.ucsb.edu/telar
• Reportar problemas: https://github.com/UCSB-AMPLab/telar/issues

Agradecimientos

Telar es desarrollado por Adelaida Ávila, Juan Cobo Betancourt, Natalie Cobo, Santiago Muñoz, y estudiantes e investigadores del UCSB Archives, Memory, and Preservation Lab, el UT Archives, Mapping, and Pedagogy Lab, y Neogranadina.

Agradecemos el apoyo del Caribbean Digital Scholarship Collective, el Center for Innovative Teaching, Research, and Learning (CITRAL) de la University of California, Santa Barbara, la UCSB Library, el Routes of Enslavement in the Americas University of California MRPI, y el Departamento de Historia de la Universidad de Texas en Austin.

---

Release Date: 2026-03-25
Previous Version: v0.9.4-beta

Telar v0.9.4-beta

Telar v0.9.4-beta

PDF dependency fix.

Versión en español abajo

Fixes

• PDF IIIF tile generation in CI — PyMuPDF was not listed in requirements.txt, so CI skipped IIIF tile generation for PDF objects entirely. PDF objects now get tiles generated correctly during builds

Upgrading

If you use GitHub Pages:

1. Go to your repository's Actions tab
2. Select Upgrade Telar
3. Click Run workflow
4. Review the upgrade issue and merge the pull request
5. If your site has PDF objects, go back to Actions, select Build and Deploy Telar Site, and click Run workflow to generate their tiles

If you work with your site locally:

pip install PyMuPDF
python3 scripts/upgrade.py

If your site has PDF objects whose tiles were not previously generated, also run:

python3 scripts/generate_iiif.py --base-url YOUR_SITE_URL

Documentation

• Documentation: https://telar.org/docs
• Example site: https://ampl.clair.ucsb.edu/telar
• Report issues: https://github.com/UCSB-AMPLab/telar/issues

Acknowledgments

Telar is developed by Adelaida Ávila, Juan Cobo Betancourt, Natalie Cobo, Santiago Muñoz, and students and scholars at the UCSB Archives, Memory, and Preservation Lab, the UT Archives, Mapping, and Preservation Lab, and Neogranadina.

We gratefully acknowledge the support of the Caribbean Digital Scholarship Collective, the Center for Innovative Teaching, Research, and Learning (CITRAL) at the University of California, Santa Barbara, the UCSB Library, the Routes of Enslavement in the Americas University of California MRPI, and the Department of History of The University of Texas at Austin.

---

Español

Corrección de dependencia para objetos PDF.

Correcciones

• Generación de teselas IIIF para PDFs en CI — PyMuPDF no estaba incluido en requirements.txt, por lo que CI omitía la generación de teselas IIIF para objetos PDF. Los objetos PDF ahora generan sus teselas correctamente durante la construcción del sitio

Actualización

Si usas GitHub Pages:

1. Ve a la pestaña Actions del repositorio
2. Selecciona Upgrade Telar
3. Haz clic en Run workflow
4. Revisa el issue de actualización y fusiona el pull request
5. Si el sitio tiene objetos PDF, regresa a Actions, selecciona Build and Deploy Telar Site y haz clic en Run workflow para generar sus teselas

Si trabajas con tu sitio localmente:

pip install PyMuPDF
python3 scripts/upgrade.py

Si el sitio tiene objetos PDF cuyas teselas no se generaron previamente, también ejecuta:

python3 scripts/generate_iiif.py --base-url URL_DE_TU_SITIO

Documentación

• Documentación: https://telar.org/guia
• Sitio de ejemplo: https://ampl.clair.ucsb.edu/telar
• Reportar problemas: https://github.com/UCSB-AMPLab/telar/issues

Agradecimientos

Telar es desarrollado por Adelaida Ávila, Juan Cobo Betancourt, Natalie Cobo, Santiago Muñoz, y estudiantes e investigadores del UCSB Archives, Memory, and Preservation Lab, el UT Archives, Mapping, and Preservation Lab, y Neogranadina.

Agradecemos el apoyo del Caribbean Digital Scholarship Collective, el Center for Innovative Teaching, Research, and Learning (CITRAL) de la University of California, Santa Barbara, la UCSB Library, el Routes of Enslavement in the Americas University of California MRPI, y el Departamento de Historia de la Universidad de Texas en Austin.

---

Release Date: 2026-03-18
Previous Version: v0.9.3-beta

Telar v0.9.3-beta

Telar v0.9.3-beta

Bug fixes and improvements for image viewing, multi-page objects, and the coordinate finder tool.

Versión en español abajo

Fixes

• Viewer crash with small images — Sites with images smaller than 512px (common with small paintings or portraits) no longer crash when loading stories or object pages

• Missing tiles on large images — Edge tiles on high-resolution images (over 1024px) now load correctly instead of showing blank gaps

• Homepage and gallery thumbnails — Story cards and object thumbnails now display at the right resolution instead of appearing blurry or broken

• Multi-page story navigation — Scrolling between story steps that show different pages of the same document (e.g. a PDF) now switches to the correct page instead of staying on the first one

• Coordinate finder values — The copy button now outputs values in the correct column order for multi-page objects, and the Page column from Google Sheets is handled correctly regardless of capitalisation

• Page selector in multi-page viewer — Page labels are no longer cut off in the Tify viewer dropdown

• Coordinate panel readability — The panel heading is now legible on all theme backgrounds

Improvements

• Portrait viewer on object pages — The object page viewer now uses a 4:5 portrait aspect ratio instead of a fixed landscape height

• Redesigned coordinate panel — The coordinate finder tool now adapts its colours to the active theme, with cleaner styling throughout

• Bilingual coordinate instructions — The coordinate panel instructions are now available in both English and Spanish, with a variant for multi-page objects that mentions the Page value

• Sharper thumbnails — The homepage and objects gallery now select appropriately sized thumbnails from the available IIIF sizes

Upgrading

If you use GitHub Pages:

1. Go to your repository's Actions tab
2. Select Upgrade Telar
3. Click Run workflow
4. Review the upgrade issue and merge the pull request
5. After merging, go back to Actions, select Build and Deploy Telar Site, and click Run workflow to regenerate image tiles

If you work with your site locally:

python3 scripts/upgrade.py
python3 scripts/generate_iiif.py --base-url YOUR_SITE_URL

The second command regenerates image tiles with corrected metadata — this is needed for the thumbnail and tile fixes to take effect.

Documentation

• Documentation: https://telar.org/docs
• Example site: https://ampl.clair.ucsb.edu/telar
• Report issues: https://github.com/UCSB-AMPLab/telar/issues

Acknowledgments

Telar is developed by Adelaida Ávila, Juan Cobo Betancourt, Natalie Cobo, Santiago Muñoz, and students and scholars at the UCSB Archives, Memory, and Preservation Lab, the UT Archives, Mapping, and Preservation Lab, and Neogranadina.

We gratefully acknowledge the support of the Caribbean Digital Scholarship Collective, the Center for Innovative Teaching, Research, and Learning (CITRAL) at the University of California, Santa Barbara, the UCSB Library, the Routes of Enslavement in the Americas University of California MRPI, and the Department of History of The University of Texas at Austin.

---

Español

Correcciones y mejoras para la visualización de imágenes, objetos multipágina y la herramienta de coordenadas.

Correcciones

• Error del visor con imágenes pequeñas — Los sitios con imágenes menores de 512px (común con pinturas pequeñas o retratos) ya no fallan al cargar historias o páginas de objetos

• Teselas faltantes en imágenes grandes — Las teselas de borde en imágenes de alta resolución (más de 1024px) ahora se cargan correctamente en lugar de mostrar espacios en blanco

• Miniaturas en la página de inicio y la galería — Las tarjetas de historias y las miniaturas de objetos ahora se muestran con la resolución correcta en lugar de aparecer borrosas o rotas

• Navegación de historias multipágina — Al desplazarse entre pasos de una historia que muestran distintas páginas del mismo documento (ej. un PDF), ahora se cambia a la página correcta en lugar de quedarse en la primera

• Valores del buscador de coordenadas — El botón de copia ahora genera los valores en el orden correcto de columnas para objetos multipágina, y la columna Page de Google Sheets se maneja correctamente sin importar las mayúsculas

• Selector de página en el visor multipágina — Las etiquetas de página ya no se cortan en el menú del visor Tify

• Legibilidad del panel de coordenadas — El encabezado del panel ahora es legible en todos los fondos de tema

Mejoras

• Visor vertical en páginas de objetos — El visor en la página de objetos ahora usa una proporción 4:5 en lugar de una altura fija horizontal

• Panel de coordenadas rediseñado — La herramienta de coordenadas ahora adapta los colores al tema activo, con un estilo más limpio

• Instrucciones bilingües en el panel de coordenadas — Las instrucciones del panel de coordenadas ahora están disponibles en inglés y español, con una variante para objetos multipágina que menciona el valor de Página

• Miniaturas más nítidas — La página de inicio y la galería de objetos ahora seleccionan miniaturas de tamaño adecuado entre los tamaños IIIF disponibles

Actualización

Si usas GitHub Pages:

1. Ve a la pestaña Actions del repositorio
2. Selecciona Upgrade Telar
3. Haz clic en Run workflow
4. Revisa el issue de actualización y haz merge del pull request
5. Después de hacer merge, regresa a Actions, selecciona Build and Deploy Telar Site y haz clic en Run workflow para regenerar las teselas de imagen

Si trabajas con tu sitio localmente:

python3 scripts/upgrade.py
python3 scripts/generate_iiif.py --base-url URL_DE_TU_SITIO

El segundo comando regenera las teselas de imagen con metadatos corregidos — es necesario para que las correcciones de miniaturas y teselas surtan efecto.

Documentación

• Documentación: https://telar.org/docs
• Sitio de ejemplo: https://ampl.clair.ucsb.edu/telar
• Reportar problemas: https://github.com/UCSB-AMPLab/telar/issues

Agradecimientos

Telar es desarrollado por Adelaida Ávila, Juan Cobo Betancourt, Natalie Cobo, Santiago Muñoz, y estudiantes e investigadores del UCSB Archives, Memory, and Preservation Lab, el UT Archives, Mapping, and Preservation Lab, y Neogranadina.

Agradecemos el apoyo del Caribbean Digital Scholarship Collective, el Center for Innovative Teaching, Research, and Learning (CITRAL) de la University of California, Santa Barbara, la UCSB Library, el Routes of Enslavement in the Americas University of California MRPI, y el Departamento de Historia de la Universidad de Texas en Austin.

---

Release Date: 2026-03-14
Previous Version: v0.9.2-beta