藉由 DITA 文件使用設定檔設定
DITA 文件支援
Arbortext Editor 建立設定檔功能。設定屬性的值皆顯示在「欄」檢視、「文件地圖」及
修改屬性對話方塊中。但是,您只能在
套用設定對話方塊中變更設定值。嘗試在「欄」檢視或「文件地圖」中變更屬性值會叫用
套用設定對話方塊。在
修改屬性對話方塊中,設定檔值都是唯讀的,且按鈕
可以用來叫用
套用設定檔對話方塊。
每一個預設 DITA 文件類型都有關聯設定組態檔案 (.pcf),它包含了下列基於標準 DITA 屬性的設定種類與值:
DITA 屬性 | 設定檔種類 | 設定檔值 |
audience | Audience | • Novice • Expert |
platform | Platform | • MS-Windows • Unix/Linux |
product | Product | • Project-X • Project-Y • Project-Z |
otherprops | Other | • Blue • Green |
您可以視需要變更與這些屬性關聯的設定種類與值。您也可以新增其他設定種類。請注意,雖然通常在 .pcf 檔案中會使用分號來分隔單一屬性的多個值,但 DITA 標準會使用空格來分隔多個值。依預設,DITA 文件類型 .pcf 檔案會使用空格來分隔單一屬性的多個值以符合標準。
預設的 .pcf 檔案也包含下列設定設定檔群組:
• Windows Expert - 可將 Platform 設定為 MS-Windows,並將 Audience 設定為 Expert。
• Unix Novice - 可將 Platform 設定為 Unix/Linux,並將 Audience 設定為 Novice。
延伸設定檔支援
以下是延伸預設設定支援的一些建議的方法:
• DITA 標準 otherprops 屬性 - 您可以針對自訂設定種類使用此屬性。
• 其他 DITA 標準屬性 - 雖然其他 DITA 標準屬性並不是要做為設定中繼資料使用,但您可以針對自訂設定種類使用類型為 CDATA 的標準 DITA 屬性。
• 專門化 DITA 屬性 - 您可以專門化 DITA 標準 props 屬性來建立設定種類所需要的任何屬性。
• 具有命名空間的屬性 — 您可以為設定屬性建立 XML 命名空間,並將該命名空間新增到 DITA 文件的根元素。
建議您針對要延伸設定以新增名稱宣告的 DITA 文件類型,修改範本與樣本文件。例如,以下是 DITA 主題範本文件的根元素:
<topic id="topic1">
以下是含有範例命名空間宣告的根元素:
<topic id="topic1" xmlns:custProf="http://www.acme.com/namespaces/profiling>
然後您可以使用在 .pcf 檔案的命名空間中定義的屬性來設定種類。請注意,您必須在屬性之前新增命名空間。例如,custProf:security。
您可以在文件中的任何元素上使用具有命名空間的屬性,即使是那些沒有標準 DITA 中繼資料屬性的也一樣。
如需配置建立設定檔的更多資訊,請參照 Customizer's Guide 的〈自訂您網站的建立設定檔組態〉。
DITAVAL 檔案與建立建立設定檔
DITA 標準也透過
DITAVAL 檔案為條件處理提供支援。您可以將 DITAVAL 檔案和設定檔案與您的 DITA 檔案搭配使用。但是,DITAVAL 檔案優先,且在 DITAVAL 檔案中定義的任何規則都會在任何設定生效之前套用。
透過下列方式,您可以將現有 .pcf 檔案作為 DITAVAL 檔案的基礎使用:
• 當您選擇 > > 或
編輯 DITAVAL 檔案來對 DITAVAL 檔案進行處理時,
DITAVAL 編輯器對話方塊會開啟,其中包含來自與目前主題或圖相關聯之任何
.pcf 檔案的設定資訊。
• 當在 Arbortext Editor 中直接處理 DITAVAL 檔案時,您可以選擇 > 來將 .pcf 檔案中的設定設定檔群組匯入至目前的 DITAVAL 檔案。
• 當在 DITAVAL 編輯器對話方塊中編輯 DITAVAL 檔案時,您可以使用匯入設定檔按鈕將來自 .pcf 檔案的設定檔設定與設定設定檔群組匯入至目前的 DITAVAL 檔案。
設定檔陰影
您可以配置彩色陰影來區分設定檔群組、屬性與值。如需有關針對設定檔值配置陰影的更多資訊,請參閱
針對建立設定檔的元素使用陰影。
針對 DITA 文件,當啟動設定檔陰影時,設定檔陰影顯示如下:
• 主題參照與元素內容會以為其設定檔/值設定的顏色顯示。
• 已建立設定檔的元素在「文件地圖」與「欄檢視」檢視中由
圖示指示
陰影會透過 set showprofileshading 指令啟動。
套用設定檔對話方塊會顯示針對文件類型實例配置的任何設定檔陰影。如需有關如何在對話方塊中顯示設定檔陰影的指南,請參照設定檔陰影。