Sobre esta guía

La configuración básica primero hace disponible ediarum en la versión estándar, sin ninguna configuración específica de su proyecto editorial y sin que necesite conocimientos de programación.

Sobre ediarum

Uso:

Ediarum es un entorno de trabajo para ediciones filológicas digitales. En este entorno de trabajo, los editores y editoras pueden crear y editar transcripciones basadas en XML-TEI de fuentes de texto sin tener conocimientos profundos de XML. De esta manera, los editores y editoras pueden marcar fenómenos textuales, insertar comentarios, crear enlaces a los registros, mantener las entradas de los registros y proporcionarles de datos de autoridad. La configuración básica proporciona a través de ediarum.BASE.edit un modelo de datos orientado a fuentes históricas de la (Temprana) Edad Moderna que está basado en el DTA-Basisformat (“formato básico del DTA”).

Componentes técnicos:

A nivel técnico, ediarum proporciona los siguientes componentes:

  • ediarum.BASE.edit: framework para Oxygen XML Author para transcribir textos
    • Contiene ediarum.jar, ...
  • ediarum.REGISTER.edit: framework para Oxygen XML Author para registros
  • ediarum.DB: una aplicación de eXist-db para la gestión de datos adecuada para ediarum.BASE.edit y ediarum.REGISTER.edit

Variantes de configuración

Este manual describe la configuración básica de ediarum. No describe la configuración y extensión específica de una edición, pero ofrece información básica sobre ambas.

Configuración básica: Pone en funcionamiento ediarum de modo que las funcionalidades de entrada para el esquema XML suministrada estén disponibles. La configuración básica también incluye la configuración de un registro de personas y un registro de lugares, así como de las correspondientes funcionalidades de entrada.

Configuración y extensión específica de su edición: Cuando ediarum está funcionando, puede añadir sus propias funcionalidades al framework, por ejemplo para elementos TEI específicos de su edición. Puede activar las funcionalidades de entrada suministradas para más registros (por ejemplo, el registro de obras) o añadir sus propios registros.

¿A quién va dirigido este manual?

Puede realizar la instalación y configuración básica de ediarum si tiene conocimientos básicos de informática en las humanidades digitales. Una vez que ha completado la configuración, puede pasarla como add-on a los editores y editoras del grupo de trabajo de su edición.

Conocimientos necesarios para realizar la configuración:

  • Conocimientos básicos de XML, esquemas XML
  • Conocimientos básicos del dashboard eXist-db, es decir, la interfaz gráfica para el trabajo con su base de datos
  • Conocimientos básicos de GitHub

Conocimientos necesarios para realizar trabajos editoriales con ediarum:

  • Conocimientos básicos de XML y TEI
  • Conocimientos básicos de Oxygen XML Author

Requisitos

  • Oxygen XML Author está instalado, al menos la versión 20.1 (alternativamente: Oxygen XML Editor).
  • La versión 5.2 de eXist-db está instalado.

Idiomas

Los componentes necesarios para instalar y usar ediarum están disponibles en los siguientes idiomas:

  • Oxygen XML Author está disponible en inglés.
  • El tablero de instrumentos de eXist-db tiene una interfaz de usuario en inglés, la aplicación ediarum.DB sólo está disponible en alemán. Para poder usarla sin conocimientos de alemán, esta guía describe cada paso de la instalación, hace referencia a los elementos de la GUI y explica su significado y contenido.
  • La interfaz de ediarum.BASE.edit está disponible en alemán. Proyecto Humboldt Digital (ProHD) está desarrollando una localización en español. También es posible crear su propio extensión del framework de ediarum.BASE.edit que incluya su traducción de la interfaz gráfica de usuario.
  • El ediarum.BASE.manual está disponible en alemán y español. La versión en español hace referencia a los términos localizados de la GUI de ediarum.PROHD.edit.

Retroalimentación

Siempre estamos felices de recibir retroalimentación sobre esta guía. Por favor, dirija sus comentarios a: jan.wierzoch@bbaw.de.

Estamos planeando hacer disponibles los archivos XML de esta guía en GitHub en el futuro próximo para que pueda contribuir con añadiduras directamente.

¿Qué hay de nuevo en esta versión del manual?

v1.2es del 12.10.2021

  • Correción en Projekt im Oxygen XML Author anlegen de dos variables de editor: Debe haber una barra (“/”) al final de la ruta. Si estas variables del editor no se introducen correctamente, no podrá utilizar las funcionalidades de registro, por ejemplo.
    • Por ejemplo, para ${ediarum_projects_directory}: /exist/rest/db/projects/
    • Por ejemplo, para ${ediarum_projects_directory_webdav}: /exist/webdav/db/projects/
  • Correción en Projekt in der Datenbank anlegen sobre el cambio de nombre de las carpetas de la base de datos para los datos XML: No debe cambiar el nombre de las carpetas creadas automáticamente durante la instalación de la aplicación ediarum.DB en eXist-db, ino sólo después de haber completado la configuración básica, a través del Oxygen XML Author.
  • Nuevo capítulo: Installationstipps eXist-db und Oxygen

Historial de cambios

versión del documento fecha de publicación versión del software cambios realizados
v1.2es

03.12.2020

(not published, for internal use only)

Oxygen XML Author v20.1

eXist-db v5.2

ediarum.BASE.edit v1.1.1

ediarum.DB v4.0.1

ediarum.REGISTER.edit v1.0.3

 Correcciones debidas al workshop de ediarum 09.-11.03. 2020.
v1.2 12.02.2020

Oxygen XML Author v20.1

eXist-db v3.5 oder v4.4

ediarum.BASE.edit v1.1.1

ediarum.DB v3.2.5

ediarum.REGISTER.edit v1.0.1

 Publicado por primera vez en: https://www.ediarum.org