NetBeans教程：擁有描述插件的 HTML 文件之后，您必須將它們包裝在插件中，該插件將它們集成在 NetBeans 文件系統(tǒng)中。要完成此操作，您需要創(chuàng)建一個幫助系統(tǒng)。除了 HTML 文件之外，幫助系統(tǒng)還包含以下文件：

映射文件。 指定映射 ID 的列表，每個 ID 都鏈接到特定的 HTML 文件。

目錄文件。 使用映射 ID 將幫助文件安排到目錄中。

索引文件。 使用映射 ID 將幫助文件安排到索引中。

Helpset 文件。 通過參考映射文件、目錄文件和索引文件定義幫助系統(tǒng)。

在本教程中您將創(chuàng)建這些文件中的每個文件，以及在 NetBeans 文件系統(tǒng)中注冊幫助系統(tǒng)的文件。

您可以將幫助系統(tǒng)打包到包含 HTML 文件描述的代碼的插件中，您也可以創(chuàng)建一個僅包含幫助系統(tǒng)的單獨插件。本教程假設(shè)您想讓幫助系統(tǒng)包含在單獨的插件中。但是，如果您想讓它們包含在 HTML 文件描述的插件中，則可以跳過“創(chuàng)建 Plug-in 項目”部分的前三個步驟。

安裝完軟件之后，本教程可以在 20 分鐘之內(nèi)完成。

如果您在編寫和集成幫助系統(tǒng)時有問題，請參閱模塊 Helpset 集成常見問題解答。這些常見問題解答提供本教程中未涉及的很多其他詳細(xì)信息。有關(guān)常規(guī)使用 NetBeans 插件的詳細(xì)信息，請參閱 NetBeans 網(wǎng)站上的 NetBeans Development Project 主頁。如果有問題，請使用本頁頂部的反饋鏈接。

安裝軟件

開始之前，需要在您的計算機上安裝以下軟件：

NetBeans IDE 5.0（下載）

Java Standard Development Kit (JDK!") version 1.4.2（下載）或 5.0（下載）

安裝示例

采用以下步驟來安裝示例： 解壓縮附加的文件。

在 IDE 中，選擇 File>Open Project，然后瀏覽到包含已解壓縮文件的文件夾。打開模塊項目。其形式如下：

在NetBeans 文件系統(tǒng)中注冊幫助系統(tǒng)涉及以下文件：

Helpset 參考文件（.xml 擴展名）。

層文件（.xml 擴展名）。

helpset 參考文件參考 myplugin.hs 文件并使其可用于 layer.xml 文件。layer.xml 文件在 NetBeans 文件系統(tǒng)中注冊幫助系統(tǒng)。

執(zhí)行以下操作以創(chuàng)建 helpset 參考文件：

在 org/myorg/myhelpsystem 包中創(chuàng)建名為 helpset 的 XML 文檔。

用以下內(nèi)容替換默認(rèn) 元素：　"-//NetBeans//DTD JavaHelp Help Set Reference 1.0//EN"
　"http://www.netbeans.org/dtds/helpsetref-1_0.dtd">


按 Ctrl-S 保存文件。

如上所示，您在 layer.xml 文件中使用 Services/JavaHelp 文件夾結(jié)構(gòu)以注冊 helpset 參考文件以及指定順序?qū)傩?。該順序?qū)傩灾付ㄔ诂F(xiàn)有幫助系統(tǒng)中放置該幫助系統(tǒng)的位置。例如，下例中的 helpset 文件放置在 org-netbeans-modules-usersguide-below-regular.txt 之后。

執(zhí)行以下操作以在 layer.xml 文件中注冊 helpset 參考文件：

在 Projects 窗口中，展開 Source Packages 節(jié)點，展開 org.myorg.myhelpsystem 節(jié)點，雙擊 layer.xml 文件將它在 Source Editor 中打開。在 layer.xml 文件中的 標(biāo)記之間添加以下條目：

< FONT face=NSimsun>< FOLDER name="Services"> 
< FOLDER name="JavaHelp"> 
　  
< ATTR name="org-netbeans-modules-usersguide-below-regular.txt
/org-myorg-myhelpsystem-helpset.xml" boolvalue="true" /> 
< /FOLDER> 
< /FOLDER>< /FONT>< /CODE> 

< CODE>< FONT face=NSimsun>
< FILE name="com-sun-enterprise-tools-studio-j2ee-helpset.xml_hidden" /> 
< FILE name="org-netbeans-modules-j2ee-helpset.xml_hidden" /> 
< FILE name="org-netbeans-modules-usersguide-helpset.xml_hidden" /> 
< FILE name="org-netbeans-modules-apisupport-project-helpset.xml_hidden" /> 
< FILE name="org-netbeans-modules-web-monitor-resources-helpset.xml_hidden" /> 
< FILE name="org-netbeans-modules-db-helpset.xml_hidden" /> 
< FILE name="org-netbeans-modules-tomcat5-helpset.xml_hidden" /> 
< FILE name="org-netbeans-modules-dbschema-helpset.xml_hidden" /> 
< FILE name="org-netbeans-modules-versioning-system-cvss-resources-helpset.xml_hidden" />
< /FONT>< /CODE>