Известные проблемы с аннотациями и редактированием документов

Когда вы используете аннотации с живыми документами (т.е. с документами, чьё содержание может изменяться), вы можете столкнуться с двумя проблемами: потерянные аннотации и рассогласованные аннотации. Для объяснения этих проблем, сначала мы должны описать как Amaya прикрепляет аннотации к документам.

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

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

  <div id="Issues">

  <h1>Проблемы в ....</h1>

  <p>Если вы используете...</p>

  <p>Amaya использует <strong>XPointer</strong>...</p>

  ...

  </div>

Точки XPointer во втором параграфе: xpointer(id("Issues")/p[2])

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

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

Потерянные аннотации

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

Рассогласованные аннотации

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

Что вы можете сделать, для недопущения этого?

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

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

Точки XPointer в этом параграфе будут таковыми: xpointer(id("Amaya"))

Таким образом, Xpointer укажет на тот же параграф, независимо от своей позиции в структуре документа.

Amaya позволяет вам автоматически вводить или удалять атрибут ID в/из набора элементов, выбрав пункт Добавить/Удалить ID из меню Ссылки.