了得網工業技術_DITA最佳實踐指南——創作、編排和架構的技術路線

編輯推薦

《DITA**實踐指南--創作編排和架構的技術路線》由貝拉米、Michelle Carey、Jenifer
Schlotfeldt所著，本書由三大部分、合計13章構成。三大部分分別是應用DITA創作、架構內容、轉換與編排。本書圖文並茂，通過“不正確和正確”實例的對比，讓讀者非常容易地理解和應用DITA體繫；給出實施時的核實清單；通過貼士，對體繫中涉及的各個環節的技巧予以高度概括；給出應當留意的事項；總結重點內容……

內容簡介

《DITA*實踐指南：創作、編排和架構的技術路線》由三大部分共13個章節構成。部分是《DITA*實踐指南：創作、編排和架構的技術路線》的基礎訓練部分，描述3類基本主題（即任務主題、概念主題和參引主題）的定義，重點介紹各自的創作指導方針。第二部分介紹了DITA圖、數據和一些其他的有用話題，如條件處理和內容重用，幫助讀者學會架構信息。第三部分與DITA的實施技術路線密切相關，幫助讀者學會將信息轉換成DITA、掌握DITA的編排和評審、正確地應用D素、掌握如何有效地進行內容編排。

《DITA*實踐指南：創作、編排和架構的技術路線》是實用的技術圖書，既可以作為提高信息素養的基礎教材，也可以作為信息技術高端人纔的參考書。由於《DITA*實踐指南：創作、編排和架構的技術路線》涉及DITA體繫的全部內容，因此，信息內容體繫創建中所有相關角色都可以從中受益，如信息內容的創作者和編排者、信息架構師、信息內容繫統開發人員等。

作者簡介

李穎博士，中國科學技術信息研究所信息技術支持中心副研究員、碩士生導師。1998年開始，專門從事基於XML網絡資源繫統的設計與開發，並針對XML Topic Maps在不同領域的應用進行了長期研究，如數字出版、數字圖書館、科技文獻、金融、制造業和醫療繫統等。目前，主要結合主題（Topic）與自然語言處理的各種技術，開發語義知識服務繫統，包括知識的獲取與構建、倉儲、關聯與導航，以及滿足個性化需求的智能化數據分析服務。
在國內出版了關於XML的專著《未來網絡的基磐技術——XML的理論與應用》。近5年，參與相關部級以上項目10餘項，以作者身份在國內外發表相關學術論文30餘篇。

譯者序
閱讀指導
序言
部分應用DITA創作
第1章基於主題的創作
1.1 圖書、主題和信息網絡
1.2 主題創作的優勢
1.3 DITA主題的類型
1.4 面向任務
1.5 極簡主義創作
1.6 要點小結
1.7 基於主題創作的核實清單
1.8 任務分析表
第2章任務主題譯者序
閱讀指導
序言
部分應用DITA創作
第1章基於主題的創作
1.1 圖書、主題和信息網絡
1.2 主題創作的優勢
1.3 DITA主題的類型
1.4 面向任務
1.5 極簡主義創作
1.6 要點小結
1.7 基於主題創作的核實清單
1.8 任務分析表
第2章任務主題
2.1 將任務信息與概念性或參引性信息分離
2.2 任務組件和D素
2.3 要點小結
2.4 任務主題核實清單
第3章概念主題
3.1 一個主題描述一個概念
3.2 創建概念主題的時機
3.3 將任務信息和概念性信息分開
3.4 概念組件和D素
3.5 要點小結
3.6 概念主題核實清單
第4章參引主題
4.1 每個主題隻描述一種類型的參引資料
4.2 有效地組織參引信息
4.3 使參引信息格式一致
4.4 參引組件和D素
4.5 要點小結
4.6 參引主題核實清單
第5章簡短描述
5.1 5.2 創建有效簡短描述的指導方針
5.3 任務主題、概念主題和參引主題的簡短描述
5.4 為轉換內容創作簡短描述
5.5 5.6 要點小結
5.7 簡短描述樣例
5.8 簡短描述核實清單
第二部分架構內容
第6章 DITA圖和導航
6.1 DITA圖的結構
6.2 信息組織
6.3 信息建模
6.4 書籍圖
6.5 子圖
6.6 DITA圖的所有權
6.7 參引非DITA內容
6.8 在DITA圖中包含關繫表
6.9 重寫主題標題和簡短描述
6.10 簡短描述
6.11 阻止在目錄中輸出主題
6.12 禁止在PDF中輸出內容
6.13 禁止在HTML中輸出顯示內容
6.14 要點小結
6.15 導航和DITA圖核實清單
第7章鏈接
7.1 層級鏈接
7.2 內嵌鏈接
7.3 控制鏈接的顯示方式
7.4 相關鏈接
7.5 集合類型
7.6 用重要性屬性創建鏈接
7.7 鏈接範圍
7.8 鏈接的相關路徑
7.9 鏈接測試
7.10 要點小結
7.11 鏈接核實清單
第數據
8數據的重要性
8數據的類型
8.3 數據
8數據繼承
8.5 要點小結
8數據核實清單
第9章條件處理
9.1 條件處理屬性
9.2 創建條件處理方案
9.3 應用條件處理屬性
9.4 多條件和復合條件
9.5 識別應用的條件值
9.6 測試方案
9.7 為創作團隊改善內容的可檢索性
9.8 要點小結
9.9 條件處理核實清單
第10章內容重用
10.1 重用的益處
10.2 內容重用方法
10.3 通過使用內容參引素
10.4 主題重用
10.5 重用DITA圖
10.6 重用非DITA源的內容
10.7 實現重用的創作
10.8 重用內容的選擇
10.9 跟蹤重用
10.10 要點小結
10.11 重用核實清單
第三部分轉換與編排
第11章轉換內容為DITA
11.1 轉換目標
11.2 建立先導團隊
11.3 轉換流程
11.4 要點小結
11.5 轉換測量表
11.6 DITA轉換核實清單
第12章 DITA代碼編排
12.1 代碼審核
12.2 識別代碼審核員
12.3 限定審核範圍
12.4 準備代碼審核
12.5 實施代碼審核
12.6 為內容而非主題形式的代碼審核
12.7 要點小結
12.8 代碼審核核實清單
第13章內容編排
13.1 定義、調度和提交內容編排
13.2 提供編排反饋
13.3 編排DITA主題和DITA圖的內容
13.4 編排輸出
13.5 要點小結
13.6 內容編排核實清單
附錄A DITA 1.素(A~Z)
附錄B DITA 素結構化分層表
附錄C 術語表

在線試讀

部分應用DITA創作
“極簡主義”（minimalism，也稱為簡約主義）的表現之一是關注用戶目標的面向任務的主題。為更容易地創作這樣的主題，DITA應運而生。DITA（Darwin Information Typing Architecture，達爾文信息類型化體繫結構）是專為創作、組織、鏈接基於主題的內容而設計的。DITA所帶來的益處不局限於閱讀產品信息的讀者，在技術信息交付客戶之前，DITA為其創作者與編輯者也提供了眾多的便利。
對於信息的用戶來說，基於主題精心創作的信息能夠提升檢索性、導航性和可用性。而對於創作團隊來說，基於主題的有效創作能夠提供更多重用的機會、信息的快速重組、更便捷的文件管理和更靈活的鏈接。
為使你更容易轉向DITA，本書部分提供創作任務主題、概念主題和參引主題的指導方針。這些主題中有很多通用但有時具有挑戰性的素，你將學到如何素創作有效的內容。
本部分還闡述了素創作有效的簡短描述。也許是DITA中挑素。實際上，正是因為如此具有挑戰性，第5章專門介紹這部分內容。
第1章基於主題的創作
“Topic”(本書統稱為主題)除具有話題之意外，還有何意？在技術信息中，一個主題，有時也稱為一個條目(article)，具有一個標題和一些內容。每個主題都包含正好足以獨立存在的有意義的內容，但是內容又不會太多，會涵蓋一個過程或一個概念，或一類參引信息(reference information，也稱為參考信息)。
盡管主題應該是自包含的(self-contained)實體，但是它不應該獨立存在。針對伴隨大多數技術產品、服務或技術等一起交付的信息，主題需要在一個更大的有組織的主題集合中存在。這一集合能以HTML網頁、在線幫助或者PDF手冊等各種輸出形式打包和交付。
DITA，即達爾文信息類型化體繫結構，被專門設計用來支持基於主題的創作。利用其基於模塊的架構、語義素和強大的鏈接功能，DITA能夠幫助創作者創建並維護基於主題或者組件化的技術信息。
創作基於主題的信息對於產品用戶和寫作團隊都有益處。但是，將信息細分為不同的主題類型還不夠。為保證信息能夠滿足用戶的需求，創作者需要理解如何創作極簡、面向任務的信息。
1.1 圖書、主題和信息網絡部分應用DITA創作
“極簡主義”（minimalism，也稱為簡約主義）的表現之一是關注用戶目標的面向任務的主題。為更容易地創作這樣的主題，DITA應運而生。DITA（Darwin Information Typing Architecture，達爾文信息類型化體繫結構）是專為創作、組織、鏈接基於主題的內容而設計的。DITA所帶來的益處不局限於閱讀產品信息的讀者，在技術信息交付客戶之前，DITA為其創作者與編輯者也提供了眾多的便利。
對於信息的用戶來說，基於主題精心創作的信息能夠提升檢索性、導航性和可用性。而對於創作團隊來說，基於主題的有效創作能夠提供更多重用的機會、信息的快速重組、更便捷的文件管理和更靈活的鏈接。
為使你更容易轉向DITA，本書部分提供創作任務主題、概念主題和參引主題的指導方針。這些主題中有很多通用但有時具有挑戰性的素，你將學到如何素創作有效的內容。
本部分還闡述了如何為也許是DITA中挑素。實際上，正是因為如此具有挑戰性，第5章專門介紹這部分內容。
第1章基於主題的創作
“Topic”(本書統稱為主題)除具有話題之意外，還有何意？在技術信息中，一個主題，有時也稱為一個條目(article)，具有一個標題和一些內容。每個主題都包含正好足以獨立存在的有意義的內容，但是內容又不會太多，會涵蓋一個過程或一個概念，或一類參引信息(reference information，也稱為參考信息)。
盡管主題應該是自包含的(self-contained)實體，但是它不應該獨立存在。針對伴隨大多數技術產品、服務或技術等一起交付的信息，主題需要在一個更大的有組織的主題集合中存在。這一集合能以HTML網頁、在線幫助或者PDF手冊等各種輸出形式打包和交付。
DITA，即達爾文信息類型化體繫結構，被專門設計用來支持基於主題的創作。利用其基於模塊的架構、語義素和強大的鏈接功能，DITA能夠幫助創作者創建並維護基於主題或者組件化的技術信息。
創作基於主題的信息對於產品用戶和寫作團隊都有益處。但是，將信息細分為不同的主題類型還不夠。為保證信息能夠滿足用戶的需求，創作者需要理解如何創作極簡、面向任務的信息。
1.1 圖書、主題和信息網絡
圖書(book)的形式對某些內容來說非常好，例如懸疑小說、復雜的科學概念和哲學思考等。但是，圖書對於交付定向的技術內容給那些需要完成現實世界任務的用戶來說，不是好的載體。
那些以敘述性圖書模型組織的信息通常有以下特征:
?開頭、中間和結尾內容傾向於被按照從頭到尾的線性順序閱讀。
?部分(section，節或段落)中的內容常常混合著任務、概念和參引信息。
盡管敘述性圖書模型非常適合於小說和一些非虛構類書籍，但是這一模型並不適合於隨產品一並交付的技術信息。當需要調節摩托車閥門的時候，用戶不想閱讀一本小說。他們需要打開摩托車手冊，找到一項專門的任務(對應的操作)，然後開始調節閥門。
主題(topic)是自包含的。一個有效的主題僅包括一個論題。每個主題既要足夠長以保證有獨立的意義，又要足夠短以保證聚焦於一個要點，而不擴展到別的論題。
一個主題通常回答以下問題中的一個：
?如何做？
?這是什麼？
?過程怎樣？
?如何處理這個問題？
因為大部分用戶一次隻需要很少量的信息，所以應該創建能夠直接回答特定問題的信息，而不需要通讀大量交織在一起的信息內容。
將信息細分成為一個個獨立的主題，幫助創作者：
?更容易且更一致地設計新的信息。
?去除無關緊要的或冗餘的信息。
?識別出通用或可重用的主題或者主題中的內容片斷。
不論其目的如何，所有的主題都具有如下特征：
?有意義的標題。
?能夠有獨立於其他內容的特點。
?邏輯化的組織。
?鏈向包括相關信息的其他主題。
通過進行組織和鏈接主題，創建相互關聯的信息網絡(web of information)，如圖1.1所示。終，這一主題集合的輸出可能是在線幫助繫統、PDF格式手冊或者一個網站。盡管由主題構成的網絡起初看起來比較混亂，但是DITA能夠幫助你組織和鏈接主題，使得用戶不會在內容中迷航。
通過以獨立的主題創作信息、將這些主題組織成為邏輯化的集合，然後進一步將相關的主題鏈接到一起，這樣就能夠創建易於導航、易於理解並易於使用的信息網絡。
1.2 主題創作的優勢
基於主題方式創作技術信息不僅能夠使用戶更容易地找到和使用信息，也給創作者(writer)、信息架構師(information architect)和編排者(editor)帶來極大的便利。
1.2.1 創作者能更有成效地工作
在機構當中，可能多個創作者一起就相關特性或者某項功能領域的內容進行創作。為了更有成效，每個創作者可以貢獻特定的幾個主題以支持這些相關特性或功能。
例如，對於復雜的企業數據庫繫統的安裝指南，每個創作者可以隻負責一部分安裝信息。一個創作者可能負責關於啟動安全的信息，另外一個創作者可能負責關於安裝計劃的信息。
當采用主題方式創作時，多個創作者共同貢獻於一個較大規模的信息集合，這樣更容易實施和更有成效。
1.2.2 創作者能與其他創作者共享內容
文件越大，那麼和其他創作者一起用此文件進行內容創作的難度也就越大。假定有一個50頁的文件，每次在使用這個文件創作的時候，50頁的內容就被鎖定，其他創作者就無法利用。
通過主題，可以隨時在一個很小的內容集合上工作，因為每一個主題對應一個文件。這使得更多的創作者可以存取其他大部分的信息。
1.2.3 創作者可以重用主題
通過重用內容，機構可以時間和各類資源。對於多個產品，或為了不同的受眾，或針對多個信息集和多種輸出格式，創作者都能重用主題。
例如，創作者可以在一本書中，也可以在幫助繫統中包含同一個主題，或者在產品資料庫之間共享多個主題。如果被共享的主題中存在不是每個產品都很合適或都需要的內容，那麼創作者可以使用條件處理屬性刪除那些不合適的內容，而不需要就大體一致的內容創作和維護兩個主題。
1.2.4 創作者可以更快地組織或重組內容
以敘述流或圖書結構設計的信息很難實現快速重組。例如，如果將組裝摩托車引擎的操作指南創作成為獨立的任務主題，那麼當摩托車引擎設計發生變更的時候，創作者能夠很容易地調整這些任務主題的順序。
1.2.5 審核者能夠對一小組主題進行審核而不是一整本書
在產品開發周期中，創作者可以每次向審核者(reviewer)提交一小組主題甚至單個主題去審核，而不是要求編排者、信息架構師或者技術專家去審核長篇幅的書稿。如果審核者能夠閱讀少量較短的主題而不是需要梳理一個100頁的章節，那麼創作者很有可能獲得更好的審核反饋。
1.3 DITA主題的類型
使用技術信息的用戶經常需要至少三類內容：過程、背景或者概念信息和快速參考信息。大多數用戶都不需要這三類信息的混合體。例如，埋沒在一大段概念信息中的過程，或者在過程中間插入混雜命令的一個表格。
圖1.2展示了混合信息類型使特定的信息片段難以發現。這個主題使用的標題看似說明這段信息為概念性的，並且也的確描述了核能是如何產生的。但是，接下來該主題開始脫軌到討論如何將濃咖啡機連接到核反應堆的任務。更糟糕的是，主題還包括一個命令表，而且沒有一個與核聚變如何產生能源相關。大多數用戶都不會指望在一個被稱做“作為能源的核聚變”的主題中發現任務信息甚至一個命令列表。
為了便於創建和交付按照類型和目的進行有效細分的信息，DITA提供了三種主題類型：概念主題、任務主題和參引主題。
?任務主題描述一個過程。
?概念主題定義某事物是什麼或者一個處理如何運作。
?參引主題包含用戶在執行其任務時可能會需要的參考性信息。
表1.1顯示了概念主題、任務主題和參引主題在標題上的差異。
將內容按類型細分，可以避免用戶涉足於他們不需要的信息。例如，當次需要安裝一套家庭娛樂繫統時，用戶並不需要了解遙控器上的所有按鈕(參考性信息)，而隻需要安裝指導。把參考性信息與任務信息分開，使用者能夠更快地安裝他們的繫統。
按照類型細分內容也能幫助特定的用戶找到其所需信息。例如，新用戶更有可能需要概念性信息；行家更可能直奔過程和參考性材料，而不理會概念信息。
1.4 面向任務
1.4.1 基本概念
僅僅按類型細分內容還不足以保證信息能夠滿足用戶的需求。為幫助用戶利用產品實現現實世界的目標，創建的主題必須面向任務。例如，用戶可能需要完成以下一些現實世界的目標：
?處理向銀行貸款的申請。
?在屋頂安裝太陽能電池板來降低能源成本。
?通過提升業務流程的效率以增加收入。
?讓醫生能夠獲取電子醫療記錄。
?為汽車制造音響設備。
?安裝企業郵件繫統以使雇員工作更有成效。
技術創作者、編排者、信息架構師的工作就是創作關於產品的信息以幫助用戶完成這些目標，而不僅僅是簡單描述產品如何工作。為了創建有效面向任務的信息，請遵循如下指導方針：
?關注用戶目標而不是產品的運行方式。
?從用戶的視角來創作，用主動語態創作。
?鎖定合適的受眾。

商品搜索

商品分类

【醫學】

【各大出版社】