Динамическое содержимое

Что такое динамическое содержимое?

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

Существует два основных способа создания динамического содержимого. Один из них заключается в добавлении тегов и атрибутов (аннотаций) к тексту XML, которые указывают системе отфильтровать разделы или документы, включить разделы из других документов или указать метки, позволяющие другим компонентам расширять документацию.

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

Аннотации XML

Простейшим способом создания динамического содержимого является использование аннотаций XML. Следует просто добавить специальные атрибуты и теги в текст XML, и система будет выполнять эти инструкции. Этот текст на языке описания можно использовать для следующих целей:

Для получения более подробной информации о тексте на языке описания следуйте приведенным выше ссылкам либо обратитесь к соответствующим разделам в оглавлении.

Ниже приведен пример фрагмента XHTML:


<p>

  Это статический абзац.
</p>
  
<!-- Этот тег будет заменен тегом, на который он ссылается -->
<include path="my.plugin.id/path/my_other_document.xhtml/element_id"/>

<ul>
   <li>
      Это статический пункт списка.
   </li>
   <li filter="os=win32">
      Показывается только при работе с Windows.
   </li>
   <li filter="plugin!=org.eclipse.help">
      Показывается только в том случае, если модуль org.eclipse.help НЕ установлен.
   </li>
</ul>
        
<!-- Здесь другие компоненты могут добавлять содержимое -->
<anchor id="my.anchor.id"/>

Источники информации

Источник информации представляет собой механизм вставки кода Java для создания содержимого документа на лету. Источники информации предоставляют больше возможностей по сравнению с аннотациями XML, однако с ними сложнее работать.

Источники информации поддерживаются в следующих областях поддержки пользователей: