Известные Проблемы с Аннотациями и Модифицированными Документами

При использовании аннотаций с рабочими документами (документами, содержимое которых может изменяться), могут выявиться две проблемы: бесхозные аннотации\orphan annotations и аннотации без цели\misleading annotations. Для рассмотрения этих проблем мы сначала покажем, как Amaya подключает аннотации к документам.

Amaya использует указатель XPointer для индикации места, где аннотация должна быть включена в документ. XPointer-ы базируются в структуре документа. Для создания XPointer для выделения, к примеру, Amaya начинает с первой точки выделения и проходит в обратном направлении по структуре документа, пока не найдёт корневой элемент документа. Если элемент имеет атрибут ID, Amaya останавливает создание XPointer-а и считает элемент атрибутом ID началом этого XPointer-а.

Например, в исходном HTML этого документа видно, что этот раздел находится внутри элемента DIV, имеющего атрибут ID со значением "Issues". Вот выдержка из этого кода:

<div id="Issues">

<h1>Issues with ....</h1>

<p>If you are using...</p>

<p>Amaya uses <strong>XPointer</strong>...</p>

...

</div>

Такой XPointer указывает на второй параграф: xpointer(id("Issues")/p[2])

Этот XPointer указывает на второй элемент p, считая от родительского элемента, имеющего атрибут ID со значением "Issues".

Обратите внимание, что использование атрибута ID даёт автору документа возможность переместить всю ссылку XPointer-а в другое место в этом документе без необходимости изменять XPointer. Этот XPointer не зависит от предшествующих элементов.

Бесхозные Аннотации

Аннотация становится "бесхозной", когда она больше не может быть присоединена к документу, то есть, когда XPointer не указывает больше на какой-либо элемент структуры. Это бывает при изменении структуры документа. Amaya выводит предупреждение, если обнаруживает бесхозные аннотации, при загрузке набора аннотаций с сервера аннотаций. Все бесхозные аннотации видны в режиме просмотра Links view и ассоциированы с иконкой со знаком вопроса поверх карандаша .

Аннотации без Цели

Аннотации становятся "бесцельными", если указывают на неверный участок информации. Это часто происходит при аннотировании блока текста, который может измениться. В первом релизе Amaya не предупреждает пользователя о таких аннотациях. В будущем релизе может выдаваться предупреждение о возможности бесцельной аннотации.

Что Сделать, Чтобы Исключить Это?

Как автор документа, попытайтесь использовать атрибут ID в стратегически важных местах, например, внутри элементов <DIV> и p. Например:

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

XPointer, указывающий на этот параграф, выглядит так: xpointer(id("Amaya"))

Таким образом, этот Xpointer будет указывать на один и тот же параграф, вне зависимости от его положения в структуре документа.

Amaya делает возможным автоматическое ассоциирование или удаление атрибута ID с/из набора элементов через Add/Remove ID в меню Special.