動態內容

什麼是動態內容?

若干使用者輔助元件可讓您提供動態內容。 這表示內容可以隨著使用者的環境或環境定義而不同。 例如,您可以只在使用者啟用了特定功能時,才顯示說明文件或歡迎使用頁面的某個區段。

您可以利用兩種基本方法來建立動態內容。 第一個方法是將標示和屬性(註解)加到 XML 標記中,指示系統過濾某些章節或文件,併入其他文件的某些章節,或指定錨點供其他元件延伸您的文件。

另一個方法是外掛一些從頭撰寫內容或即時處理現有靜態文件的 Java 程式碼,以撰寫您自己的內容生產器。 以下檢視這兩個方法。

XML 註解

建立動態內容最簡單的方法是使用 XML 標記註解。 您只需要將一些特殊屬性和標示加到 XML 標記中,系統會處理這些指示。 您可以利用這個標記來執行這個動作:

如果要進一步瞭解標記的各個方面,請遵循上述鏈結,在目錄中找出相關主題。

這方面的 XHTML 片段示範如下:


   <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 註解強,但比較複雜。

以下是支援內容生產器的使用者輔助區域: