Problemas conocidos con las anotaciones y los documentos modificados

Cuando utilizas anotaciones en documentos en elaboración (documentos cuyo contenido puede cambiar), puedes encontrar dos tipo de problemas: anotaciones huérfanas y anotaciones equívocas. Para explicar estos problemas, describiremos primero cómo Amaya asocia anotaciones a los documentos.

Amaya utiliza XPointer para indicar el lugar en el que la anotación debe adjuntarse al documento. Los XPointers se basan en la estructura del documento. Para construir un XPointer para una selección, por ejemplo, Amaya empieza en el comienzo de la selección y sube en la estructura del documento hasta la raíz. Si un elemento tiene un atributo ID, Amaya deja de construir el XPointer y considera el elemento con atributo ID el inicio del XPointer.

Por ejemplo, si miras al código fuente HTML de este documento, te darás cuenta de que esta sección forma parte de un elemento div cuyo atributo ID tiene el valor "page_body". Este es el código fuente:

  <div id="page_body">
  <h1>Problemas conocidos con...</h1>
  <p>Cuando utilizas...</p>
  <p>Amaya utiliza <strong>XPointer</strong>...</p>
  ...
  </div>

Este XPointer apunta al segundo párrafo: xpointer(id("page_body")/p[2])

El XPointer anterior apunta al segunda elemento p, a partir del elemento padre cuyo atributo ID tiene el valor "page_body".

Fíjate en que la utilización del atributo ID permite al autor del documento mover la referencia del XPointer a cualquier lugar del documento sin necesidad de actualizar el XPointer. El XPointer no depende de los elementos que lo preceden.

Anotaciones huérfanas

Una anotación se vuelve "huérfana" cuando ya no puede adjuntarse al documento, es decir, cuando el XPointer no encuentra su elemento en la estructura. Esto ocurre cuando se modifca la estructura del documento. Amaya muestra un aviso cuando detecta anotaciones huérfanas al descargar anotaciones de un servidor de anotaciones. Todas las anotaciones huérfanas son visibles en la vista Enlaces y el icono asociado es un signo de interrogación superpuesto al lápiz de anotación .

Anotaciones equívocas

Una anotación es "equívoca" cuando apunta a una información que no le corresponde. Esto suele suceder cuando anotas una porción de texto que posteriormente se modifca. En esta versión, Amaya no avisa al usuario si una anotación es equívoca. En futuras versiones, puede que se notifique a los usuarios cuando una anotación pueda ser equívoca.

¿Qué puedes hacer para evitarlo?

Como autor de un documento, intenta utilizar el atributo ID en lugares estatégicos, por ejemplo en los elementos <div> y p. Por ejemplo:

  <p id="Amaya">Amaya utiliza...</p>

Un XPointer que apunta a este párrafo sería: xpointer(id("Amaya"))

Por tanto, el Xpointer apuntará al mismo párrafo, sea cual sea su posición en la estructura.

Amaya te permite crear o eliminar automáticamente los atributos ID en un conjunto de elementos eligiendo el comando de menú Enlaces > Crear/Borrar atributos id.