1. 問題

一個朋友在一個生產(chǎn)型企業(yè)的文檔團(tuán)隊負(fù)責(zé)產(chǎn)品文檔，他們使用DITA來編寫各類文檔，比如：公司管理文檔、產(chǎn)品介紹、產(chǎn)品使用說明、產(chǎn)品安裝手冊等。

DITA 是基于XML的體系結(jié)構(gòu)，用于編寫、制作、交付面向主題的信息類型的內(nèi)容。DITA的單源內(nèi)容可以通過不同的方法進(jìn)行重用，生成不同的交付內(nèi)容。由于DITA過去用于大型技術(shù)手冊的編寫、管理和交付，它能夠滿足所有可能呈現(xiàn)給讀者的信息發(fā)布類型的要求。DITA可用于技術(shù)手冊、交互培訓(xùn)，教材、標(biāo)準(zhǔn)、報告、商業(yè)文檔、貿(mào)易書籍、旅游和自然指南等書籍的編寫。

文檔工程師跟產(chǎn)品工程師溝通各種產(chǎn)品的細(xì)節(jié)，形成文檔的素材，然后根據(jù)這些素材編寫相關(guān)手冊。但是，公司所有人其實(shí)都產(chǎn)生內(nèi)容，而文檔工程師在企業(yè)里人數(shù)屈指可數(shù)，文檔工程師輸出的內(nèi)容有限。
文檔工程師熟悉XML/DITA及相關(guān)工具，這是他們的專業(yè)技能。但對于產(chǎn)品工程師、市場營銷人員、經(jīng)理等角色的人，他們不懂什么是XML，什么是DITA，讓他們使用XML來寫文檔太為難他們了。怎樣能讓這些人不使用XML也能直接貢獻(xiàn)內(nèi)容而又不失去結(jié)構(gòu)化文檔的能力呢？

2. 解決方案

對于這種情況， OASIS在DITA的基礎(chǔ)上設(shè)計了lwDITA ( Lightweight DITA)， 簡稱為輕量級DITA。

輕量級DITA（LwDITA）是達(dá)爾文信息類型體系結(jié)構(gòu)（DITA）的簡化版本。輕量級DITA通過以下改進(jìn)讓全員參與內(nèi)容創(chuàng)作、協(xié)作和發(fā)布變?yōu)榭赡?#xff1a;

• 減少元素類型和屬性集
• 使用更嚴(yán)格的內(nèi)容模型
• 減少功能集
• 并支持3中不同格式編寫 - XML，HTML5和Markdown

簡而言之，非文檔工程師使用類似于印象筆記的方式編寫文檔，文檔工程師使用以上提到的3種格式的任意一種來編寫，然后由文檔工程師把各種格式的內(nèi)容匯集然后統(tǒng)一發(fā)布。

以下是輕量級DITA規(guī)范的整理：

趕快試試吧！

3. 參考

• LightWeidht DITA: http://docs.oasis-open.org/dita/LwDITA/v1.0/LwDITA-v1.0.html

總結(jié)

以上是生活随笔為你收集整理的轻量级DITA - 让公司全员贡献结构化内容的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。