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

Когда вы используете аннотации с живыми документами (т.е. с документами, чьё содержание может изменяться), вы можете столкнуться с двумя проблемами: потерянные аннотации и рассогласованные аннотации. Для объяснения этих проблем, сначала мы должны описать как 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 из меню Ссылки.