文件整合

假使我們希望有時候外掛程式自行安裝,有時候則安裝成較大元件或產品的一部份呢?

如果是一個自由浮動的外掛程式,我們想要確定可以在「說明內容」檢視畫面看 到我們的文件 infoset。 當 topics 被整合到一個較大 Web 時,顯示我們的獨立書籍可能就沒有意義。 相反地,我們可能屬於較大 Web 的 infoset。

若要支援非整合或整合較不嚴謹的文件,外掛程式可以使用 "standalone=true" 屬性定義它的 infoset 和 actions。 唯有當其他地方尚未提供 action 的 topic 時,才會執行獨立 action 的插入作 業。如果獨立式 infoset 是空的,那麼它不會出現在說明內容檢視畫面中。 如果符合下列條件,那麼 infoset 不會出現在說明內容組合框中:

提供「快取全部」實務時,對 actions 和 infosets 設定獨立式屬性很有用。 沒有順利提供給另一個 infoset 的文件仍然會出現在某處。

為了支援這種作業模式,我們需要對 infoset 和 action .xml 檔新增下列 內容。 以粗體字標示新增。

infoset_Guide.xml

<infoset id="infoset_SampleGuide" label="Online Help Sample" 
    href="doc/splash.html" standalone="true">

actions_All.xml

<actions infoview="com.example.helpexample.view_Contents" standalone="true">

actions_View_Contents.xml

<actions infoview="com.example.helpexample.view_Contents" standalone="true">

如果另一個外掛程式的 infoset 包括所有 topics,就不會使用我們的 actions,結 果 infoset 會是空白。 infoset 不會顯示在說明內容檢視畫面組合框。