說明 > DITA 編寫概述 > 發行 DITA 文件
  
發行 DITA 文件
Arbortext Editor 可讓您同時發行 DITA 圖與 DITA 主題。針對 DITA 圖,您也可以選取圖的一部份,然後只發行圖的所選部份。
Arbortext Styler 樣式表 (.style) 會包括在內,以便用於每個預設 DITA 文件類型。您可以直接使用這些樣式表,或做為基礎開發您自己的c或自訂樣式表,以發行 DITA 文件。樣本樣式表也有模組化格式,可讓您使用現有模組做為建構區塊,來開發您的環境的樣式表。請參閱 Arbortext Styler 線上說明,以瞭解關於開發 DITA 文件樣式表的更多資訊。
您可以將 DITA 文件發行為下列輸出類型:
HTML
HTML 說明
Print
PDF
Web
EPUB
RTF
您也可以使用檔案 > 預覽列印,在發行之前預覽 DITA 文件。DITA 文件支援 Arbortext Editor 設定功能與 DITA 標準 DITAVAL 檔案,可讓您篩選發行輸出中的內容。
發行 DITA 主題與發行其他類型的文件類似。當您使用 Arbortext EditorArbortext Publishing Engine 發行 DITA 主題時,主題會根據關聯樣式表發行,並發行為特定的輸出格式。主題的發行方式如同包含在確保交叉參照與連結皆正確解析的 DITA 圖 中一般。但是,發行含交叉參照與連結的個別主題通常不會產生與發行參照所有主題的 DITA 圖 一樣的結果。發行主題通常對校對與檢閱更有用。通常,您應該從 DITA 圖 中執行最終發行。
DITA 圖 是 DITA 主題與其他內容的參照集合,因此當您發行 DITA 圖 時,發行過程會先將在圖中參照的所有內容組合成稱為經解析文件的中繼文件以供套用樣式。然後會根據關聯樣式表發行已解析文件,並發行為特定的輸出格式。如果圖包含 DITA 或其他類型文件的參照,而這些參照不包含在您要發行的圖中,發行過程會在發行期間收集這些參照的目標,以便在輸出中正確解析這些參照。參照的檔案皆儲存在資料夾中,該資料夾名稱以輸出文件為基礎,並在資料夾名稱中附加 .ditaLinks
您也可以透過 Arbortext Editor編輯 > 編輯已解析文件 > 用來套用樣式選單選項,來產生已解析文件的版本以套用樣式。此版本的已解析文件可以讓您使用 Arbortext Styler 來開發結構圖的樣式表。要套用樣式的經解析文件是僅計畫進行樣式表開發的暫時文件。與要編輯的經解析文件不同,您對套用樣式的經解析文件進行的任何變更在關閉經解析文件時不會反映在關聯主題中。
針對產生數個 HTML 檔案的 EPUB、HTML 說明與 Web 的輸出類型,依預設發行過程會保留 DITA 輸入檔案的名稱及包含輸入檔案的任何目錄結構。您可以在 Arbortext Styler 中變更這些及其他預設設定。
使用 deliveryTarget 屬性
您可使用 DITA 圖以及主題中主題參照 (topicref 元素) 上的 deliveryTarget 設定檔屬性,來控制在特定類型輸出中是否包括參照的主題或內容。在隨附的文件類型中,deliveryTarget 屬性具有以下允許的值︰
print-no - 不包含列印輸出中的主題
print-only - 包含列印輸出中的主題
這些值與 print 屬性所允許但已在 DITA 1.3 中已被取代的值相似。在 Arbortext Editor 中,仍支援 print 屬性。
建議為 deliveryTarget 屬性指定的值能夠反映出目標輸出類型,例如 epubpdfhtml
如果您要針對此目的使用 deliveryTarget 的值,必須在發行過程中選取必要值來作為設定檔設定。
如果主題參照中包含其他主題參照,父主題參照上的 deliveryTarget 屬性值可控制是否將所有主題參照包含在指定輸出中。在此情況下,會略過嵌套主題參照的 deliveryTarget 屬性值。
發行金鑰參照
Arbortext Editor 支援針對發行在 OASIS DITA Architectural Specification處理金鑰參照部份中定義的大多數金鑰參照處理。透過將文字插入到參照鍵定義的空白元素中,以及使用 conkeyref 屬性,可在發行期間支援文字內容取代。
在一些情況中,conkeyref 參照在參照中可能沒有主題 ID。 例如,當金鑰定義只包含主題的 URI,且內容金鑰參照所參照的是參照主題內的金鑰名稱與元素 ID 時。 URI 內參照的主題可能包含其他主題,這是由於其為 Ditabase 或包含嵌套主題,且那些主題可能包含具有相同 ID 的元素。 在這種情況下,Arbortext Editor 會假設主題內具有指定 ID 的第一個元素為內容參照的目標。 如果該主題包含多個具有相同 ID 的元素,這會導致不正確的元素變成內容參照的目標。 最佳做法是,確定您想要用於 conkeyref 參照的金鑰定義中包含主題 ID。