8.2. Creación del ODD

Pasemos ahora a ver cómo podemos crear y manipular un documento ODD con la aplicación Roma. Obviamente podríamos crearlo a mano, si conocemos bien la sintaxis a utilizar, tal y como ocurría con los esquemas, pero la práctica habitual es el uso de Roma que ya habéis tenido ocasión de utilizar.

Para que toméis una primera toma de contacto con un fichero ODD os recomiendo que creéis uno con vuestro programa oXygen, siguiendo estos pasos:

File > New > Framework templates > TEI ODD > ODD [TEI ODD] > Create

Como podéis observar, se trata de un fichero XML-TEI normal con el prólogo XML, un elemento raíz <TEI>, al interior del cual tenemos un <teiheader> con los diferentes metadatos, y un elemento <text> que contiene a su vez el <body>. Ahora bien, los elementos que aparecen a continuación son nuevos:

El elemento <schemaSpec> responde a Schema Specification, es decir, señala el tipo de esquema que debe reconstruir, indicando además el elemento raíz a través del atributo @start.

A continuación lista los diferentes módulos que el esquema resultante deberá contener. Como podéis ver, se trata sólo de los módulos obligatorios: header, core, tei y textstructure.

De hecho, este sería el mismo resultado que si, en la aplicación Roma, creáramos un esquema mínimo. Hagamos la prueba:

1) Id a la aplicación Roma y cread un esquema a partir del modelo mínimo:

2) Cambiad los metadatos esenciales en la pestaña “Personalizar”:

3) Si ahora quisiéramos generar un esquema RelaxNG, iríamos a la pestaña “Esquema”, si quisiéramos obtener la documentación relativa a ese esquema, seleccionaríamos la pestaña “Documentación”. Ahora lo que nos interesa es crear el documento ODD, por lo que iremos a “Guardar configuración personal”:

Al pulsar, se descargará de manera automática el fichero ODD, que si abrimos con el programa oXygen, veremos que contiene la misma estructura y los mismos módulos obligatorios; además de la descripción que añadimos en la pestaña “Personalizar” se reflejan en el documento obtenido:

  • schemaSpec es la definición formal del esquema TEI.
  • @ident: contiene el identificador que corresponde al nombre del fichero que le hemos consignado.
  • @docLang: indica la lengua de la documentación, en nuestro caso el español es.
  • @prefix: tei_ es el prefijo que se utilizará para todas las definiciones de los casos TEI.
  • @key: es el responsable de llamar a los identificadores de los módulos y todo el contenido que hay en ellos.

En resumen, una personalización mínima de TEI, registrada en un documento ODD, contendrá siempre los módulos obligatorios. De ser de otra manera, ya no sería un fichero TEI, sino otra cosa; y cada uno de esos módulos, incluye a su vez una lista de elementos y atributos predefinidos.

Hagamos otra prueba, retomando nuestro fichero ODD que hemos creado y siguiendo estos pasos:

1) En la página principal de Roma, escoged la opción “Upload Customization” y elegid vuestro fichero creado con Roma:

2) Como podéis ver, hemos recuperado las informaciones que habíamos introducido:

3) Ahora vayamos a la pestaña de “Módulos” y añadamos el módulo verse:

4) Seleccionemos ahora el módulo verse, eliminemos los elementos <metDecl> y <metSym> y guardemos los cambios:

5) Al interno del elemento <caesura> haremos un solo cambio: ampliaremos la “Descripción”:

6) Al interno del elemento <rhyme>, modificaremos los valores de los atributos en la pestaña correspondiente “Modificación de atributos” y señalando los valores en la casilla “Lista de valores”. En nuestro caso señalando el tipo de rima en “consonante” o “asonante”, separados por comas y sin espacios:

7) Si quisiéramos generar el esquema correspondiente iríamos a la pestaña “Esquema” y seleccionaríamos el tipo de esquema deseado:

Esta modificación nos simplificaría la tarea al codificar, preestableciendo nuestros valores:

8) Generemos finalmente el documento ODD, clicando en “Guardar configuración personal” y abramos el documento con oXygen:

Como vemos, el resultado es el total de los cambios realizados en nuestro esquema:

  • Se ha añadido el módulo verse, señalando los dos elementos que hemos eliminado.
  • Se recoge la nueva descripción del elemento <caesura>.
  • Así como se añaden los valores al atributo @type a través de una lista de valores (<valList>) y los valores individuales (<valItem>).

A partir de ahora, cada vez que subamos este documento ODD a la aplicación Roma recuperaremos el mismo esquema, conservando siempre las modificaciones que hemos llevado a cabo. ¡Imaginaros cuanto tiempo nos llevaría modificar nuestro esquema, si tuviéramos que incorporar toda la personalización cada vez que quisiéramos realizar algún cambio!

¿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)