假設(shè)您已經(jīng)完成了內(nèi)容審查以確定應(yīng)該在哪里重用內(nèi)容,您已經(jīng)選擇了工具,現(xiàn)在您準(zhǔn)備使用DITA來開發(fā)XML格式的內(nèi)容。我把最近幾篇博文的所有部分放在一起,分享了DITA元素應(yīng)用于內(nèi)容時的樣子。我還將介紹如何解釋主題變化以及為什么要開發(fā)信息模型。
應(yīng)用DITA元素的示例
讓我們看一個例子?;趦?nèi)容復(fù)用的概念,組織最小有意義塊的內(nèi)容,假設(shè)我們有一個題目叫“如何驗(yàn)證包內(nèi)容”,這個題目有一些簡單的部分。這個主題在三個不同的產(chǎn)品中應(yīng)該是相同的,所以我們決定將它作為我們自己的主題,并在三個產(chǎn)品中重用它。該主題包含說明,因此我們希望將其用作任務(wù)信息類型。在任務(wù)元素中,可以使用20多個其他元素來構(gòu)建任務(wù)內(nèi)容。我們決定在介紹段落中使用上下文元素,在過程中使用步驟,在結(jié)果中使用結(jié)果。以下是我們示例中結(jié)構(gòu)類型、內(nèi)容和相關(guān)DITA元素的外觀:
結(jié)構(gòu)類型 | 內(nèi)容 | DITA元素 |
標(biāo)題1 | 如何驗(yàn)證包裝內(nèi)容 | 任務(wù)(標(biāo)題) |
介紹段落 | 開始前驗(yàn)證包裝內(nèi)容。 | 語境 |
(程序) 第一步 第二步 第三步 | 打開盒子。 找到裝箱單。 將內(nèi)容與裝箱單進(jìn)行比較。 | 步驟 |
結(jié)果 | 現(xiàn)在您已經(jīng)完成了驗(yàn)證包內(nèi)容的工作。 ![]() | 結(jié)果 |
使用條件屬性計算主題變化。
使用上面的例子,假設(shè)我們有第四個產(chǎn)品(產(chǎn)品D),它的描述是相同的,但是有一個額外的步驟。通過在XML創(chuàng)作程序中設(shè)置條件屬性(其中之一是product ),您仍然可以重用該主題。在這里,您可以添加不同的產(chǎn)品。然后,當(dāng)您對內(nèi)容進(jìn)行一些更改時,您可以將產(chǎn)品條件屬性應(yīng)用于特定的元素。發(fā)布產(chǎn)品內(nèi)容時,重用的主題將與具體的產(chǎn)品內(nèi)容一起顯示。
因此,DITA為您提供了處理異常的靈活性,這確實(shí)有助于構(gòu)建內(nèi)容重用案例,并再次降低了創(chuàng)建和翻譯的成本。
驗(yàn)證結(jié)構(gòu)
記錄信息模型中的元素
有許多DITA元素,并且通常有多種方法來定義結(jié)構(gòu),因此您應(yīng)該與團(tuán)隊(duì)一起確定如何構(gòu)建內(nèi)容。例如,完成這個過程后,您可能會發(fā)現(xiàn)只使用了20-30個元素。您所做的關(guān)于如何構(gòu)建內(nèi)容的決策應(yīng)該在一個稱為信息模型的文檔或Web輸出中捕獲,以便作者可以一致地創(chuàng)建內(nèi)容。信息模型應(yīng)該包含要使用的元素、描述、上下文和示例。
結(jié)論
將DITA應(yīng)用到內(nèi)容的過程包括做出內(nèi)容重用決策,然后使用DITA元素編寫內(nèi)容。在本系列的最后一篇博文中,我將討論發(fā)布XML內(nèi)容。