平台利用自己的文件伺服器提供實際網頁給外掛程式文件。自訂伺服器可讓平台 採取與瀏覽器無關的方式處理 HTML 內容,並提供外掛程式方面的(知識)支援。對於您 身為外掛程式開發人員來說,主要差異是您在建構檔案和指定鏈結的方法上會有多一點 彈性。
您可以使用 zip 檔遞送文件,避免在外掛程式目錄中出現大量檔案時可能發生的問題。 在範例外掛程式中,我們建立一個稱為 html 的子目錄。另外,我們可以將 html 檔放在一個稱為 doc.zip 的 zip 檔中。 這個 zip 檔必須模擬外掛程式目錄下面的檔案結構。在我們的案例中, 它必須包含子目錄 html 和 html 下面的所有內容。
解析檔案名稱時,說明伺服器查看 doc.zip 檔文件之後才查看外掛程式目錄本身。href 中的引數若作為鏈結使用時,是假設它相對於現行外掛程式。請考量下列鏈結:
<topic label="Ref1" href="html/ref/ref1.html"/>
下列說明外掛程式將尋找這個檔案:
從 3.0 版開始,整個外掛程式可以安裝為壓縮格式,並直接從 jar 來執行。當 特性 Manifest 中的 plugin
元素的 unpack
屬性值指定為 true 時,外掛程式安裝 jar 不會展開到外掛程式目錄中。在這類的外掛程式中,文件是和其他的外掛程式檔案一起壓縮在外掛程式的 jar 中。文件並不需要另外包含在 doc.zip 中,且說明系統不支援這種 doc.zip 設定在未解開的外掛程式 jar 中。
可用來參閱 Web 上任何內容的完整鏈結。
<topic label="Ref1" href="http://www.example.com/myReference.html"/>
平台說明系統使用與其他平台相同的國家語言目錄查閱綱要,以找出翻譯的檔案。(請參閱本端特定檔案 以取得目錄結構的詳細解釋。)如果您正在使用 doc.zip 檔, 應該為每一個語言環境產生 doc.zip 檔,並將它放置在正確的語言環境目錄中。 (您不應該在 doc.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 而非目錄名稱是很重要的。