說明 > DITA 編寫概述 > 使用 DITA 內容參照 > DITA 內容參照概述
  
DITA 內容參照概述
DITA 內容參照 (conref) 可以讓您在一份 DITA 文件中包含另一份 DITA 文件中的元素內容。當使用內容參照包含其他文件中的內容時,包含的內容會取代參照元素中的任何內容。這種情況的一個例外是合併參照與被參照元素中的屬性,在供樣式和文件發行使用的解析文件中支援這樣的合併。
內容參照以元素為基礎,因此您所參照的元素必須與包含內容參照的元素相同。在文件中可檢視所參照的內容,但是無法編輯。您必須修改參照的原始來源,才能進行變更。Arbortext Editor 讓您可以使用資源管理員來查找要在文件中參照的內容。若您的文件中目前沒有有效的參照元素,資源管理員 會自動插入一個新的且空白的元素到您的文件中,以作為內容參照的目標。
內容參照由文件類型中的一個屬性來定義。屬性在文件類型組態檔案 (.dcf) 中定義。對於 DITA 文件而言,conref 屬性可在大部份 DITA 元素上使用,且可做為內容參照屬性使用。
在內容參照屬性中,參照 DITA 主題中元素的字串有以下格式:
[[path/]filename][#topic-id[/element-id]]
[[path/]filename] 是包含參照的檔案的選用參照。它可能是絕對或相對檔案名稱,可能包含路徑元件。如果未指定檔案名稱,則會假設參照在目前文件中。如果未指定絕對檔案名稱,則會使用 DITA 參照路徑來解析內容參照。
topic-id/element-id 是文件內 ID 屬性的導覽路徑。topic-id 是 DITA 主題元素的識別元 (或是主題的專門化,如概念、工作或參照),其中包含所參照的元素。element-id 是在該主題中要重複使用之元素的識別元,例如段落或清單項目。主題內的內容參照需要這兩者。如果忽略了 element-id,參照會包括整個主題。如果同時忽略了 topic-idelement-id,則會參照檔案中的第一個主題。
在內容參照屬性中,參照 DITA 圖 中元素的字串有以下格式:
[[path/]filename][#mapelement-id]
對於 DITA 圖中元素的參照而言,只有元素 ID 是必要的。如果忽略了 mapelement-id,則會參照整個圖。如果忽略了 filename,則會參照目前文件中的元素。
例如,假設 DITA 段落元素中包含以下內容參照:
<p conref=”C:\DITA content\releases.dita#product/version”></p>
conref 屬性會指示 p 元素內容應包含在含有 ID versionp 元素中,那是含有 ID product 的主題元素的子元素,它位於 releases.dita 文件中。所參照的 releases.dita 文件應包含以下元素:
<topic id=”product">
...
<p id=”version”>...</p>
..
</topic>