动态内容

什么是动态内容?

有几个用户辅助组件允许您提供动态内容。这意味着可以根据用户的环境或上下文来更改内容。例如,可以让帮助文档或欢迎页面的某个小节只有在用户启用了特定功能时才出现。

可以通过两种基本方法来创建动态内容。一种方法是对 XML 标记添加标记和属性(注释)以通知系统过滤掉某些小节或文档(包括其他文档中的小节),或者指定锚点以允许其他组件扩充文档。

另一种方法是通过插入一些 Java 代码来编写自己的内容生成者,这些 Java 代码将从头开始写内容或者快速处理现有的静态文档。让我们来研究一下这两种方法。

XML 注释

创建动态内容的最简单方法是使用 XML 标记注释。您只需在 XML 标记中添加一些特殊属性和标记,系统将处理这些指令。可以使用此标记来:

要了解有关标记各个方面的更多信息,请遵循以上链接或者在目录中查找主题。

以下 XHTML 片段演示了如何使用 XML 注释:


<p>
This is a static paragraph.
</p>

<!-- This tag will be replaced with the referenced tag -->
<include path="my.plugin.id/path/my_other_document.xhtml/element_id"/>

<ul>
   <li>
      This is a static list item.
   </li>
   <li filter="os=win32">
      This only shows when running on Windows.
   </li>
   <li filter="plugin!=org.eclipse.help">
      This only shows when plugin org.eclipse.help is NOT installed.
   </li>
</ul>

<!-- A place where others can add content -->
<anchor id="my.anchor.id"/>

内容生产者

内容生产者是一种机制,它的作用是通过插入 Java 代码来快速生成文档内容。与 XML 注释相比,内容生产者的功能更强,但使用起来更为复杂。

用户辅助的下列领域支持内容生产者: