從 XML 綱目產生的 HTML 文件含有綱目的各種相關資訊(如:名稱、位置和名稱空間),
以及綱目內含之各個元件(如:元素或複式類型)的詳細資料。這對於提供綱目內容的彙總很有幫助。
以下是針對「資源」視景撰寫的指示,
但是它們也適用於許多其他視景。
如果要根據 XML 綱目檔來產生 HTML 文件,請執行下列動作:
- 在「概要」視圖中,用滑鼠右鍵按一下 XML 綱目。
- 按一下。 這時會開啟「產生 XML 綱目文件」對話框。
- 選取您要的 HTML 文件的樣式:
- 如果您要一個 HTML 檔含有所有資訊,請選取不含頁框的單一 HTML 檔。
- 否則,請選取含頁框的多個 HTML 檔。 如果您選取這個選項,則會產生數個 HTML 檔而不只是產生一個檔案。這些檔案也會以類似的樣式設定成 Javadoc 檔。
- 如果您選取了不含頁框的單一 HTML 檔,您可以按一下完成,系統即會在相同位置,以和程式檔相同的名稱自動產生 HTML 檔;您也可以按下一步來選取您要在其中建立 HTML 文件的資料夾,並指定 HTML 檔的名稱,然後按一下完成。 如此即會建立 HTML 檔。
您現在可以在 HTML 編輯器中開啟它。
- 如果您選取了含頁框的多個 HTML 檔,
請按下一步來指定 HTML 檔的目標資料夾,然後按一下完成。 這些 HTML 檔即會建立在您指定的位置中。
HTML 文件包含下列資訊:
- 綱目名稱。
- 綱目位置。
- 綱目的目標名稱空間。
- 綱目中提供的任何文件。
- 綱目中每一個元件的相關資訊,如元件的類型及其程式碼。根據元件的不同,可能還會提供元件的其他資訊。
當選取希伯來文邏輯 (ISO-8859-8-I) 編碼作為 HTML 檔編碼的喜好設定(在「建立檔案時」區段中,)時,從 XML 綱目檔產生的 HTML 文件檔仍會使用 UTF-8 編碼。這是一個已知的問題。