轻量级DITA - 让公司全员贡献结构化内容
1. 問題
一個朋友在一個生產型企業的文檔團隊負責產品文檔,他們使用DITA來編寫各類文檔,比如:公司管理文檔、產品介紹、產品使用說明、產品安裝手冊等。
DITA 是基于XML的體系結構,用于編寫、制作、交付面向主題的信息類型的內容。DITA的單源內容可以通過不同的方法進行重用,生成不同的交付內容。由于DITA過去用于大型技術手冊的編寫、管理和交付,它能夠滿足所有可能呈現給讀者的信息發布類型的要求。DITA可用于技術手冊、交互培訓,教材、標準、報告、商業文檔、貿易書籍、旅游和自然指南等書籍的編寫。
文檔工程師跟產品工程師溝通各種產品的細節,形成文檔的素材,然后根據這些素材編寫相關手冊。但是,公司所有人其實都產生內容,而文檔工程師在企業里人數屈指可數,文檔工程師輸出的內容有限。
文檔工程師熟悉XML/DITA及相關工具,這是他們的專業技能。但對于產品工程師、市場營銷人員、經理等角色的人,他們不懂什么是XML,什么是DITA,讓他們使用XML來寫文檔太為難他們了。怎樣能讓這些人不使用XML也能直接貢獻內容而又不失去結構化文檔的能力呢?
2. 解決方案
對于這種情況, OASIS在DITA的基礎上設計了lwDITA ( Lightweight DITA), 簡稱為輕量級DITA。
輕量級DITA(LwDITA)是達爾文信息類型體系結構(DITA)的簡化版本。輕量級DITA通過以下改進讓全員參與內容創作、協作和發布變為可能:
- 減少元素類型和屬性集
- 使用更嚴格的內容模型
- 減少功能集
- 并支持3中不同格式編寫 - XML,HTML5和Markdown
簡而言之,非文檔工程師使用類似于印象筆記的方式編寫文檔,文檔工程師使用以上提到的3種格式的任意一種來編寫,然后由文檔工程師把各種格式的內容匯集然后統一發布。
以下是輕量級DITA規范的整理:
趕快試試吧!
3. 參考
- LightWeidht DITA: http://docs.oasis-open.org/dita/LwDITA/v1.0/LwDITA-v1.0.html
總結
以上是生活随笔為你收集整理的轻量级DITA - 让公司全员贡献结构化内容的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: unity 检测电脑摄像头_Unity调
- 下一篇: 软件工程综合型实验