Skip to content

v1.5.5-beta

Choose a tag to compare

@juancobo juancobo released this 16 Oct 22:13
· 34 commits to main since this release
3f4e864

A redesigned check against GitHub, fields that show they can be edited and protect what they change, and messages that say what actually happened.

Changes made on GitHub

  • One review for changes made on GitHub — When someone edits your site directly on GitHub, the status at the top of the page says so, and one review lists each change with its own choice: keep GitHub's version or the Compositor's. A change made only on GitHub starts on GitHub's version; a change made in both places waits for you to choose. The review opens over the page you are on, from the status, the Publish page or the Upgrade Telar page.
  • Three states instead of one — "Changes on GitHub" appears only when a commit since your last publish changes something the Compositor keeps. A site not yet published from the Compositor says so, and a check that could not be made, for example while GitHub is limiting requests, says that instead of claiming changes.
  • Everything in one place — Files the Compositor could not read, images added on GitHub with no object, and stories or terms deleted on GitHub all appear in the same review as items to decide. The Objects page no longer has a sync of its own.
  • Collaborators and instructors see the state and who chooses, without controls they cannot use.
  • An imported site's first publish reviews the edits made on GitHub since the import instead of overwriting them.
  • An About page in two languages — When a site holds both about.md and acerca.md, the Publish page asks which one to keep.

Editing

  • Fields that look editable — Page titles, glossary term titles, and the title, subtitle and byline on a story's title card show that they can be edited before you hover over them.
  • IDs and addresses that ask first — Story and term IDs, page addresses, and the Site URL and Base URL are locked until you choose Change. Typing is limited to the characters the site can use, the consequence is stated, and nothing changes until you confirm. A page address the site already uses for something else is refused.
  • Story settings open in a panel beside the stage.
  • A new object's ID is shown before you upload, and the ID you see is the one it keeps.
  • Your About page — While your site's About page still has the text every new Telar site starts with, the Publish page suggests making it your own, with a link that opens the page in the editor. It does not stop you publishing, and it goes away once you change the text.

Fixes

  • Sites whose project sheet has no story_id column — Importing such a site dropped its stories, and its first publish then took them off the live site. Stories are now read by their order number, as Telar reads them.
  • Stories marked Draft — When a publish would take stories off your live site, the Publish page now names them.
  • The glossary definition of "telar" — Telar shipped the definition of the term telar in English and Spanish, one after the other. When you upgrade Telar from the Compositor and that definition is unchanged, only the paragraph in your site's language is kept, on GitHub and in the Compositor. If someone edits it while the upgrade is running, their version is kept.
  • Checks that missed your latest edits — Choosing Check again on the Publish page now takes in what you last wrote in the editor. If that could not be saved first, the page says so.
  • Messages that claimed what had not been checked — The Publish page lists only the checks it ran; the Upgrade Telar page says what an upgrade can change and how its build ended, and no longer tells a site already on the latest release that it was just upgraded; onboarding no longer finishes when it could not check your settings; and the object delete dialog says what each choice does.
  • Sites never published from the Compositor — The unpublished-changes window, opened from the status at the top of the page, now says the site hasn't been published from the Compositor yet, instead of showing a dash where the date would be.
  • Checking an object's IIIF manifest — On the Objects page, the line under a newly added IIIF object says whether its manifest loaded. If it couldn't be loaded, or what loaded isn't a manifest, it tells you to open the object and check its Source URL.

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.


Una nueva revisión de los cambios hechos en GitHub, campos que se ven editables y que piden confirmación antes de un cambio con consecuencias, y mensajes que dicen lo que de verdad pasó.

Cambios hechos en GitHub

  • Una sola revisión para los cambios hechos en GitHub — Cuando alguien edita tu sitio directamente en GitHub, el indicador de estado de la parte superior de la página lo avisa, y en una sola revisión ves cada cambio y eliges, para cada uno, si usar la versión de GitHub o conservar la del Compositor. Si un cambio se hizo solo en GitHub, ya viene elegida la versión de GitHub; si se hizo en los dos lados, la revisión espera a que elijas. Puedes abrirla desde el indicador de estado, desde Publicar o desde Actualizar Telar, y se abre encima de la página en la que estás.
  • Tres estados en lugar de uno — "Cambios en GitHub" solo aparece cuando un commit posterior a tu última publicación cambia algo que el Compositor gestiona. Si el sitio todavía no se ha publicado desde el Compositor, el indicador lo dice. Si no se pudo revisar GitHub, por ejemplo porque GitHub recibió demasiadas solicitudes en poco tiempo, el indicador lo dice en lugar de anunciar cambios.
  • Todo en un mismo lugar — Los archivos que el Compositor no pudo leer, las imágenes que se agregaron en GitHub sin un objeto asociado y las historias o términos del glosario que se eliminaron en GitHub aparecen en la misma revisión, para que decidas qué hacer con cada uno. La página Objetos ya no tiene una sincronización aparte.
  • Colaboradores/as y docentes ven qué cambió en GitHub y quién va a decidir, sin botones que no pueden usar.
  • La primera publicación de un sitio importado revisa los cambios hechos en GitHub después de la importación, en lugar de sobrescribirlos.
  • Una página Acerca de en dos idiomas — Si un sitio tiene about.md y acerca.md, la página Publicar pregunta cuál conservar.

Edición

  • Campos que se ven editables — Los títulos de las páginas, los títulos de los términos del glosario, y el título, el subtítulo y la firma de la Portada de una historia se ven editables sin necesidad de pasar el cursor por encima.
  • Cambiar un ID o una dirección pide confirmación — Los ID de historias y términos, las direcciones de las páginas, la URL del sitio y la URL base quedan bloqueados hasta que haces clic en Cambiar. Solo se pueden escribir los caracteres que el sitio puede usar, el Compositor te explica qué va a pasar y nada cambia hasta que confirmas. Tampoco se acepta una dirección de página que el sitio ya use para otra cosa.
  • Configuración de la historia se abre ahora en un panel al lado de la vista previa.
  • El ID de un objeto nuevo aparece antes de subirlo, y es el mismo que queda guardado.
  • Tu página Acerca de — Mientras tu página Acerca de conserve el texto con el que empiezan todos los sitios nuevos de Telar, la página Publicar te sugiere reescribirla y te da un enlace para abrirla en el editor. La sugerencia no impide publicar y desaparece en cuanto cambias el texto.

Correcciones

  • Sitios cuya hoja de proyecto no tiene la columna story_id — Al importar un sitio así se perdían sus historias, y la primera publicación las quitaba del sitio publicado. Ahora el Compositor identifica las historias por su número de orden, como hace Telar.
  • Historias marcadas como borrador — Si al publicar van a desaparecer historias del sitio publicado, la página Publicar ahora dice cuáles.
  • La definición de «telar» en el glosario — Telar traía la definición del término telar en dos párrafos, uno en inglés y otro en español. Al actualizar Telar desde el Compositor, si nadie ha cambiado esa definición, queda solo el párrafo en el idioma de tu sitio, tanto en GitHub como en el Compositor. Si alguien la edita durante la actualización, se conserva la versión editada.
  • Verificaciones que no tenían en cuenta tus últimos cambios — Al hacer clic en Verificar de nuevo, en la página Publicar, las verificaciones ahora tienen en cuenta lo último que escribiste en el editor. Si eso no se pudo guardar antes de verificar, la página lo dice.
  • Mensajes que afirmaban lo que no se había revisado — La página Publicar muestra solo las comprobaciones que de verdad hizo. Actualizar Telar dice qué puede cambiar una actualización y cómo terminó la construcción del sitio, y si el sitio ya tenía la versión más reciente, ya no dice que se acaba de actualizar. La configuración inicial ya no se da por terminada si no pudo comprobar los ajustes del sitio. Y el diálogo para eliminar un objeto explica qué hace cada opción.
  • Sitios que nunca se han publicado desde el Compositor — La ventana de cambios sin publicar, que se abre desde el indicador de estado de la parte superior de la página, ahora dice que el sitio todavía no se ha publicado desde el Compositor, en lugar de mostrar una raya donde iría la fecha.
  • Comprobar el manifiesto IIIF de un objeto — En la página Objetos, la línea bajo un objeto IIIF recién agregado dice si se cargó el manifiesto. Si no se pudo cargar, o si lo que se cargó no es un manifiesto, te pide que abras el objeto y revises el campo «URL de la fuente».

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.