DITA在汽車服務(wù)手冊數(shù)字出版的應(yīng)用

黃達潛，陳 振，聶嘉晗

DITA在汽車服務(wù)手冊數(shù)字出版的應(yīng)用

黃達潛，陳 振，聶嘉晗

（比亞迪汽車工業(yè)有限公司，廣東 深圳 518118）

達爾文信息類型化體系結(jié)構(gòu)（DITA）是一種基于可擴展標記語言（XML）的面向主題的數(shù)字化內(nèi)容結(jié)構(gòu)化寫作與發(fā)布方案，DITA使信息具有的可檢索、可組織、可重用特性，支持快速生成服務(wù)不同受眾和終端展現(xiàn)的出版物，被更多汽車企業(yè)所使用。結(jié)合汽車維修技術(shù)信息公開法規(guī)、標準等要求，對DITA在汽車服務(wù)手冊類型與信息分類、主題、架構(gòu)、內(nèi)容重用等方面進行介紹，對印刷版與電子版手冊進行信息架構(gòu)與建模，實現(xiàn)交付物的多樣化應(yīng)用。

DITA；服務(wù)手冊；DITA主題；映射圖；內(nèi)容重用

為提高生產(chǎn)力與產(chǎn)品質(zhì)量，汽車行業(yè)通常對零部件采取最大限度的標準化、通用化，進而組合成整車；在汽車服務(wù)信息出版方面，為提高內(nèi)容創(chuàng)作的效率和出版更優(yōu)質(zhì)的作品，使用達爾文信息類型化體系結(jié)構(gòu)（Darwin Information Typing Architecture, DITA）通過服務(wù)信息“組件化”和“重用”功能，實現(xiàn)服務(wù)手冊創(chuàng)作規(guī)范化、均一化，是汽車企業(yè)首選的應(yīng)用方案[1]。

1 DITA概述與應(yīng)用背景

1.1 DITA概述

DITA最初于2001年由IBM公司為解決信息內(nèi)容從生產(chǎn)到發(fā)布中信息載體的標準化描述、規(guī)范化組織、統(tǒng)一化存儲、異地共享與協(xié)調(diào)作業(yè)等問題提出，目前由結(jié)構(gòu)化信息標準促進組織（Orga- nization for the Advancement of Structured Informa- tion Standards, OASIS）的DITA技術(shù)委員會管理。

DITA是一種基于可擴展標記語言（Extensible Markup Language, XML）與面向主題（topic）的數(shù)字化內(nèi)容結(jié)構(gòu)化寫作與發(fā)布方案，即通過定義一套文檔類型定義（Document Type Definition, DTD）或Schema標準的數(shù)字出版物的文檔格式[2-4]。DITA的信息模型和其工作流程已整合多種應(yīng)用，如內(nèi)容管理系統(tǒng)（Content Management System, CMS）、XML編輯器等。

1.2 汽車維修技術(shù)信息公開

《汽車維修技術(shù)信息公開實施管理辦法》（交運發(fā)〔2015〕146號）從安全、環(huán)保角度，要求汽車生產(chǎn)者應(yīng)向社會公開汽車維修技術(shù)信息，其附件《汽車維修技術(shù)信息公開目錄（2015年版）》規(guī)定公開技術(shù)信息包括汽車維修手冊、零部件目錄、技術(shù)服務(wù)通告等信息內(nèi)容，以保障車輛維修后安全、排放性能達標。對公開信息，企業(yè)結(jié)合實際情況，建立（或委托建立）維修技術(shù)信息公開系統(tǒng)，及時有效公開本企業(yè)車型維修技術(shù)信息，并對信息的真實性、準確性、完整性負責[5]。

為更高效地管理服務(wù)信息，更多車企的維修技術(shù)信息公開系統(tǒng)從委托建立逐步轉(zhuǎn)向自主建立；因此，對服務(wù)信息的規(guī)范性和有效性以及滿足數(shù)字出版、信息交互使用等方面提出了更高的要求，應(yīng)用DITA與CMS是有效解決服務(wù)信息內(nèi)容管理的最佳途徑。

2 服務(wù)手冊類型與信息分類

2.1 服務(wù)手冊類型

一方面汽車標準或法規(guī)規(guī)定了服務(wù)手冊類型，如產(chǎn)品使用說明書、應(yīng)急救援手冊等；另一方面根據(jù)手冊受眾角色、場景需求的不同，可對服務(wù)手冊類型進一步細分。

根據(jù)受眾角色大致可將服務(wù)手冊分為5類：第1類面向使用者，告知如何正確、安全、有效使用車輛，避免不合理使用或誤用，包括車輛相關(guān)的功能、性能、特性信息，以及車輛維護周期、維護作業(yè)項目等技術(shù)信息；第2類為面向?qū)I(yè)的應(yīng)急救援人員，告知對電動汽車在發(fā)生碰撞、涉水或火災(zāi)等災(zāi)害事故時，為應(yīng)急救援人員等提供可視化的應(yīng)急救援、保護人身安全信息；第3類面向維修維護人員，告知車輛維修、維護、診斷、電路圖以及鈑金涂裝等維修信息；第4類面向承接底盤車的下游制造企業(yè)生產(chǎn)制造人員，為整車多階段制造所需的信息；第5類面向報廢企業(yè)報廢處理人員，幫助其了解車輛動力電池、整車拆解所需的信息。服務(wù)手冊受眾與手冊類型對應(yīng)關(guān)系，如圖1所示。

圖1 服務(wù)手冊受眾與手冊類型關(guān)系

此外，服務(wù)手冊信息還用于其他經(jīng)營目的的用戶（包括維修診斷工具及設(shè)備制造商、零部件制造商、出版商、保險企業(yè)、培訓機構(gòu)等）[5]。

2.2 服務(wù)手冊信息分類

維修手冊中的信息類型基本涵蓋其他服務(wù)手冊中的信息類型，通過整理分析維修技術(shù)信息公開附件《目錄》與JT/T 1413—2022[6]規(guī)范中要求的服務(wù)信息組成，可按表1進行分類。

3 服務(wù)手冊DITA主題

3.1 DITA主題

主題（topic）指具有一個標題和包含正好足以獨立存在的、有意義的內(nèi)容（涵蓋一個過程，或一個概念，或一類參引信息）。在出版流程中，可以針對特定領(lǐng)域內(nèi)具體的出版要求，對主題進行擴充，使之支持新的主題類型。

DITA的專門化（specialisation）包括結(jié)構(gòu)（structural）與領(lǐng)域（domain）專門化兩種類型。可以理解為DITA的主題是其架構(gòu)中的基礎(chǔ)類，專門化即從如何在主題的基礎(chǔ)上進行繼承原有元素（element）和屬性（attribute），擴展新的元素和屬性形成新的主題類型[1,7]。

DITA現(xiàn)行V1.3版本提供概念（concept）、任務(wù)（task）、參引（reference）和故障處理（trouble- blshooting）等主題類型以及提供一些內(nèi)部專門化主題（如術(shù)語表條目glossentry等）[8]。

3.2 業(yè)務(wù)主題類型確定

根據(jù)表1中汽車服務(wù)手冊的服務(wù)信息分類，結(jié)合主題專門化擴展應(yīng)用，對應(yīng)配置服務(wù)手冊業(yè)務(wù)所需的主題類型，如表2所示。

表1 汽車服務(wù)手冊中的服務(wù)信息分類

服務(wù)信息服務(wù)信息描述 基本信息基本參數(shù)、定位基準與參數(shù)等技術(shù)參數(shù)及示意圖、操作安全注意事項及其他必要說明等信息 維修信息總成及零部件的拆卸與安裝方法、技術(shù)規(guī)范及圖示說明；零部件檢測方法及鑒別判斷的信息；零部件更換或維修后，進行匹配、基本設(shè)置等信息 維護信息定期維護項目、檢查內(nèi)容、維護作業(yè)和維護間隔設(shè)置依據(jù)、方法，以及車輛清潔、油液脂參數(shù)等信息 電路信息電路接線圖，包括接線圖、器件位置、插接件型號規(guī)格等信息 故障與診斷信息各電子控制系統(tǒng)（含車載自動診斷系統(tǒng)）故障代碼、代碼定義、故障診斷及排除的方法和步驟、用于檢測和故障診斷的相關(guān)參數(shù)等信息 排放信息排放控制系統(tǒng)信息，包括排放控制系統(tǒng)的安裝位置示意圖、裝配圖和維修技術(shù)要求，排氣后處理系統(tǒng)關(guān)鍵零部件的型號、生產(chǎn)廠家及更換時間等信息 特性信息術(shù)語、專用工具與設(shè)備、力矩等信息

表2 服務(wù)信息對應(yīng)的DITA業(yè)務(wù)主題類型

服務(wù)信息專門化業(yè)務(wù)主題類型 基本信息否描述主題等 維護信息否維護主題等 維修信息是拆裝主題、檢查與調(diào)整主題等 電路信息是電路圖主題等 故障診斷信息是常規(guī)故障主題、故障碼主題、故障碼診斷主題等 排放控制信息否排放主題等 特性信息是術(shù)語主題、專用工具主題、力矩主題等 術(shù)語匯總表主題、專用工具匯總表主題、力矩匯總表主題等

4 服務(wù)手冊DITA架構(gòu)

DITA的架構(gòu)分為四層：公共結(jié)構(gòu)、跨信息類型的領(lǐng)域?qū)I(yè)詞匯表、類型化主題結(jié)構(gòu)、交付上下文；DITA整體流程大致劃分為結(jié)構(gòu)化編寫、主題倉儲、DITA映射、樣式轉(zhuǎn)換與輸出四個階段[4]。

4.1 映射表

DITA映射圖（map）用于組織服務(wù)手冊的邏輯順序和層次結(jié)構(gòu)，來搭建信息架構(gòu)；映射中包含指向DITA主題的鏈接，按順序或?qū)蛹壗Y(jié)構(gòu)將分散的主題黏合起來形成集合，賦予主題上下文的順序和層級關(guān)系[9]。在DITA中，發(fā)布主題的順序和層次結(jié)構(gòu)時通過嵌套的topicref元素在map中定義的，通過topicref的和屬性實現(xiàn)配置服務(wù)手冊的總章目錄、全文目錄、分章目錄等。

書籍圖（bookmap）是一種特殊類型的映射圖。特別地，如維修手冊這類主題數(shù)量非常多的服務(wù)手冊，僅建立一個龐大的映射圖將需要花費大量時間去發(fā)現(xiàn)主題，并理解內(nèi)容是如何組組織的；通常將更小的映射圖嵌套到其他映射圖中建立子圖（submap）[1]。基于維修手冊各系統(tǒng)內(nèi)容的相對獨立性，可按系統(tǒng)維度構(gòu)建手冊子圖，如圖2所示。

圖2 維修手冊映射圖與子圖關(guān)系

4.2 DITA信息架構(gòu)與建模

定義服務(wù)手冊信息架構(gòu)，即使用映射圖文件定義一個主題集的導(dǎo)航，能在一個任務(wù)流程中組織所有的主題，以便最好地滿足用戶的需求。應(yīng)用信息架構(gòu)平臺將主題映射到映射圖層級結(jié)構(gòu)中，主要包括創(chuàng)建一個建模項目、創(chuàng)建映射圖、映射主題到映射圖中、重組內(nèi)容、導(dǎo)出映射圖等基本過程[1]。

以下是產(chǎn)品使用說明書印刷版與電子版（手機或車機等）信息架構(gòu)建模的應(yīng)用案例：GB/T 40494—2021[10]中規(guī)定“電子版說明書應(yīng)是完整版說明書”，對此電子版使用說明書必要地通過全部主題重組，實現(xiàn)與印刷版的內(nèi)容重用。相對印刷版，為提高電子版使用說明書的操作與閱讀友好性，通過減少主題的信息架構(gòu)層級實現(xiàn)。

表3中給出了印刷版與電子版使用說明書1級目錄名稱，圖3、圖4給出了印刷版與電子版（手機、車機）使用說明書數(shù)字出版物的目錄實例。

表3 印刷版與電子版使用說明書1級目錄名稱

類型一級目錄名稱（按先后順序排列） 印刷版安全、儀表組、控制器的操作、使用和駕駛、車內(nèi)裝置、車輛維護、發(fā)生故障時、車輛規(guī)格 電子版安全、充電與放電、查看儀表、開啟與關(guān)閉、設(shè)定與操作、駕駛輔助、車內(nèi)開關(guān)、車內(nèi)裝置、空調(diào)、座椅、多媒體、駕駛說明、故障與救援、維護、車輛規(guī)格

圖3 印刷版使用說明書目錄實例

圖4 電子版（手機、車機）使用說明書目錄實例

5 服務(wù)手冊內(nèi)容重用

重用（reuse）指的是內(nèi)容只要經(jīng)過一次創(chuàng)作，就能在任何需要它的地方進行內(nèi)容重用。特別地，需要清楚重用的動機，并且在任何實施操作之前制定好策略?？梢酝ㄟ^映射圖重用、主題重用、內(nèi)容參引重用、非DITA資源重用等方法實現(xiàn)重用內(nèi)容[1]，汽車服務(wù)手冊中主要應(yīng)用到前兩種的方法。

5.1 映射圖重用

映射圖重用指將主題創(chuàng)建和組織為子圖，實現(xiàn)可重用的映射圖。本文4.1中提到的維修手冊系統(tǒng)子圖的嵌套使用是映射圖應(yīng)用案例之一，在新的訂單車型中只需更新變更的系統(tǒng)手冊內(nèi)容，沒有變化的系統(tǒng)內(nèi)容即是重用該系統(tǒng)的映射圖。

5.2 主題重用

主題重用指在多個映射圖中插入主題實現(xiàn)主題重用，是最為頻繁的重用方法。本文4.2中提到的電子版產(chǎn)品使用說明書主題來源于印刷版重用內(nèi)容的重組，是在不同信息架構(gòu)中重用同一主題。此外，考慮新能源汽車在使用、運維、培訓等方面的安全因素，用戶對高壓系統(tǒng)的操作內(nèi)容有獨立成冊的需求。重用產(chǎn)品使用說明書中的相關(guān)內(nèi)容并重組形成高壓系統(tǒng)操作手冊，也是DITA主題重用的實例。

6 服務(wù)手冊其他應(yīng)用

6.1 元數(shù)據(jù)應(yīng)用

在DITA體系中，映射圖與主題包含很多元素和屬性專門用以提供元數(shù)據(jù)，通過使用元數(shù)據(jù)元素達到：自動包含信息；提高內(nèi)容的可檢索性；針對不同受眾、版本、型號等定制信息。DITA元數(shù)據(jù)類型包括索引項、條件處理屬性、主題元數(shù)據(jù)、映射圖元數(shù)據(jù)等。

以下是索引項在服務(wù)手冊應(yīng)用案例：GB/T 40494—2021[10]中規(guī)定說明書應(yīng)有“目錄或索引”，其中“索引”應(yīng)按漢語拼音順序給出。一般在所需定義的索引項主題內(nèi)容前通過插入與元素中放置索引項；設(shè)置索引項存在一定的工作量，對于主題數(shù)量不多的服務(wù)手冊（如使用說明書），可以配置全部的主題標題