4.4. 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>

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:

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

Opción 2:

Historia y organización<ref target="nota1" xml:id="referencia1">1</ref>
....
[...]
<div type="notas"
<note xml:id="nota1" target="#referencia1">Todas las discusiones e informaciones relativas entorno 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.

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.

¿Como citar?

Susanna Allés-Torrent, Introducción a la codificación de textos en XML-TEI, 2018.
http://tthub.io/aprende/introduccion-a-tei/ (Última fecha de acceso)