Elementos comunes de todo documento TEI

En primer lugar, conviene recordar que el sistema de codificación TEI se divide en módulos, cada uno destinado a una tipología textual: verso, drama, transcripciones de discurso, diccionarios, etc. Cada uno de estos módulos es descrito en las Guías directrices. A su vez, los módulos pueden ser obligatorios u optativos. Así, los módulos obligatorios son cuatro: tei, core, header, textstructure; sin estos no tendríamos un documento válido. Los módulos optativos, en cambio, responden a tipologías textuales concretas y los veremos con más detalle en la Lección 4: Las Guías directrices de la Text Encoding Initiative, su manejo y su traducción al español.

Ahora, veremos aquellos elementos generales y comunes en todos los documentos TEI, como pueden ser párrafos, cuestiones de puntuación o de tipografía, nombres, fechas, abreviaturas, listas, notas a pie de página o de otra naturaleza, indexación, entre otros aspectos. Todos estos elementos se encuentran explicados en la sección "3. Elements Available in All TEI Documents" de las Guías directrices.

Más arriba vimos aquellos elementos que constituían la estructura obligatoria y básica de un documento TEI. Vamos, aquí, a centrarnos en el módulo llamado «core», que contiene una serie de elementos o etiquetas que pueden utilizarse en cualquier documento, incluso en la versión más minimalista TEI Lite. La panorámica que ofreceremos no es completa, pero corresponde a los más utilizados.

Vamos a dividir los elementos en: Párrafos, Cuestiones de puntuación, Elementos tipográficos, Citas, Nombres, números, fechas, Listas, notas, anotaciones, indexación, referencias, y un último apartado con Otros elementos frecuentemente utilizados.

Párrafos

El párrafo es la unidad más pequeña en la que un texto en prosa puede dividirse. El elemento utilizado para marcar los párrafos es <p>.

<p>El único defecto que hallan en mi es el de que estoy muy delgadito, a fuerza de estudiar. Para que engorde se proponen no dejarme estudiar ni leer un papel mientras aquí permanezca, y además hacerme comer cuantos primores de cocina y de repostería se confeccionan en el lugar. Está visto: quieren cebarme. No hay familia conocida que no me haya enviado algún obsequio. Ya me envían una torta de bizcocho, ya un cuajado, ya una pirámide de piñonate, ya un tarro de almibar.</p>
<p>Los obsequios que me hacen no son sólo estos presentes enviados a casa, sino que también me han convidado a comer tres o cuatro personas de las más importantes del lugar.</p>
<p>Mañana como en casa de la famosa Pepita Jiménez, de quien Vd. habrá oído hablar sinduda alguna. Nadie ignora aquí que mi padre la pretende.</p>

(Juan Valera, Pepita Jiménez, Cap. I)

En los casos, por ejemplo, que quisiéramos dividir ulteriormente un párrafo, podríamos utilizar otros elementos como <s> (segment) para dividir otro tipo de segmentos, como por ejemplo, las frases:

<s type="frase">El único defecto que hallan en mí es el de que estoy muy delgadito, a fuerza de estudiar.</s> 
<s type="frase">Para que engorde se proponen no dejarme estudiar ni leer un papel mientras aquí permanezca, y además hacerme comer cuantos primores de cocina y de repostería se confeccionan en el lugar.</s> 
<s type="frase">Está visto: quieren cebarme.</s> 
<s>No hay familia conocida que no me haya enviado algún obsequio.</s> 
<s type="frase">Ya me envían una torta de bizcocho, ya un cuajado, ya una pirámide de piñonate, ya un tarro de almíbar.</s>

(Juan Valera, Pepita Jiménez, Cap. I)

El elemento <p> puede contener una gran variedad de atributos (por ejemplo, type o xml:id) y elementos en su interior, prácticamente todos los que veremos a continuación.

Puntuación

De manera general, y especialmente en prosa, la puntuación del texto no suele codificarse; pero en algunos casos donde el marcado debe ser extremadamente sutil, se puede marcar. El elemento utilizado es:

• <pc> (punctuation character): utilizado para codificar el punto, el signo de interrogación y de exclamación, los puntos suspensivos, las comillas (aunque podrían eliminarse si se utiliza <q> o <quote>), apóstrofes, paréntesis, etc.

<s>
<seg>Está visto<pc>:</pc></seg> 
<seg>quieren cebarme</seg><pc>.</pc>
</s>

La codificación de la puntuación puede ser interesante en aquellos casos en que se quiera dar fe de los diferentes cambios a lo largo de la historia. A veces, la ausencia o presencia de un punto, por ejemplo, puede cambiar el sentido.

Elementos tipográficos

Todos los textos impresos poseen elementos tipográficos diversos como pueden ser la cursiva, la negrita, las versalitas, incluso fuentes diversas, tamaño de la fuente, etc. La naturaleza de estos elementos tipográficos en las fuentes escritas pueden ser de diversa naturaleza:

• una palabra o frase en una lengua extranjera, un arcaísmo, un barbarismo, una palabra técnica, etc.
• una palabra o frase sobre la que se quiere poner un énfasis especial, que se resaltaría al hablar.
• un palabra o frase que en realidad no forma parte del discurso del texto, como las referencias cruzadas, los títulos o los encabezados, etc.
• cadenas narrativas diferentes, como un monólogo interno o un comentario.
• la atribución a una referencia externa al texto, como un discurso directo o una citación.

Ahora bien, como explicamos anteriormente, el sistema TEI no se concentra tanto en la apariencia del texto como en señalar qué son las cosas. De esta manera, al encontrarnos, por ejemplo con un extranjerismo, quizás no nos interesará tanto señalar que aparece en cursiva, como indicar que se trata de una palabra extranjera. Sea cual sea la opción que se elija, TEI ofrece la posibilidad de marcar estos elementos tipográficos de una manera general, sin implicaciones semánticas. El elemento utilizado a tal propósito es <hi> (highlight), que por lo general suele tener un atributo @rend (rendition) que indica de qué manera aparece en el texto:

<hi rend="italic">Palabra o frase en cursiva</hi>
<hi rend="bold">Palabra o frase en negrita</hi>
<hi rend="small-caps">Palabra o frase en versalitas</hi>

El valor de los elementos es libre, con lo cual nada nos impide señalarlo en otra lengua, por ejemplo:

<hi rend="cursiva">Palabra o frase en cursiva</hi>

Podemos encontrar además otros elementos que responden a las tipografías diversas anteriormente mencionadas:

• <foreign> indica una palabra o frase perteneciente a otra lengua; normalmente posee el atributo @xml:lang para definir la lengua. Por ejemplo,

<p>El papa Francisco recuerda los conflictos activos en el mundo en la bendición 
<foreign xml:lang="lat">urbi et orbi</foreign></p>

Te espero en el <foreign xml:lang="en">lobby</foreign>

• [<emph>]() indica una palabra o frase a la que se atribuye un énfasis especial:

<p>Aquí, como en todas partes, la gente es muy aficionada al dinero. Y digo mal <emph>como en todas partes</emph>: en las ciudades populosas, en los grandes centros de civilización, hay otras distinciones que se ambicionan tanto o más que el dinero, porque abren camino y dan crédito y consideración en el mundo</p>

• <distinct> indica un término diferente lingüísticamente (arcaísmo, tecnicismo, dialectalismo, coloquialismo, etc.).
• <mentioned> es utilizado para señalar una palabra mencionada o citada.
• <soCalled> contiene una palabra o expresión respecto a la cual el autor manifiesta su rechazo de responsabilidad:

<p>El mencionado <soCalled>manuscrito</soCalled>, fielmente trasladado a la estampa, es como sigue.</p>

Citas

La marcas tipográficas también pueden utilizarse, como es sabido, para señalar citas de diferente naturaleza, ya sea un pensamiento, un discurso indirecto o directo, o incluso una cita literaria o bibliográfica. TEI ofrece una gran variedad de elementos para señalar estos fenómenos entre los que destacan:

• <q> (quoted) puede utilizarse para marcar el estilo directo, un pensamiento o algún término técnico, normalmente en las fuentes escritas aparece entre comillas:

<p>Al día siguiente, Bioy me llamó desde Buenos Aires. Me dijo que tenía a la vista el artículo sobre Uqbar, en el volumen XXVI de la Enciclopedia. No constaba el nombre del heresiarca, pero si la noticia de su doctrina, formulada en palabras casi idénticas a las repetidas por él, aunque -tal vez- literariamente inferiores. Él había recordado:  <q xml:lang="en">Copulation and mirrors are abominable</q>. El texto de la Enciclopedia decía: <q>Para uno de esos gnósticos, el visible universo era una ilusión o (más precisamente) un sofisma. Los espejos y la paternidad son abominables (<foreign xml:lang="en">mirrors and fatherhood are hateful</foreign>) porque lo multiplican y lo 
divulgan.</q> Le dije, sin faltar a la verdad, que <q>me gustaria 
ver ese articulo</q>. A los pocos días lo trajo. Lo cual me sorprendió, 
porque los escrupulosos índices cartográficos de la Erdkunde de Ritter 
ignoraban con plenitud el nombre de Uqbar.</p>

(Borges, Ficciones)

• <said> (speech or thought) discurso hablado o pensamiento:

<p> Así es que un día ambas se quedaron atónitas y pasmadas cuando, después de varios requiebros, entre burlas y veras, D. Gumersindo soltó con la mayor formalidad y a boca de jarro la siguiente categórica pregunta:</p> 
<said>Muchacha, ¿quieres casarte conmigo?</said>
<p> Pepita, aunque la pregunta venía después de mucha broma, y pudiera tomarse por broma, y aunque inexperta de las cosas del mundo, por cierto instinto adivinatorio que hay en las mujeres y sobre todo en las mozas, por cándidas que sean, conoció que aquello iba por lo serio, se puso colorada como una guinda, y no contestó nada. La madre contestó por ella:</p>
<said>Niña, no seas mal criada; contesta a tu tío lo que debes contestar: Tío, con mucho gusto; cuando Vd. quiera.</said>

(J. Valera, Pepita Jiménez)

• <quote> pasaje atribuido a una fuente externa:

<p> No conozco aún a Pepita Jiménez. Todos dicen que es muy linda. Yo sospecho que será una beldad lugareña y algo rústica. Por lo que de ella se cuenta, no acierto a decidir si es buena o mala moralmente; pero sí que es de gran despejo natural. Pepita tendrá veinte años; es viuda; solo tres años estuvo casada. Era hija de doña Francisca Gálvez, viuda, como Vd. sabe, de un capitán retirado <quote>Que le dejo a su muerte, Solo su honrosa espada por herencia,</quote> según dice el poeta. Hasta la edad de diez y seis años vivió Pepita con su madre en la mayor estrechez, casi en la miseria.</p>

• <cit> se utiliza para citar de manera completa una referencia bibliográfica:

    <p>El pasaje nos recuerda al 
    <cit>
      <quote>"Arma virumque cano,..."</quote>
       <bibl>(<author>Virgilio</author>, 
      <title>Eneida</title>, I)</bibl>
    </cit></p>

Nombres, números y fechas

En múltiples ocasiones podemos encontrar en los textos nombres (ya sean topónimos, antropónimos, etc.), números y fechas. TEI propone para ello una serie de elementos que nos serán de gran utilidad.

Nombres

Un elemento general para codificar todo tipo de nombres o incluso frases es <name>; más adelante, veremos cómo existe un módulo específico para el marcado de nombres de lugar, de persona, etc. Otro elemento recurrente es <rs> (referring string) que indica un nombre con una denominación genérica o una cadena de referencia.

Los atributos más utilizados, a parte de @xml:id, son @type para especificarlos aparte, y @key o @ref para referirse a un identificador concreto. Por ejemplo, supongamos esta frase: “Pepita Jiménez era hija de Francisca Gálvez quien la quería casar con D. Gumersindo”; la podríamos marcar de la siguiente manera:

<p><name xml:id="PJ">Pepita Jiménez</name> era hija de 
<name xml:id="FG">Francisca Gálvez</name> que la hizo casar con 
<name ref="#Gu">D. Gumersindo</name></p>

una vez establecidos los identificadores, podríamos referirnos a los personajes con facilidad en el fragmento que sigue:

<p>Era, con todo, tan inverosímil y tan desatinado el suponer que un hombre, que había pasado ochenta años sin querer casarse, pensase en tal locura cuando ya tenía un pie en el sepulcro, que ni la <rs ref="#FG">madre de Pepita</rs>, ni <name ref="#PJ">Pepita</name> mucho menos, sospecharon jamás los en verdad atrevidos pensamientos de <name ref="#Gu">D. Gumersindo</name>.</p>

Fechas

En lo que concierne a las fechas, se utiliza el elemento <date> y se regulariza su formato (de manera que la máquina la interprete correctamente) en el interior de @when, cuyo formato es: año-mes-día. He aquí algunos ejemplos.

<date when="1980-03-23">23 de marzo de 1980</date>
<date when="1980"> el año 1980</date>
<date when="1999-10">octubre de 1999</date>
<date when="--02-14">cada 14 de febrero</date>
<date from="2014-02-10" to="2014-02-20"> del 10 de febrero al 
20 de octubre de 2014</date>

Opcionalmente, se pueden especificar los diferentes sistemas de calendario (juliano, gregoriano, etc.) con @calendar:

<date when="1541" calendar="#juliano">1541</date>

En estos casos suele describirse el tipo de calendario utilizado en el elemento <calendar> en el TEI Header.

Podemos, además, especificar la hora con el elemento <time> que suele también incluir el atributo @when para regularizar la forma:

<time when="08:48:00">8:48</time>

Números y medidas

En lo que toca a los números y las medidas, se reducen al uso de los elementos <num>, para cualquier tipo de número (y a veces acompañados de los @type, @value), y de <measure> para marcar una cantidad (seguido opcionalmente de los atributos @type, @quantity, @unit, @comodity).

<num value="52">LII</num>
<num type="cardinal" value="15">quince</num>
<num type="percentage" value="20">veinte por ciento</num>
<num type="ordinal" value="6">6º</num>
<measure type="peso"><num>4</num> quilos de harina </measure>

Listas, notas, anotaciones, indexación, referencias

Listas

Las listas suelen ser un fenómeno habitual en muchos de los textos impresos. Los elementos más comunes que pueden constituir una lista son los siguientes:

• <list> secuencia de ítems que conforman una lista.
• <item> un componente de una lista.
• <label> etiqueta asociada a un ítem.

<list>
    <head>Ingredientes:</head>
    <item n="1">Harina</item>
    <item n="2">Huevos</item>
    <item n="3">Azucar</item>
</list>
<list type="gloss">
  <head>Lista de medidas (traducción)</head>
  <label>height</label>
  <item>altura</item>
  <label>width</label>
  <item>ancho</item>
  <label>depth</label>
  <item>fondo</item>
</list>

Pueden también establecerse diferentes tipos de lista a través del atributo @type, que tiene estos valores por defecto:

• bulleted: ítems precedidos de puntos o marcas similare.
• inline: ítems presentados en prosa continua, sin saltos de página.
• numbered: ítems precedidos de un número.
• simple: ítems presentados como bloques, pero sin puntos ni números.

<list rend="numbered">
  <head>Lista de temas a estudiar</head>
  <item n="1">¿Qué es la TEI y qué aplicaciones prácticas tiene?</item>
  <item n="2">Principios fundamentales de un documento XML</item>
  <item n="3">La estructura básica de un documento TEI</item>
  <item n="4">Elementos generales a todos los documentos TEI (core)</item>
  <item n="5">...</item>
</list>

Este elemento sirve para listas genéricas que responden más bien a un formato presentacional. En muchos casos, cuando tenemos listas semánticas, donde el contenidos es más específico, las Guías directrices de TEI contemplan elementos más concretos, como por ejemplo listBiblpara una lista de bibliografía, o castList para una lista de personajes.

Notas

En muchos casos, podemos encontrarnos con notas o anotaciones de naturaleza diversa. El elemento para codificarlas es <note>, que sirve tanto para las que se encuentran en el texto impreso como las que son añadidas por el editor digital.

El elemento <note> tiene una serie de atributos que nos serán de gran utilidad, entre ellos destacamos:

• @type: permite caracterizar la nota en cuestión, si se trata de una nota al margen, de una nota a pie de página, etc.
• @place: es especialmente útil cuando se transcribe un manuscrito que posee notas en los márgenes; así por ejemplo podemos indicar la localización física de la nota.
• @xml:id: se utiliza, como hemos visto, para dar un identificador único a la nota en cuestión, de manera que podamos referirnos a esta con facilidad y crear, si lo deseamos, un enlace a la misma
• @target: lo utilizaríamos para conectar la referencia con la nota o viceversa.

Las notas pueden marcarse de dos maneras diferentes; una opción es situarla donde aparece la referencia a la misma en el cuerpo del texto (Opción 1); la otra consiste en crear una zona separada (una <div type=“notas”> por ejemplo) y apuntar a la referencia a través del @target:

Opción 1:

<head>Historia y organización<note n="1">Todas las discusiones e informaciones relativas a TEI desde sus inicios se encuentran en el repositorio de la lista TEI</note></head>

Opción 2:

<head>Historia y organización<ref target="nota1" xml:id="referencia1">1</ref></head>
....
[...]
<div type="notas">
<note xml:id="nota1" target="#referencia1">Todas las discusiones e informaciones relativas a TEI desde sus inicios se encuentran en el repositorio de la lista TEI </note>
</div>

Indexación

En algunas ocasiones podemos también encontrarnos con índices de términos, para ello podemos utilizar estos dos elementos:

• <index> marca una entrada de índice, puede llevar @indexName; en su interior pueden anidarse diferentes índices.
• <term> marca un término en el interior del índice.

Puede ocurrir que la fuente original no tenga un índice, pero que queramos construir uno. Esto puede hacerse de diferentes maneras, una de ellas sería utilizando los dos elementos anteriores y marcar los términos que queramos introducir en un nuevo índice. Por ejemplo, imaginemos que queremos hacer un índice de personajes:

<index indexName="Personajes"><term xml:id="PJ">Pepita</term></index> tendrá veinte años; es viuda; sólo tres años estuvo casada. Era hija de doña <index indexName="Personajes"> <term xml:id="FG">Francisca Gálvez</term></index>, viuda, como Vd. sabe, de un capitán retirado.

De esta manera sería fácil autogenerar un índice con los nombres de los personajes, por ejemplo, con un simple script en XSLT.

Enlaces y referencias

Una de las ventajas de crear un hipertexto es justamente la posibilidad que tenemos de conectar las diferentes secciones del texto a otras y establecer todo tipo de enlaces. En TEI los enlaces pueden realizarse de dos maneras, con los siguientes elementos:

• <ptr> (pointer) un indicador hacia otra localización
• <ref> (reference) define una referencia hacia otra localización, normalmente contiene un texto que funciona como el enlace. Ambos suelen utilizar, entre otros, el atributo @target que toma la forma de una referencia URI.

Otros elementos

Existen mucho otros elementos entre los cuales podríamos destacar los cambios editoriales, tales como los errores, correcciones, adiciones, supresiones, etc. y otros elementos pertenecientes a la estructura física del texto, como los saltos de línea, de página o de columna.

Cambios editoriales

Como ocurre en la edición de fuentes escritas, a veces debemos señalar el proceso de constitución de un texto en sus diferentes fases (copistas, editor papel, editor digital, etc.). Para recoger las intervenciones editoriales disponemos de una serie de elementos básicos que podemos utilizar en todos los documentos TEI. Para entender la codificación de estos fenómenos debemos visualizar la intervención como una unidad en la que hay etapas o elementos diferentes. El elemento encargado de recoger estos marcados editoriales alternativos es <choice>, y puede utilizarse en los siguientes casos:

• Corrección de errores: ante un error, se utiliza el elemento <sic> para marcar el error aparente; con el elemento <corr>, en cambio, se recoge la corrección de dicho error:

<p>Hasta cinco mujeres han venido a verme que 
<choice>
   <sic>todos</sic><corr>todas</corr>
</choice> han sido mis amas y me han abrazado y besado.</p>

• Regularización de formas ortográficas: la forma original que aparece en el texto se marca con el elemento <orig>, mientras que su forma regularizada, con el elemento <reg>:

<choice>
   <orig>Comiença</orig>
   <reg>Comienza</reg>
</choice> la
<choice>
   <orig>ystoria</orig>
    <reg>historia</reg>
</choice>...

• Abreviatura: la forma abreviada aparece en el elemento <abbr>, mientras que la forma expandida bajo <expan>:

<p>...un largo 
<choice>
    <abbr>etc.</abbr>
     <expan>etcétera</expan>
</choice>
</p>

Hay otro tipo de intervenciones que pueden codificarse de manera aislada, como las adiciones, las eliminaciones, las omisiones, e incluso las lecturas dudosas:

• <add>: adición al texto, como por ejemplo una glosa marginal.
• <del>: una eliminación en el texto, como una tachadura.
• <gap>: indica un punto donde el material ha sido omitido; puede tener el atributo @reason para señalar el motivo.
• <unclear>: indica una lectura dudosa.

Milestones

Dentro de la categoría que las Guías directrices denominan “Milestone” encontramos diversos elementos que pueden indicar ciertas características físicas del documento. Entre estos elementos encontramos:

• <milestone>: marca un punto límite separando cualquier tipo de sección de un texto.
• <gb> (gathering begins) puede indicar el inicio o final de la foliación de un manuscrito, por ejemplo donde empieza y donde acaba un cuaderno.
• <pb> (page break): indica el cambio de página.
• <lb> (line break): indica el cambio de línea.
• <cb> (column break): indica el cambio de columna