HomeMarcado e interfaz

Marcado e interfaz

El marcado

Empleamos la norma P5 de la Text Encoding Initiative (TEI) sin ninguna personalización del esquema.

La representación del original

Para representar el texto original, usamos de forma estándar los elementos <pb>, <p>, <lb>, <add>, <del> para marcar respectivamente los saltos de página, los párrafos, los renglones, y las secciones de texto insertadas y tachadas. Utilizamos <hi rend="superscript"> para señalar las letras que aparecen en superíndice. Cuando podemos conjeturar con alguna seguridad sobre letras o palabras que no podemos leer por algún defecto del documento o la imagen, usamos <supplied>. Indicamos las secciones que no se pueden recuperar con <gap/>. Marcamos las notas escritas por el autor o por otra persona en algún momento posterior a la creación del documento con <note type="authorial">.

La regularización

Para representar el texto original y nuestra versión parcialmente regularizada en un mismo archivo, utilizamos el elemento <choice> con <orig> y <reg> (para modernizar), <abbr> y <expan> (para expandir las abreviaturas), y <sic> y <corr> (para corregir las erratas evidentes), como en los siguientes ejemplos:

<choice><orig>exerse</orig><reg>ejerce</reg></choice>

<choice><abbr>dho</abbr><expan>dicho</expan></choice>

<choice><sic>debueban</sic><corr>devuelvan</corr></choice>

Utilizamos <hi rend="superscript"> cuando las abreviaturas tienen letras en superíndice:

<choice><abbr>p.<hi style="superscript">r</hi></abbr><expan>por</expan></choice>

El marcado semántico

Marcamos los nombres de las personas, los lugares, las organizaciones (entendidas como cualquier agrupación oficial de personas), y los eventos con <name> y añadimos un valor correspondiente para subtype:

<name type="person">

<name type="place">

<name type="organization">

<name type="event">

Usamos <date when="YYYY-MM-DD" para marcar las fechas:

En <date when="1786-12-16"><choice><orig>dies y seis</orig><reg>dieciséis</reg></choice> de dicho mes y año</date>

Para marcar las firmas, utilizamos

<seg type="signature">

Las notas editoriales

Para agregar las notas editoriales, usamos <seg type="note"> para señalar la sección del texto a que corresponde la anotación, y <note type="editorial"> para documentar el contenido de la nota.

<seg type="note">dimanado<note type="editorial"><mentioned>dimanar</mentioned> 'provenir' (<title level="m"><ref target="florida-abreviaturas.xml#dle">DLE</ref></title>)</note></seg>

Cuando aquel contenido reside en otro documento, usamos un valor de "import" para el atributo subtype de <note>:

<seg type="note">jure y declare<choice><orig/><reg>,</reg></choice><note type="editorial" subtype="import"><ref target="florida-notas-comunes.xml#jure-y-declare"/></note></seg>

(Todos los ejemplos proveídos en esta sección corresponden al siguiente documento: Don Ramón de Fuentes solicitando permiso para contraer matrimonio con doña María de la Concepción Perry, San Agustín, 14 de diciembre de 1786.)

La interfaz

El sitio web de coloniaLab utiliza la plataforma Omeka. Utilizamos los plug-ins Simple Pages para presentar las páginas informativas y Connected Carousel para habilitar la galería de fotos. Organizamos los documents en varias colecciones temáticas que corresponden por lo general a las agrupaciones que llamamos series. Mostramos cada archivo XML dentro del correspondiente elemento Omeka a través de la introducción de una etiqueta HTML <iframe> en el campo de texto dentro de los metadatos de Dublin Core. Damos también la opción de abrir cada documento en otra ventana.

Para visualizar los archivos XML utilizamos dos herramientas diferentes. Desde 2016 hemos usado una adaptación de TEI Boilerplate, una aplicación extensible desarrollada en Indiana University por John Walsh, Grant Simpson, y Saeed Moaddeli. TEI Boilerplate utiliza XSLT, JavaScript y CSS para convertir el archivo XML en una página escrita en HTML. La modificación principal que realizamos es la introducción de opciones para mostrar el archivo desde cuatro perspectivas: una transcripción diplomática, una versión regularizada, una visualización de las intervenciones editoriales, y una representación que resalta el marcado semántico. También añadimos la capacidad de esconder las notas y agregamos lógica para mostrar los metadatos básicos del archivo al final de la página, incluyendo un enlace al elemento correspondiente de Omeka. Todavía mostramos la mayoría de los documentos publicados en este sitio utilizando esta adaptación de TEI-Boilerplate.

En diciembre de 2024 empezamos a desarrollar nuestro propio visualizador (colonialab-display.html). Consiste en una página HTML que recibe el nombre del archivo XML como el parámetro id en la cadena de consulta (query string), abre aquel archivo y lo visualiza usando JavaScript y CSS (a diferencia de TEI Boilerplate, nuestra aplicación no emplea XSLT). Como en el caso de TEI Boilerplate, incluimos lógica para mostrar la imagen que se registra en el atributo facs de cada elemento <pb> y transforma los elementos <ref> en etiquetas <a> de HTML. Para visualizar las notas, nuestra aplicación subraya la sección del texto a que corresponde cada notas, y demuestra el contenido de la notas a través de una información sobre herramientas (tool tip). Recoge de otro archivo XML (por ejemplo, de florida-notas-comunes.xml) las anotaciones que se repiten y que se comparten entre varios documentos.

El visualizador también sirve para mostrar las páginas que no son ediciones sino componentes del aparato crítico, como la bibliografía de las notas y la lista de abreviaturas (ver, por ejemplo, Serie Florida: Abreviaturas). En este caso, pasamos un valor de "no" para dos parámetros en la cadena de consulta: options (para esconder el selector de hoja de estilo) y details (para esconder los detalles del documento en el bloque de metadatos al final de la página).

Actualmente utilizamos esta nueva herramienta para mostrar algunos de los documentos de la serie Florida. Ver, por ejemplo, Carta de Francisco de Córcoles y Martínez a Felipe V, San Agustín de la Florida, 5 de julio de 1715; Don Ramón de Fuentes solicitando permiso para contraer matrimonio con doña María de la Concepción Perry, San Agustín, 14 de diciembre de 1786; y Carta de Benito de Pangua a Enrique White sobre un posible espía, batería de Quesada, 1 de enero de 1797. También usamos colonialab-display.html para presentar las seis cartas de libertad de Javiera Londoño de 1767 que forman parte de la serie Antioquia.

Markup

We use the Text Encoding Initiative (TEI) P5 standard without any schema customization.

The representation of the original

To represent the original text, we use <pb>, <p>, <lb>, <add>, and <del> to mark page breaks, paragraphs, lines, and inserted and struck-through sections of text, respectively. We use <hi rend="superscript"> to denote superscript letters. When we can guess with some certainty about letters or words that cannot be read because of defects in the document or image, we use <supplied>. We indicate sections that cannot be recovered with <gap/>. We mark notes written by the author or someone else after the document was created with <note type="authorial">.

Regularization

To represent the original text and our partially regularized version in a single file, we use the <choice> element with <orig> and <reg> (to modernize), <abbr> and <expan> (to expand abbreviations), and <sic> and <corr> (to correct obvious typos), as in the following examples:

<choice><orig>exerse</orig><reg>ejerce</reg></choice>

<choice><abbr>dho</abbr><expan>dicho</expan></choice>

<choice><sic>debueban</sic><corr>devuelvan</corr></choice>

We use <hi rend="superscript"> when abbreviations contain letters in superscript:

<choice><abbr>p.<hi style="superscript">r</hi></abbr><expan>por</expan></choice>

Semantic markup

We mark the names of people, places, organizations (understood as any official grouping of people), and events with <name> and add a corresponding value for @subtype:

<name type="person">

<name type="place">

<name type="organization">

<name type="event">

We use <date when="YYYY-MM-DD"> to mark up dates:

En <date when="1786-12-16"><choice><orig>dies y seis</orig><reg>dieciséis</reg></choice> de dicho mes y año</date>

To encode signatures, we use:

<seg type="signature">

Editorial notes

We use <seg type="note"> to indicate the section of the text to which an editorial annotation corresponds, and <note type="editorial"> to provide the content of the note.

<seg type="note">dimanado<note type="editorial"><mentioned>dimanar</mentioned> 'provenir' (<title level="m"><ref target="florida-abreviaturas.xml#dle">DLE</ref></title>)</note></seg>

When the content resides in another document, we use a value of "import" for the subtype attribute of the <note> element:

<seg type="note">jure y declare<choice><orig/><reg>,</reg></choice><note type="editorial" subtype="import"><ref target="florida-notas-comunes.xml#jure-y-declare"/></note></seg>

(All the examples in this section correspond to Don Ramón de Fuentes solicitando permiso para contraer matrimonio con doña María de la Concepción Perry, San Agustín, 14 de diciembre de 1786.)

Interface

The coloniaLab website uses the Omeka platform. We use the Simple Pages plug-in to present the informational pages and Connected Carousel to enable the photo gallery. We organize the documents into several thematic collections, which generally correspond to the groupings we call series. We display each XML file within the corresponding Omeka element by inserting an HTML <iframe> tag in the text field within the Dublin Core metadata. We also offer the option to open each document in a separate tab or window.

To view XML files, we use two different tools. Since 2016, we have employed an adaptation of TEI Boilerplate, an extensible application developed at Indiana University by John Walsh, Grant Simpson, and Saeed Moaddeli. TEI Boilerplate uses XSLT, JavaScript, and CSS to convert the XML file into a page written in HTML. The main modification we made is the introduction of options to display the file from four perspectives: a diplomatic transcription, a regularized version, a display of editorial interventions, and a view that highlights semantic markup. We also added the ability to hide notes and added logic to display basic file metadata at the bottom of the page, including a link to the corresponding Omeka element. We continue to display most of the documents published on this site using this adaptation of TEI Boilerplate.

In December 2024, we began developing our own viewer (colonialab-display.html). This tool consists of an HTML page that receives the name of the XML file as the id parameter in the query string, opens that file, and displays it using JavaScript and CSS (unlike TEI Boilerplate, our application does not use XSLT). As with TEI Boilerplate, we include logic to display the image recorded in the facs attribute of each <pb> element and transforms the <ref> elements into HTML <a> tags. To display the notes, our application highlights the section of text to which each note corresponds and reveals the content of the notes through a tooltip. The interface retrieves common annotations shared across multiple documents from another XML file (e.g., florida-common-notes.xml).

The viewer can also be used to display pages that are not documents but rather components of the critical apparatus, such as the bibliography of notes and the list of abbreviations (see, for example, Serie Florida: Abreviaturas). In this case, we pass a value of "no" for two parameters in the query string: options (to hide the style sheet selector) and details (to hide the document details in the metadata block at the bottom of the page).

We currently use this new tool to display some of the documents in the Florida Series. See, for example, Carta de Francisco de Córcoles y Martínez a Felipe V, San Agustín de la Florida, 5 de julio de 1715; Don Ramón de Fuentes solicitando permiso para contraer matrimonio con doña María de la Concepción Perry, San Agustín, 14 de diciembre de 1786; and Carta de Benito de Pangua a Enrique White sobre un posible espía, batería de Quesada, 1 de enero de 1797. We also use colonialab-display.html to present the six letters of freedom that Javiera Londoño issued in 1767, part of the Antioquia Series.