Skip to content

v1.5.0-beta

Choose a tag to compare

@juancobo juancobo released this 05 Oct 14:34
· 67 commits to main since this release
63a1db1

The teaching release: course projects with join codes and shared object collections, a per-contributor record of group work, and publishing opened to every member of a group. The story editor is rebuilt around a stage that shows each step as a visitor will see it. Edits made on GitHub are now read back before a publish instead of being overwritten, and a large set of fixes stops authored content from being lost between the Compositor and the published site.

New features

  • Course projects — A convenor can mark a project as a course and share its objects with every group site that joins it. Students join with a reusable join code, either while creating a site or later from Site settings; course objects are tagged in each site's objects list and cannot be deleted there. The Course tab lists the sites in the course and manages its join codes. Please contact us if you are an instructor and would like to try this feature.

  • Instructors and staff codes — Courses have an Instructor role, shown with its own badge and left out of member counts. A convenor can issue a staff code, which a co-instructor or teaching assistant redeems under "Join a course as staff" on the account page; they are then added to every group site in the course, including sites that join later. Removing a staff member from the course removes them from every group site at once. When a site leaves the course, the course's staff are removed from that site's team.

  • Every member can publish, upload and upgrade — Publishing, uploading objects and upgrading the site are no longer limited to the convenor: collaborators and instructors can do all three. Commits are made by the Compositor's GitHub App, with the publisher named in the commit message. Thanks UCSB INT 138LA students for your feedback!

  • Repository access held by GitHub — The Compositor now adds each new member as a collaborator on the site's GitHub repository. GitHub requires the person to accept an invitation; it appears in the site-status pill and when they open the project, and they can accept it there without going to GitHub. The "Repository access" page shows convenors each member's state (access, invitation pending, invitation lapsed, none) and lets them reissue an invitation or withdraw access. Removing a member withdraws the access the Compositor gave. Members who joined before this release are not added automatically.

  • Contribution record — Each project has a record of who made and wrote what: items added, items written in, words written, and time spent in the Compositor, with the idle threshold stated beside it. Cataloguing objects counts as its own row. Every measure says what it does not capture, nothing is ranked or totalled, and everyone with access to the project can see it, in its own view and in the collaboration sidebar. It can be downloaded as a CSV, one row per person with a column for each measure; anyone with access to the project can download it. Authorship for content written before this release is recovered where the collaborative document still holds it and shown as unknown where it does not.

  • The story editor shows the step as published — The image viewer now fills the editor, and the step card, layer panels and controls sit over it as they do on the site from Telar 1.8.0: beside, below or over the object depending on the window, with video and audio steps laid out as the site lays them out. Title and section cards appear on the stage, a dashed line marks where the published card cuts the text, and the question, answer and layer-button label are edited in place, with pencil buttons beside each. Steps can be reordered from the keyboard. Capture now measures framing against the image and the region beside the card, so a captured view replays where the author left it; the capture viewer can no longer be rotated or mirrored, since a step records neither, and a click on the image no longer zooms.

  • Layer panels preview as the site renders them — Accordions, tabs, carousels, bibliographies, footnotes and KaTeX maths preview as the site will publish them, and the step answer renders through the same rules. Glossary callouts can be inserted from the Widget menu and preview as the site places them.

  • Footnote button — The layer panel toolbar has a Footnote button. It inserts the reference at the cursor and the note where the site will read it, and says so when the cursor is somewhere a note cannot go.

  • Answer length measured in lines — An answer may have up to 18 lines and five paragraphs, counting 53 characters to a line and two lines for each paragraph break. The editor shows the count as you write, answers over 15 lines publish in slightly smaller type, and a publish is blocked for an answer the site would cut, with a pointer to the layer panels for the detail.

  • Change a story's or an object's ID — "Change ID" renames a story (its files, its row in the project sheet and its steps together) or an object (its files and every step that uses it). The editor still opens a story from an address that uses an earlier ID.

  • Custom object fields — Custom columns in objects.csv are shown and edited on the object page, in the sheet's column order. Two people editing different custom fields of the same object no longer lose one of the edits. A publish blocked by a column the framework refuses offers to remove that column from the story, from every object or from every glossary term.

  • Glossary kinds — Each glossary entry has a kind, chosen from the standard kinds and the site's own, beside the entry title and as a column in the entry list; the preview shows the kind above the title. "Edit kinds" on the Glossary page adds and removes the site's own kinds, published to _config.yml.

  • More object formats — Audio files (MP3, OGG, M4A), PDF and WEBP can be uploaded. The upload dialog says "file" for what is picked from your disk and lists the accepted formats, and shows a placeholder rather than a preview for formats a browser cannot display.

  • Page chooser for multi-page objects — Picking a multi-page object for a step opens a chooser with page thumbnails and a page-number box, and a Change button in the bar reopens it. A new step starts from the previous one.

  • Imports from any default branch — Importing a repository whose default branch is not main now offers to rename it, or to make an existing main the default, instead of sending you to GitHub. An import the GitHub App cannot reach returns you to the connect step with your choices kept.

  • Colliding columns resolved in the Compositor — When two columns Telar reads as one each hold values, the upgrade, sync, first import and story restore let you choose which to keep, and commit the choice so the site's next build passes. Sheets named in Spanish (proyecto, objetos, glosario) are read as the site reads them.

  • Build workflow repair — The publish warning about an out-of-date build workflow now has an "Update the build workflow" button.

  • Restoring a project whose saving has stopped — If the Compositor stops saving a project's changes, the site-status pill says so and why, and the convenor can restore it from the last save.

  • Bug reports carry the site — The bug reporter records the repository, the site's Telar version, recent commits made outside the Compositor and the last failed publish, and asks what changed recently. Server error messages are never attached, since the issue is public.

Fixes

  • Edits made on GitHub are read, not overwritten — The sync and publish checks now read step CSVs, layer files and page files, not only the sheets. A story or page changed on GitHub is listed with a choice of version, and a publish no longer replaces a file the Compositor has not read. Object order in objects.csv, and object rows changed on GitHub, are carried in the same way.

  • Files keep their own layout — Publishing keeps each CSV's column order, header spelling, comment and instruction rows, and custom columns, including empty ones and custom columns in project.csv. A page keeps its whole front matter, with only the title edited. An imported story keeps the order of its steps and layers.

  • A failed read is never taken for a missing file — The import, sync, restore and publish now refuse with the file named when GitHub cannot be read, instead of treating the file as absent and offering every row as removed. Files over 1 MB can be read, and a file that is not valid UTF-8 is named with how to repair it.

  • Objects work finishes on the server — Uploaded objects are registered as soon as their commit lands, not when the uploader's tab sees the build finish, and a publish finishes any objects work still owed before reading. An object counts as ready only once its tiles exist on the deployed site. Deleted objects no longer return, and deleting an object removes every row carrying its ID and its files.

  • One language per site — A site is in one language, so the Compositor keeps one file per page. A new site starts without the template's other-language page files, and an imported site's other-language page files are dropped on import and deleted from GitHub the next time you publish.

  • Upgrades — An upgrade delivers the site's menu only where it has none, adds framework-owned page settings without touching the author's, stamps the release date the framework declares, and is checked against the latest release before it commits. The post-upgrade screen lists only the steps that apply to you, and the upgrade page names the site it acts on. The upgrade page lists every file the upgrade deletes, and an upgrade that would delete one it did not list stops before changing anything. The steps after an upgrade are shown in the interface language.

  • Characters that break a build — Characters a Telar build rejects, such as those carried in text pasted from a PDF, are removed on paste and before every commit. An object or glossary ID beginning with #, which Telar reads as a comment, is refused at publish.

  • Collaboration — An editor alone in a project, or with the tab in the background, stays connected instead of reconnecting every 30 seconds or every two minutes. Collaborators whose tabs are in the background no longer drop out of the presence list, and reconnecting a tab no longer removes collaborators from the same browser's other tabs. A cancelled input-method composition no longer leaves its text behind, and a save that fails after its field has closed brings the draft back next time the field is opened.

  • Private repositories — Importing a private repository is no longer refused. The wizard warns that GitHub Pages doesn't publish private repositories on free GitHub accounts, explains how to publish it (make the repository public or use a paid account), and asks you to confirm with Understood before you can continue.

  • Invitations and removals report what happened — Inviting someone without a Compositor account now gives you the invitation link to send them, since the Compositor sends no email; a refused invitation or member removal now says why.

  • Version gate — A site behind the latest Telar release keeps the Objects page open and refuses only the upload, and the upgrade page says why you were sent there.

  • Accessibility — Dialogs are announced as dialogs and hold focus, the Markdown and site-description toolbars work from the keyboard, and popovers near the bottom of the window open above their anchor.

  • Interface language — Sheet warnings and sync reasons are shown in the interface language, the GitHub App has one name in Spanish, and "Compositor" is capitalised wherever the interface names the product.

Security and stability

  • One publish or upgrade at a time — A publish, upgrade or objects commit now holds a lock on the site for the length of its request. No second one can begin while it stands, the Publish and Upgrade buttons say who holds it, and editing waits only while the request runs.

  • Editor freezes can no longer be forged — The "publishing" and "upgrading" freeze is now held by the server, so a member can no longer freeze every collaborator's editor from their own browser, and each connection can update only its own presence entry.

  • Writes act on the site the page was opened for — A write from a tab still showing one site, after another tab switched to a second site, is refused instead of being applied to the second site.

  • Membership is rechecked on open connections — A removed member's open connection stops writing. Deleting an account closes the person's live connections, and deleting a course detaches its sites and removes its staff from them.

  • Account deletion — An account that has contributed to another person's site can now be deleted. The account row is kept with the person's name only, so their credit in each project's history stays; a later sign-in creates a new account.

  • Unknown latest release pauses writes — When the latest Telar release cannot be read, publish, upload, objects commits and repository deletion pause instead of proceeding as though the site were current.

  • Redirect after upgrade — The upgrade page's return link no longer follows an off-site address passed in the URL.

  • Join codes are rate-limited — Failed join-code redemptions are counted per user per hour.

Data layer

Thirty-eight new D1 migrations. They add:

  • Course projects: course and parent-site links on projects, a course marker on objects, the Instructor role, reusable join codes with no use limit or expiry, a per-account course-access flag and a redemption rate limit.
  • Authorship and contributions: who last edited each entity, template authorship recorded as the template rather than a person, a table of who wrote in each entity with words written, an editing-time ledger, and a record of when a project's authorship was recovered.
  • Collaboration persistence: a generation and sequence on each project's saved document, and a write fence enforced by database triggers, so that only the current collaboration session can save a project.
  • Ordering: an order key on stories, steps, layers, objects, glossary terms and pages, so reordering never deletes and re-creates an entry.
  • File fidelity: kept custom columns for steps, glossary terms and project.csv, kept page front matter, the story file each story was read from, earlier story IDs, the page and story files the Compositor answers for, and the last commit whose objects.csv was read.
  • Objects work: a table recording objects operations until they finish, including ID changes.
  • Glossary: each entry's kind, and the site's own kinds.
  • Accounts and access: a deleted-account marker with triggers that keep a deleted account out of every membership, and each member's repository access and invitation state, with a table of access still to withdraw.
  • Identity: unique object IDs and glossary term IDs within a project.

Several of these migrations rebuild tables, and none of them can be rolled back.

Toolchain

  • Added: knap (Markdown and YAML front matter serialisation), katex (maths preview), entities (HTML entity decoding that matches the site build).
  • Test tooling: vitest 4 and @cloudflare/vitest-plugin, which runs part of the suite against real D1.

Thanks to the INT 138LA students at UCSB and the participants in the UT Austin workshop on September 14, and especially to @raymondvargas-byte, @anelicachu, @guadaluj1506, @savimoon305, @correadalej and @Roman-Empire26 for reporting bugs.

Acknowledgments

Telar is developed by Adelaida Ávila, Ana María Cárdenas Gasca, 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.


Esta es la versión pensada para la docencia: proyectos de curso con códigos para unirse y una colección de objetos compartida, un registro de lo que aporta cada persona al trabajo en grupo y la posibilidad de que cualquier integrante del grupo publique. El editor de historias se rehízo para mostrar cada paso tal como lo verán quienes visiten el sitio. Antes de publicar, el Compositor ahora lee los cambios hechos en GitHub en lugar de sobrescribirlos, y una larga serie de correcciones evita que el contenido escrito se pierda entre el Compositor y el sitio publicado.

Novedades

  • Proyectos de curso — Un proyecto puede ser ahora un proyecto de curso: quien lo coordina comparte sus objetos con todos los sitios de grupo que se unan a él. Los estudiantes se unen con el código de la clase, que sirve para varias personas, al crear el sitio o más tarde desde Configuración del sitio. En la lista de objetos de cada sitio, los objetos del curso llevan la marca "Objeto del curso" y no se pueden eliminar. La pestaña Curso muestra los sitios del curso y permite administrar sus códigos. Si eres docente y quieres probar esta función, escríbenos.

  • Docentes y código para docentes — Los cursos tienen un rol de Docente, con su propia etiqueta, que no se cuenta entre los integrantes. Quien coordina puede crear un código para docentes: otro docente o un monitor del curso lo escribe en "Unirse a un curso como docente", en la página Cuenta, y queda agregado a todos los sitios de grupo del curso, también a los que se unan después. Al quitar a alguien del equipo docente del curso, sale de todos los sitios de grupo a la vez. Cuando un sitio sale del curso, el equipo docente deja el equipo de ese sitio.

  • Cualquier integrante puede publicar, subir objetos y actualizar Telar — Publicar, subir objetos y actualizar Telar ya no son tareas exclusivas de quien coordina: colaboradores y docentes también pueden hacerlo. La App de GitHub del Compositor hace los commits, y cada mensaje de commit dice quién publicó. ¡Gracias a los estudiantes de INT 138LA de UCSB por sus comentarios!

  • Acceso al repositorio de GitHub — Ahora el Compositor agrega a cada persona que se une al proyecto como colaboradora del repositorio de GitHub del sitio. GitHub exige que la persona acepte una invitación. La invitación aparece en el indicador de estado del sitio y al abrir el proyecto, y se puede aceptar ahí mismo, sin ir a GitHub. La página "Acceso al repositorio" le muestra a quien coordina en qué va cada integrante (con acceso, invitación pendiente, invitación vencida o sin acceso) y le permite enviar una invitación nueva o retirar el acceso. Al quitar a alguien del proyecto, se le retira el acceso que le dio el Compositor. Quienes se unieron antes de esta versión no se agregan automáticamente.

  • Registro de participación — Cada proyecto tiene un registro de lo que hizo y escribió cada persona: elementos agregados, elementos en los que escribió, palabras escritas y tiempo en el Compositor, y al lado se explica a partir de cuánto tiempo sin actividad el reloj deja de contar. Las fichas de objetos se cuentan en su propia fila. Cada medida dice lo que no alcanza a registrar, no hay escalafón ni totales, y cualquier persona con acceso al proyecto puede verlo, en su propia vista y en el panel de colaboración, y descargarlo como CSV, con una fila por persona y una columna por medida. Para el contenido escrito antes de esta versión, la autoría se recupera cuando el Compositor todavía conserva ese dato, y aparece como desconocida cuando no.

  • El editor de historias muestra el paso como se va a publicar — El visor de imágenes ahora ocupa todo el editor, y la tarjeta del paso, los paneles de capa y los controles quedan encima, como en los sitios con Telar 1.8.0: al lado, debajo o encima del objeto según el tamaño de la ventana, y los pasos de video y audio se organizan como en el sitio. La portada y los títulos de sección también aparecen en el visor. Una línea discontinua marca dónde corta el texto la tarjeta publicada, y la pregunta, la respuesta y la etiqueta del botón de capa se editan ahí mismo, con un botón de lápiz al lado de cada una. Los pasos se pueden reordenar con el teclado. Capturar posición ahora mide el encuadre con respecto a la imagen y a la zona junto a la tarjeta, así que una vista capturada se ve igual a como se dejó. El visor de captura ya no se puede rotar ni voltear, porque un paso no guarda ninguna de las dos cosas, y un clic en la imagen ya no la acerca.

  • Los paneles de capa se ven como en el sitio — Los acordeones, las pestañas, los carruseles, las bibliografías, las notas al pie y las fórmulas de KaTeX aparecen en la vista previa tal como el sitio los publicará, y la respuesta del paso se muestra con las mismas reglas. Los recuadros del glosario se insertan desde el menú Widget y la vista previa los muestra donde los pondrá el sitio.

  • Botón Nota al pie — La barra de herramientas de los paneles de capa tiene un botón Nota al pie. Pone la llamada de nota donde está el cursor y la nota donde el sitio la va a buscar, y avisa cuando el cursor está en un lugar donde no puede ir una nota.

  • La respuesta se mide en líneas — Una respuesta puede tener hasta 18 líneas y cinco párrafos, contando 53 caracteres por línea y dos líneas más por cada párrafo después del primero. El editor muestra la cuenta mientras escribes. Las respuestas de más de 15 líneas se publican en letra un poco más pequeña, y no se puede publicar una respuesta que el sitio cortaría: el aviso remite a los paneles de capa para los detalles.

  • Cambiar el ID de una historia o de un objeto — "Cambiar ID" cambia el ID de una historia (sus archivos, su fila en la hoja del proyecto y sus pasos, todo junto) o de un objeto (sus archivos y todos los pasos que lo usan). El editor sigue abriendo una historia desde una dirección que use un ID anterior.

  • Campos personalizados de los objetos — Las columnas personalizadas de objects.csv se ven y se editan en la página del objeto, en el mismo orden que en la hoja. Si dos personas editan campos personalizados distintos del mismo objeto, ya no se pierde uno de los dos cambios. Cuando una columna que Telar no acepta impide publicar, el Compositor ofrece quitarla de la historia, de todos los objetos o de todos los términos del glosario.

  • Tipos de término del glosario — Cada término del glosario tiene un tipo, que se elige entre los tipos estándar y los propios del sitio. El tipo aparece junto al título del término y como columna en la lista de términos, y la vista previa lo muestra encima del título. Con "Editar tipos", en la página Glosario, se agregan y se eliminan los tipos propios del sitio, que se publican en _config.yml.

  • Más formatos de objeto — Ahora se pueden subir archivos de audio (MP3, OGG, M4A), PDF y WEBP. La ventana para subir objetos habla de "archivo" para lo que eliges de tu computador y lista los formatos aceptados. Para los formatos que un navegador no puede mostrar, dice «Sin vista previa» en lugar de mostrar la vista previa.

  • Elegir página en objetos de varias páginas — Al elegir un objeto de varias páginas para un paso, se abre un selector con miniaturas de las páginas y un campo para escribir el número de página. El botón Cambiar de la barra lo vuelve a abrir. Un paso nuevo arranca desde el anterior.

  • Importar desde cualquier rama predeterminada — Al importar un repositorio cuya rama predeterminada no es main, el Compositor ahora ofrece cambiarle el nombre, o poner como predeterminada una rama main que ya exista, en lugar de mandarte a GitHub. Si la App de GitHub no tiene acceso al repositorio que quieres importar, vuelves al paso de conexión sin perder lo que habías elegido.

  • Columnas que Telar lee como una sola, resueltas en el Compositor — Cuando dos columnas que Telar lee como una sola tienen valores, la actualización, la sincronización, la primera importación y la restauración de historias te dejan elegir cuál conservar, y guardan esa elección con un commit para que el sitio se pueda construir la próxima vez. Las hojas con nombre en español (proyecto, objetos, glosario) se leen como las lee el sitio.

  • Actualizar el flujo de trabajo desde el Compositor — El aviso de publicación sobre un flujo de trabajo de construcción desactualizado ahora tiene un botón "Actualizar el flujo de trabajo".

  • Restaurar un proyecto que dejó de guardarse — Si el Compositor deja de guardar los cambios de un proyecto, el indicador de estado del sitio lo avisa y explica por qué, y quien coordina puede restaurar el proyecto desde lo último que se guardó.

  • Los reportes de errores incluyen datos del sitio — El botón para reportar errores registra el repositorio, la versión de Telar del sitio, los commits recientes hechos por fuera del Compositor y la última publicación que falló, y pregunta qué cambió hace poco. Nunca adjunta mensajes de error del servidor, porque el reporte queda público en GitHub.

Correcciones

  • Los cambios hechos en GitHub se leen, no se sobrescriben — Al sincronizar y al publicar, el Compositor ahora revisa también los CSV de los pasos, los archivos de capas y los de las páginas, no solo las hojas. Si una historia o una página cambió en GitHub, aparece en una lista para que elijas qué versión conservar, y una publicación ya no reemplaza un archivo que el Compositor no ha leído. El orden de los objetos en objects.csv y las filas de objetos que cambiaron en GitHub se conservan de la misma manera.

  • Los archivos conservan su propio formato — Al publicar, cada CSV conserva el orden de sus columnas, la forma en que están escritos sus encabezados, sus filas de comentarios e instrucciones y sus columnas personalizadas, incluso las vacías y las de project.csv. Una página conserva todo su bloque de ajustes y solo cambia el título. Una historia importada conserva el orden de sus pasos y de sus capas.

  • Un archivo que no se pudo leer ya no se da por inexistente — Cuando no se puede leer GitHub, la importación, la sincronización, la restauración y la publicación ahora se detienen y dicen qué archivo falló, en lugar de dar el archivo por inexistente y presentar todas sus filas como eliminadas. Ya se pueden leer archivos de más de 1 MB, y si un archivo no está en UTF-8 válido, el Compositor lo nombra y explica cómo repararlo.

  • Los objetos subidos se terminan de procesar sin depender de la pestaña — Los objetos subidos quedan registrados en cuanto llega su commit, no cuando la pestaña de quien los subió ve que terminó la construcción, y antes de leer, una publicación termina el trabajo con objetos que haya quedado pendiente. Un objeto solo cuenta como listo cuando sus teselas (tiles) ya están en el sitio publicado. Los objetos eliminados ya no reaparecen, y al eliminar un objeto se eliminan sus archivos y todas las filas que llevan su ID.

  • Un solo idioma por sitio — Cada sitio está en un solo idioma, así que el Compositor mantiene un archivo por página. Un sitio nuevo empieza sin los archivos de páginas en el otro idioma que trae la plantilla. En un sitio importado, esos archivos se descartan al importar y se borran de GitHub la próxima vez que publiques.

  • Actualizaciones — Una actualización solo instala el menú del sitio cuando no tiene uno, agrega los ajustes de página que le corresponden a Telar sin tocar los que ya tenía la página, pone la fecha de la versión que declara Telar y, antes de hacer el commit, se verifica contra la versión más reciente. La pantalla que aparece después de actualizar muestra solo los pasos que te corresponden, y la página de actualización dice a qué sitio se aplica. Esa página lista todos los archivos que la actualización va a borrar, y si una actualización fuera a borrar uno que no está en la lista, se detiene antes de cambiar nada. Los pasos que siguen a una actualización se muestran en el idioma de la interfaz.

  • Caracteres que impiden construir el sitio — Los caracteres que Telar rechaza al construir el sitio, como los que vienen en un texto pegado desde un PDF, se eliminan al pegar y antes de cada commit. Un ID de objeto o de término del glosario que empiece por #, que Telar lee como comentario, se rechaza al publicar.

  • Colaboración — Quien edita a solas en un proyecto, o con la pestaña en segundo plano, ya no pierde la conexión cada 30 segundos o cada dos minutos. Las personas con la pestaña en segundo plano ya no desaparecen de la lista de conectados, y reconectar una pestaña ya no hace desaparecer a quienes colaboran desde otras pestañas del mismo navegador. Si se cancela lo que se estaba escribiendo con un método de entrada (como los que se usan para otros alfabetos), ese texto ya no queda en el campo, y si un cambio no se guarda después de cerrar el campo, el borrador reaparece la próxima vez que lo abras.

  • Repositorios privados — Ya se pueden importar repositorios privados. El asistente avisa que GitHub Pages no publica repositorios privados en las cuentas gratuitas de GitHub, explica cómo publicarlo (hacer público el repositorio o usar una cuenta de pago) y pide confirmar con "Entendido" antes de continuar.

  • Al invitar o quitar a alguien, el Compositor dice qué pasó — Al invitar a alguien que no tiene cuenta en el Compositor, ahora recibes el enlace de invitación para mandárselo, porque el Compositor no envía correos. Si una invitación no se puede enviar o alguien no se puede quitar del equipo, el mensaje dice por qué.

  • Sitios con una versión anterior de Telar — Si un sitio no tiene la versión más reciente de Telar, la página Objetos sigue abierta y solo se bloquea la subida de archivos, y la página de actualización explica por qué te llevó ahí.

  • Accesibilidad — Los lectores de pantalla anuncian las ventanas de diálogo como tales y el foco se queda dentro de ellas. Las barras de herramientas de Markdown y de la descripción del sitio funcionan con el teclado, y los menús emergentes que quedan cerca del borde inferior de la ventana se abren por encima del elemento que los despliega.

  • Idioma de la interfaz — Las advertencias sobre las hojas y los motivos de la sincronización se muestran en el idioma de la interfaz, la App de GitHub tiene un solo nombre en español y "Compositor" va con mayúscula siempre que la interfaz nombra el producto.

Seguridad y estabilidad

  • Una sola publicación o actualización a la vez — Mientras se ejecuta una publicación, una actualización o se agregan objetos, el sitio queda reservado para esa operación: nadie puede empezar otra, los botones Publicar y Actualizar dicen quién la está haciendo, y la edición solo queda en pausa mientras dura.

  • Nadie puede pausar el editor de los demás desde su navegador — La pausa de "publicando" y "actualizando" ahora la controla el servidor, así que una persona del equipo ya no puede pausar el editor de todas las demás desde su propio navegador, y cada conexión solo puede cambiar su propia entrada en la lista de conectados.

  • Cada cambio va al sitio que muestra la pestaña — Si una pestaña todavía muestra un sitio después de que otra pestaña cambió a un segundo sitio, los cambios hechos desde la primera se rechazan en lugar de aplicarse al segundo sitio.

  • Las conexiones abiertas vuelven a comprobar quién está en el equipo — Cuando se quita a alguien del equipo, su conexión abierta deja de guardar cambios. Al eliminar una cuenta se cierran las conexiones activas de esa persona, y al eliminar un curso se desvinculan sus sitios y el equipo docente sale de ellos.

  • Eliminar la cuenta — Ahora se puede eliminar una cuenta que ha contribuido al sitio de otra persona. De la cuenta solo se conserva el nombre, para que su crédito en el historial de cada proyecto se mantenga. Si la persona vuelve a iniciar sesión, se crea una cuenta nueva.

  • Si no se sabe cuál es la versión más reciente, se pausan los cambios — Cuando no se puede consultar la versión más reciente de Telar, la publicación, la subida de objetos, el guardado de objetos en GitHub y la eliminación del repositorio quedan en pausa, en lugar de seguir como si el sitio estuviera al día.

  • Redirección después de actualizar — El enlace para volver de la página de actualización ya no sigue una dirección externa que venga en la URL.

  • Límite de intentos con los códigos — Los intentos fallidos de usar un código se cuentan por persona y por hora.

Capa de datos

Treinta y ocho migraciones nuevas de D1. Agregan:

  • Proyectos de curso: vínculos al curso y al sitio padre en los proyectos, una marca de curso en los objetos, el rol de Docente, códigos reutilizables sin límite de usos ni vencimiento, un indicador por cuenta de acceso a cursos y un límite de intentos para usar los códigos.
  • Autoría y participación: quién editó por última vez cada entidad, la autoría de la plantilla registrada como plantilla y no como persona, una tabla de quién escribió en cada entidad con las palabras escritas, un registro del tiempo de edición y una marca de cuándo se recuperó la autoría de un proyecto.
  • Persistencia de la colaboración: una generación y una secuencia en el documento guardado de cada proyecto, y una barrera de escritura que imponen disparadores (triggers) de la base de datos, para que solo la sesión de colaboración vigente pueda guardar un proyecto.
  • Orden: una clave de orden en historias, pasos, capas, objetos, términos del glosario y páginas, para que reordenar nunca elimine y vuelva a crear una entrada.
  • Fidelidad de los archivos: las columnas personalizadas conservadas de los pasos, de los términos del glosario y de project.csv; el bloque de ajustes conservado de las páginas; el archivo del que se leyó cada historia; los ID anteriores de las historias; los archivos de páginas y de historias de los que responde el Compositor, y el último commit cuyo objects.csv se leyó.
  • Objetos: una tabla que registra las operaciones con objetos hasta que terminan, incluidos los cambios de ID.
  • Glosario: el tipo de cada término y los tipos propios del sitio.
  • Cuentas y acceso: una marca de cuenta eliminada, con disparadores que mantienen una cuenta eliminada fuera de todos los equipos, y el estado de acceso al repositorio y de invitación de cada integrante, con una tabla de los accesos que falta retirar.
  • Identidad: ID de objeto e ID de término del glosario únicos dentro de cada proyecto.

Varias de estas migraciones reconstruyen tablas, y ninguna se puede revertir.

Herramientas

  • Nuevas: knap (serialización de Markdown y del front matter YAML), katex (vista previa de fórmulas), entities (decodificación de entidades HTML igual a la que hace la construcción del sitio).
  • Pruebas: vitest 4 y @cloudflare/vitest-plugin, que ejecuta parte de las pruebas contra una base de datos D1 real.

Gracias a los estudiantes de INT 138LA de UCSB, a quienes participaron en el taller del 14 de septiembre en UT Austin y, en especial, a @raymondvargas-byte, @anelicachu, @guadaluj1506, @savimoon305, @correadalej y @Roman-Empire26 por reportar errores.

Agradecimientos

Telar es desarrollado por Adelaida Ávila, Ana María Cárdenas Gasca, 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.