Clica en el botón verde Code y escoge la opción Donwload ZIP y descomprime la carpeta que acabas de descargar.
- Ficheros XML de ejemplo:
xml-simple.xmlxml-simple-solapamiento.xmlxml-tei.xml
- Tareas (ejercicios con soluciones)
- Corpus (ficheros TEI-XML)
- Queries (ficheros XQuery para explorar los archivos de la carpeta “Corpus”)
Si tienes Oxygen, abre el documento XML que desees explorar. Busca un diálogo como el de la siguiente imagen:
Si clicas encima de la palabra “XPath” podrás escoger la versión (escoge siempre una versión superior a 2).
Escribe la expresión en el diálogo y pulsa la tecla “Enter”: se abrirá una ventana (seguramente en la parte inferior del editor) con el resultado de la consulta.
Si estás acostrumbrad@ a trabajar con la terminal, las siguientes librerías te permitirán trabajar con XPath 3:
xidel- Ej.:
xidel -se '//element/@attribute' file.xml
- Ej.:
saxon-lint- Ej.:
saxon-lint --xpath '//element/@attribute' file.xml
- Ej.:
Hay diferentes herramientas en línea que se pueden utilizar para navegar un fichero con XPath, como por ejemplo FreeFormatter. Además, esta herramienta te ofrece varios ejemplos que pueden resultarte útiles.
- Clica en el icono que presenta la versión estable más reciente que vemos al final de la página de inicio de eXist-DB.
- Este enlace te llevará a la página GitHub del proyecto. Selecciona el fichero cuyo nombre sigue el siguiente formato (en lugar de la letra “x” tendrás el número de la versión):
exist-installer-x.x.x.jar - Abre el fichero (requiere que tengas Java instalado; aquí tienes unas instrucciones de cómo instalarlo si lo necesitas).
- Una vez lances el fichero, te saldrá un diálogo de ayuda:
- Selecciona el directorio de instalación (paso 2) y el directorio de datos (paso 3): puedes usar las opciones que te ofrece por defecto.
- En el paso 4 establece la contraseña del usuario
admin(el usuario administrado de la base de datos). - En los siguientes pasos, puedes aceptar las opciones por defecto.
Para probar que la instalación ha funcionado, busca la aplicación entre los programas instalados y lánzala. Si el servidor funciona correctamente, en la página: http://localhost:8080/exist/ deberías ver el “Dashboard” de eXist (durante el proceso de instalación, has podido seleccionar la instalación de determinadas aplicaciones dentro de eXist, por lo que tu dashboard no debería ser idéntico al que se presenta en la captura):
En la esquina superior derecha, clica en Login y conéctate como el usuario admin. Entra en la aplicación eXide y sigue las instrucciones del capítulo.
Si tienes problemas durante la instalación, consulta las instrucciones disponibles en la página de eXist.
Clica en File > New... y en el diálogo emergente selecciona XQuery y clica en Create. Guarda el documento en la carpeta queries que has descargado como parte de los materiales de este repositorio.
En la esquina superior derecha, clica en el icono con las letras “xq” (XQuery debugger).
Esto hará que la ventana del editor se divida en 3, y que en el menú aparezcan nuevas opciones que te permiten seleccionar cuál será el fichero de entrada, el fichero XQuery que se correrá, y el fichero de salida:
Como vamos a consultar una colección, no un fichero único, no vamos a preocuparnos de seleccionar el fichero de entrada por lo que dejamos la opción (None). La selección del fichero de salida es opcional. Cada vez que corramos una query, los resultados aparecerán en la tercera división de la ventana (Output) y podemos guardar el resultado clicando con el botón derecho sobre esta ventana y seleccionando Save as.
El documento XQuery que as creado se encuentra en la segunda división de la ventana. Puedes empezar por declarar la versión de XQuery en este documento y el espacio de nombres de TEI tal y como se explica en los contenidos del capítulo:
xquery version "3.1";
declare namespace tei = "http://www.tei-c.org/ns/1.0";
Es en este fichero en el que tienes que declarar la colección de documentos que consultarás. En los contenidos del capítulo se ejemplifica con eXist-DB. En Oxygen escribirás la ruta que lleva a la carpeta en la que guardas los documentos XML. Si por ejemplo has guardado el documento XQuery en la carpeta queries, entonces la ruta que te lleva al corpus es: ../corpus:
xquery version "3.1";
declare namespace tei = "http://www.tei-c.org/ns/1.0";
declare variable $corpus := collection('../corpus');
Por defecto, oXygen genera documentos XML como el resultado de lanzar una query por lo que en la ventana Output siempre verás los resultados precedidos por la declaración XML. Para evitar este comportamiento, puedes declarar que el fichero de salida será texto simple, utilizando unas opciones disponibles en XSLT and XQuery Serialization Namespace Document de W3C. Tienes que declarar el espacio de nombres adecuado y después indicar la opción adecuada:
xquery version "3.1";
declare namespace tei = "http://www.tei-c.org/ns/1.0";
declare namespace output = "http://www.w3.org/2010/xslt-xquery-serialization";
declare option output:method "text";
declare variable $corpus := collection('/db/apps/sonetos/xml');
Para correr una query, clica en la flecha azul más gruesa (Run): 
- Sobre XML y TEI:
- Hub de Tecnologías del Texto (TTHUB): https://tthub.io/
- Sobre XPath:
- Introducción a XPath (en inglés) de Elisa Beshero-Bondar: https://newtfire.org/courses/tutorials/explainXPath.html
- Introducción a XPath (en inglés) de David Birnbaum: http://dh.obdurodon.org/introduction-xpath.xhtml
- Tutorial XPath de la W3Schools (en inglés): https://www.w3schools.com/xml/xpath_intro.asp
- Sobre XQuery:
- Lista de recursos (en inglés) para aprender XQuery con tutoriales, blogs y artículos: https://github.com/joewiz/learn-xquery