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