平台利用自己的文件伺服器提供實際網頁給外掛程式文件。自訂伺服器可讓平台 採取與瀏覽器無關的方式處理 HTML 內容,並提供外掛程式方面的(知識)支援。對於您 身為外掛程式開發人員來說,主要差異是您在建構檔案和指定鏈結的方法上會有多一點 彈性。
您可以使用 zip 檔遞送文件,避免出現大量檔案時可能發生的問題。 在範例外掛程式中,我們建立一個稱為 html 的子目錄。另外,我們 可以將 html 檔放在一個稱為 doc.zip 的 zip 檔中。 這個 zip 檔 必須模擬外掛程式目錄下面的檔案結構。在我們的案例中,它必須包含子目 錄 html 以及 html 下面的所有內容。
解析檔案名稱時,說明伺服器查看 doc.zip 檔文件之後才查看外 掛程式目錄本身。href 中的引數若作為鏈結使用時,是假設它相對於現行外掛程式。請考量下列鏈結:
<topic label="Ref1" href="html/ref/ref1.html"/>
下列說明外掛程式將尋找這個檔案:
可用來參閱 Web 上任何內容的完整鏈結。
<topic label="Ref1" href="http://www.example.com/myReference.html"/>
平台說明系統使用與其他平台相同的國家語言目錄查閱綱要,以找出翻譯的檔案。(請參閱本端特定檔案 以取得目錄結構的詳細解釋。) 如果您正在使用 doc.zip 檔,應該為每一個語言環境製作 doc.zip 檔,並將它放置在正確的語言環境目錄之下。(您不應該在 ZIP 檔中複製 nl 本端目錄結構。)
href 引數可參閱其他外掛程式的內容。請使用說明伺服器所解析的特殊跨外掛程式參照註釋來完成:
<topic label="Ref1" href="../"another_plugin_id"/ref/ref1.html"/>
例如,您可以使用下列主題鏈結至程式設計師手冊的這一章節:
<topic label="Help Chapter in Platform Doc" href="../org.eclipse.platform.doc.isv/guide/help.html"/>
附註:從其他外掛程式參照內容時,請確定外掛程式的 ID,如同在它的 plugin.xml 檔中所宣告的, 而不是它的目錄名稱。當練習時這些都是相同的,所以檢查您是使用 ID 而非目錄名稱是很重要的。