您可以為一些說明喜好設定指定自訂的預設值,配合產品來配置 Eclipse 說明系統並且設定品牌。
說明系統本身分為許多不同的外掛程式。
下列表格將列出可用的喜好設定,以及定義它們的外掛程式。
有關如何置換這些喜好設定,請參閱自訂產品。
喜好設定鍵 | 用法 |
預設值 |
baseTOCS |
排列目錄的順序。 說明 TOC(書籍)或 TOC 種類的有序清單,就像在書架上顯示一樣。其他所有 TOC 和種類接在後面。 不在此清單上的 TOC 或種類將被忽略。對於 TOC,請使用 TOC 的位置,例如 /pluginId/path/to/toc.xml。對於種類,請使用種類 ID。 | /org.eclipse.platform.doc.user/toc.xml, |
ignoredTOCS |
停用 TOC。說明系統將忽略的 TOC(書籍)或 TOC 種類的清單。 停用的 TOC/種類不會出現在書籍清單中,無法連結。無法搜尋已停用目錄所定義的主題。 不在此清單中的 TOC 或種類將被忽略。對於 TOC,請使用 TOC 的位置,例如 /pluginId/path/to/toc.xml。對於種類,請使用種類 ID。 |
喜好設定鍵 | 用法 |
預設值 |
banner |
要顯示在頁框頂端橫幅頁的位置 範例: banner=/org.eclipse.help.webapp/advanced/banner.html |
|
banner_height |
橫幅頁框的高度 範例: banner_height=60 |
|
help_home |
在開啟說明時,顯示在內容區的網頁。
請把您的 html 網頁指定為 /pluginId/path/to/home.html 。
|
/org.eclipse.help.base/doc/help_home.html |
linksView |
設為 true 或 false 來控制相關鏈結視圖的可見性。附註:這個選項不會影響 InfoCenter。 |
true |
bookmarksView |
設為 true 或 false 來控制書籤視圖的可見性。附註:這個選項不會影響 InfoCenter。 |
true |
windowTitlePrefix |
設為 true 或 false 來控制瀏覽器視窗的標題。
如果是 true ,
則標題格式為「說明 - <PRODUCT_NAME> 」,
否則,標題為「<PRODUCT_NAME> 」,
其中 <PRODUCT_NAME> 是指主要特性所設定的 Eclipse 產品的名稱。
|
true |
loadBookAtOnceLimit |
一本書最多可以擁有的主題數目(針對瀏覽器要載入成一本書的導覽)。 大型書籍的導覽是屬於動態載入,一次只載入幾層。 當分支展開時,也會根據需求而下載更多主題。 | 1000 |
dynamicLoadDepthsHint |
下載到大型書籍之瀏覽器的主題導覽的建議層次數目。
這個值必須大於 0 。如果建議的層次數目含有大量主題,寬樹狀結構實際的層次數可能會不同。
|
3 |
imagesDirectory |
含有說明視圖所用影像的目錄。
影像必須與 org.eclipse.help.webapp 外掛程式中的影像同名。
請使用 /pluginID/directory 格式。 |
images |
advanced.toolbarBackground |
工具列的 CSS 背景。該值是用於顯示進階說明 UI 的瀏覽器。 | ButtonFace |
advanced.viewBackground |
導覽視圖的 CSS 背景。 該值是用於顯示進階說明 UI 的瀏覽器。 | Window |
advanced.toolbarFont |
工具列的 CSS 字型。該值是用於顯示進階說明 UI 的瀏覽器。 | icon |
advanced.viewFont |
導覽視圖的 CSS 字型。該值是用於顯示進階說明 UI 的瀏覽器。 | icon |
basic.toolbarBackground |
工具列的背景顏色。該值是用於顯示基本說明 UI 的瀏覽器。 | #D4D0C8 |
basic.viewBackground |
導覽視圖的背景顏色。該值是用於顯示基本說明 UI 的瀏覽器。 | #FFFFFF |
locales |
Infocenter 會辨識和提供自訂內容的語言環境清單;
如果用戶端瀏覽器接受的語言環境(或語言),沒有一個與清單中的語言環境一樣,
則提供給瀏覽器的,是預設語言環境(伺服器語言環境或
Eclipse -nl
指令行選項所指定的語言環境)的內容;
如果沒有指定清單,
則提供給瀏覽器的,是它的偏好語言環境內容;
附註:如果沒有這個選項,可能會產生大量的記憶體和磁碟空間需求,因為在存取 Infocenter 的瀏覽器中,每一個不同的偏好語言環境都會建立導覽和索引。
範例: locales=en ja zh_CN
zh_TW |
|
productIndex |
如果預先產生以及預先建置的文件索引,是附隨在產品中一起提供, 則遞送索引的外掛程式 ID,必須指定給這裡的說明系統。 | |
always_external_browser |
可能的話,儘可能採用內嵌瀏覽器(Windows 或 Linux),否則就一律採用外部瀏覽器。
如果設為 true,則會強迫使用外部瀏覽器。
如果內嵌的瀏覽器不能用在給定的平台上,則選項沒有影響。
|
false |
default_browser |
預設外部瀏覽器。其中一個提供給說明系統所要用的 org.eclipse.help.base.browser 延伸點的外部 Web 瀏覽器 ID。
瀏覽器的配接器 在獨立式說明模式中,這個喜好設定控制外部瀏覽器。 在工作台模式中,說明使用工作台瀏覽器支援所提供的瀏覽器。 |
根據系統上所能使用的瀏覽器,而動態設定的預設值
|
custom_browser_path |
自訂瀏覽器的執行路俓 在獨立式說明模式中,這個喜好設定控制外部瀏覽器。 在工作台模式中,說明使用工作台瀏覽器支援所提供的瀏覽器。 |
C:\Program
Files\Internet Explorer\IEXPLORE.EXE" %1 - on
Windows,"konqueror %1" - on
Linux"mozilla %1" - on
other platforms |
showDisabledActivityTopics |
說明系統是從停用的功能來過濾主題。
這個選項可以控制這項行為,以及「顯示所有的主題」按鈕的存在。
下面是它所接受的值: never 、off 、on 、always never - 不顯示停用功能中的主題off - 使用者可以選擇顯示所有主題,最初隱藏的停用主題on - 使用者可以選擇顯示所有的主題,所有最初顯示的主題
always - 顯示停用功能中的主題(停用過濾) |
off |
activeHelp |
可以啟用和停用作用說明的執行作業。
這個選項在停用作用說明的 InfoCenter 設定中,沒有任何影響。
接受的值: true - 啟用預設作用說明動作false - 停用作用說明架構 |
true |
window_infopop |
在工作台視窗中按下說明鍵時,容許啟用舊式蹦現資訊。如果為 false,則會開啟新的動態說明視圖。 | false |
dialog_infopop |
在對話框中按下說明鍵時,容許啟用舊式蹦現資訊。如果為 false,則會開啟新的動態說明視窗。 |
false |
喜好設定鍵 | 用法 |
預設值 |
port |
伺服器接聽 HTTP 要求的埠號。 如果未給定埠,則系統會任意挑選一個埠。 | |
host |
連接伺服器所用的主機位址或名稱。 它沒有預設值,Eclipse 會挑選一個可以使用的本端位址。 在本端模式中(工作台或獨立式,不是 InfoCenter)使用說明的產品,可以將這個喜好設定設為 " |
喜好設定鍵 | 用法 |
預設值 |
acceptCount |
當所有處理執行緒的要求在使用中時,後續連線要求的佇列長度上限。 佇列已滿時所接獲的任何要求,都會遭到拒絕。 | 100 |
maxProcessors |
處理這個連接器所要建立之執行緒的要求數目上限,它代表可以同時處理的要求數目上限。
|
75 |
minProcessors |
處理執行緒之要求的數目,這些執行緒是在這個連接器第一次啟動時所建立。
這個屬性值應該要比 maxProcessors 的值更小。
|
5 |