黃達潛,陳 振,聶嘉晗
DITA在汽車服務手冊數(shù)字出版的應用
黃達潛,陳 振,聶嘉晗
(比亞迪汽車工業(yè)有限公司,廣東 深圳 518118)
達爾文信息類型化體系結構(DITA)是一種基于可擴展標記語言(XML)的面向主題的數(shù)字化內(nèi)容結構化寫作與發(fā)布方案,DITA使信息具有的可檢索、可組織、可重用特性,支持快速生成服務不同受眾和終端展現(xiàn)的出版物,被更多汽車企業(yè)所使用。結合汽車維修技術信息公開法規(guī)、標準等要求,對DITA在汽車服務手冊類型與信息分類、主題、架構、內(nèi)容重用等方面進行介紹,對印刷版與電子版手冊進行信息架構與建模,實現(xiàn)交付物的多樣化應用。
DITA;服務手冊;DITA主題;映射圖;內(nèi)容重用
為提高生產(chǎn)力與產(chǎn)品質(zhì)量,汽車行業(yè)通常對零部件采取最大限度的標準化、通用化,進而組合成整車;在汽車服務信息出版方面,為提高內(nèi)容創(chuàng)作的效率和出版更優(yōu)質(zhì)的作品,使用達爾文信息類型化體系結構(Darwin Information Typing Architecture, DITA)通過服務信息“組件化”和“重用”功能,實現(xiàn)服務手冊創(chuàng)作規(guī)范化、均一化,是汽車企業(yè)首選的應用方案[1]。
DITA最初于2001年由IBM公司為解決信息內(nèi)容從生產(chǎn)到發(fā)布中信息載體的標準化描述、規(guī)范化組織、統(tǒng)一化存儲、異地共享與協(xié)調(diào)作業(yè)等問題提出,目前由結構化信息標準促進組織(Orga- nization for the Advancement of Structured Informa- tion Standards, OASIS)的DITA技術委員會管理。
DITA是一種基于可擴展標記語言(Extensible Markup Language, XML)與面向主題(topic)的數(shù)字化內(nèi)容結構化寫作與發(fā)布方案,即通過定義一套文檔類型定義(Document Type Definition, DTD)或Schema標準的數(shù)字出版物的文檔格式[2-4]。DITA的信息模型和其工作流程已整合多種應用,如內(nèi)容管理系統(tǒng)(Content Management System, CMS)、XML編輯器等。
《汽車維修技術信息公開實施管理辦法》(交運發(fā)〔2015〕146號)從安全、環(huán)保角度,要求汽車生產(chǎn)者應向社會公開汽車維修技術信息,其附件《汽車維修技術信息公開目錄(2015年版)》規(guī)定公開技術信息包括汽車維修手冊、零部件目錄、技術服務通告等信息內(nèi)容,以保障車輛維修后安全、排放性能達標。對公開信息,企業(yè)結合實際情況,建立(或委托建立)維修技術信息公開系統(tǒng),及時有效公開本企業(yè)車型維修技術信息,并對信息的真實性、準確性、完整性負責[5]。
為更高效地管理服務信息,更多車企的維修技術信息公開系統(tǒng)從委托建立逐步轉(zhuǎn)向自主建立;因此,對服務信息的規(guī)范性和有效性以及滿足數(shù)字出版、信息交互使用等方面提出了更高的要求,應用DITA與CMS是有效解決服務信息內(nèi)容管理的最佳途徑。
一方面汽車標準或法規(guī)規(guī)定了服務手冊類型,如產(chǎn)品使用說明書、應急救援手冊等;另一方面根據(jù)手冊受眾角色、場景需求的不同,可對服務手冊類型進一步細分。
根據(jù)受眾角色大致可將服務手冊分為5類:第1類面向使用者,告知如何正確、安全、有效使用車輛,避免不合理使用或誤用,包括車輛相關的功能、性能、特性信息,以及車輛維護周期、維護作業(yè)項目等技術信息;第2類為面向?qū)I(yè)的應急救援人員,告知對電動汽車在發(fā)生碰撞、涉水或火災等災害事故時,為應急救援人員等提供可視化的應急救援、保護人身安全信息;第3類面向維修維護人員,告知車輛維修、維護、診斷、電路圖以及鈑金涂裝等維修信息;第4類面向承接底盤車的下游制造企業(yè)生產(chǎn)制造人員,為整車多階段制造所需的信息;第5類面向報廢企業(yè)報廢處理人員,幫助其了解車輛動力電池、整車拆解所需的信息。服務手冊受眾與手冊類型對應關系,如圖1所示。

圖1 服務手冊受眾與手冊類型關系
此外,服務手冊信息還用于其他經(jīng)營目的的用戶(包括維修診斷工具及設備制造商、零部件制造商、出版商、保險企業(yè)、培訓機構等)[5]。
維修手冊中的信息類型基本涵蓋其他服務手冊中的信息類型,通過整理分析維修技術信息公開附件《目錄》與JT/T 1413—2022[6]規(guī)范中要求的服務信息組成,可按表1進行分類。
主題(topic)指具有一個標題和包含正好足以獨立存在的、有意義的內(nèi)容(涵蓋一個過程,或一個概念,或一類參引信息)。在出版流程中,可以針對特定領域內(nèi)具體的出版要求,對主題進行擴充,使之支持新的主題類型。
DITA的專門化(specialisation)包括結構(structural)與領域(domain)專門化兩種類型。可以理解為DITA的主題是其架構中的基礎類,專門化即從如何在主題的基礎上進行繼承原有元素(element)和屬性(attribute),擴展新的元素和屬性形成新的主題類型[1,7]。
DITA現(xiàn)行V1.3版本提供概念(concept)、任務(task)、參引(reference)和故障處理(trouble- blshooting)等主題類型以及提供一些內(nèi)部專門化主題(如術語表條目glossentry等)[8]。
根據(jù)表1中汽車服務手冊的服務信息分類,結合主題專門化擴展應用,對應配置服務手冊業(yè)務所需的主題類型,如表2所示。
表1 汽車服務手冊中的服務信息分類
服務信息服務信息描述 基本信息基本參數(shù)、定位基準與參數(shù)等技術參數(shù)及示意圖、操作安全注意事項及其他必要說明等信息 維修信息總成及零部件的拆卸與安裝方法、技術規(guī)范及圖示說明;零部件檢測方法及鑒別判斷的信息;零部件更換或維修后,進行匹配、基本設置等信息 維護信息定期維護項目、檢查內(nèi)容、維護作業(yè)和維護間隔設置依據(jù)、方法,以及車輛清潔、油液脂參數(shù)等信息 電路信息電路接線圖,包括接線圖、器件位置、插接件型號規(guī)格等信息 故障與診斷信息各電子控制系統(tǒng)(含車載自動診斷系統(tǒng))故障代碼、代碼定義、故障診斷及排除的方法和步驟、用于檢測和故障診斷的相關參數(shù)等信息 排放信息排放控制系統(tǒng)信息,包括排放控制系統(tǒng)的安裝位置示意圖、裝配圖和維修技術要求,排氣后處理系統(tǒng)關鍵零部件的型號、生產(chǎn)廠家及更換時間等信息 特性信息術語、專用工具與設備、力矩等信息
表2 服務信息對應的DITA業(yè)務主題類型
服務信息專門化業(yè)務主題類型 基本信息否描述主題等 維護信息否維護主題等 維修信息是拆裝主題、檢查與調(diào)整主題等 電路信息是電路圖主題等 故障診斷信息是常規(guī)故障主題、故障碼主題、故障碼診斷主題等 排放控制信息否排放主題等 特性信息是術語主題、專用工具主題、力矩主題等 術語匯總表主題、專用工具匯總表主題、力矩匯總表主題等
DITA的架構分為四層:公共結構、跨信息類型的領域?qū)I(yè)詞匯表、類型化主題結構、交付上下文;DITA整體流程大致劃分為結構化編寫、主題倉儲、DITA映射、樣式轉(zhuǎn)換與輸出四個階段[4]。
DITA映射圖(map)用于組織服務手冊的邏輯順序和層次結構,來搭建信息架構;映射中包含指向DITA主題的鏈接,按順序或?qū)蛹壗Y構將分散的主題黏合起來形成集合,賦予主題上下文的順序和層級關系[9]。在DITA中,發(fā)布主題的順序和層次結構時通過嵌套的topicref元素在map中定義的,通過topicref的
書籍圖(bookmap)是一種特殊類型的映射圖。特別地,如維修手冊這類主題數(shù)量非常多的服務手冊,僅建立一個龐大的映射圖將需要花費大量時間去發(fā)現(xiàn)主題,并理解內(nèi)容是如何組組織的;通常將更小的映射圖嵌套到其他映射圖中建立子圖(submap)[1]。基于維修手冊各系統(tǒng)內(nèi)容的相對獨立性,可按系統(tǒng)維度構建手冊子圖,如圖2所示。

圖2 維修手冊映射圖與子圖關系
定義服務手冊信息架構,即使用映射圖文件定義一個主題集的導航,能在一個任務流程中組織所有的主題,以便最好地滿足用戶的需求。應用信息架構平臺將主題映射到映射圖層級結構中,主要包括創(chuàng)建一個建模項目、創(chuàng)建映射圖、映射主題到映射圖中、重組內(nèi)容、導出映射圖等基本過程[1]。
以下是產(chǎn)品使用說明書印刷版與電子版(手機或車機等)信息架構建模的應用案例:GB/T 40494—2021[10]中規(guī)定“電子版說明書應是完整版說明書”,對此電子版使用說明書必要地通過全部主題重組,實現(xiàn)與印刷版的內(nèi)容重用。相對印刷版,為提高電子版使用說明書的操作與閱讀友好性,通過減少主題的信息架構層級實現(xiàn)。
表3中給出了印刷版與電子版使用說明書1級目錄名稱,圖3、圖4給出了印刷版與電子版(手機、車機)使用說明書數(shù)字出版物的目錄實例。
表3 印刷版與電子版使用說明書1級目錄名稱
類型一級目錄名稱(按先后順序排列) 印刷版安全、儀表組、控制器的操作、使用和駕駛、車內(nèi)裝置、車輛維護、發(fā)生故障時、車輛規(guī)格 電子版安全、充電與放電、查看儀表、開啟與關閉、設定與操作、駕駛輔助、車內(nèi)開關、車內(nèi)裝置、空調(diào)、座椅、多媒體、駕駛說明、故障與救援、維護、車輛規(guī)格

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

圖4 電子版(手機、車機)使用說明書目錄實例
重用(reuse)指的是內(nèi)容只要經(jīng)過一次創(chuàng)作,就能在任何需要它的地方進行內(nèi)容重用。特別地,需要清楚重用的動機,并且在任何實施操作之前制定好策略。可以通過映射圖重用、主題重用、內(nèi)容參引重用、非DITA資源重用等方法實現(xiàn)重用內(nèi)容[1],汽車服務手冊中主要應用到前兩種的方法。
映射圖重用指將主題創(chuàng)建和組織為子圖,實現(xiàn)可重用的映射圖。本文4.1中提到的維修手冊系統(tǒng)子圖的嵌套使用是映射圖應用案例之一,在新的訂單車型中只需更新變更的系統(tǒng)手冊內(nèi)容,沒有變化的系統(tǒng)內(nèi)容即是重用該系統(tǒng)的映射圖。
主題重用指在多個映射圖中插入主題實現(xiàn)主題重用,是最為頻繁的重用方法。本文4.2中提到的電子版產(chǎn)品使用說明書主題來源于印刷版重用內(nèi)容的重組,是在不同信息架構中重用同一主題。此外,考慮新能源汽車在使用、運維、培訓等方面的安全因素,用戶對高壓系統(tǒng)的操作內(nèi)容有獨立成冊的需求。重用產(chǎn)品使用說明書中的相關內(nèi)容并重組形成高壓系統(tǒng)操作手冊,也是DITA主題重用的實例。
在DITA體系中,映射圖與主題包含很多元素和屬性專門用以提供元數(shù)據(jù),通過使用元數(shù)據(jù)元素達到:自動包含信息;提高內(nèi)容的可檢索性;針對不同受眾、版本、型號等定制信息。DITA元數(shù)據(jù)類型包括索引項、條件處理屬性、主題元數(shù)據(jù)、映射圖元數(shù)據(jù)等。
以下是索引項在服務手冊應用案例:GB/T 40494—2021[10]中規(guī)定說明書應有“目錄或索引”,其中“索引”應按漢語拼音順序給出。一般在所需定義的索引項主題內(nèi)容前通過插入
術語表條目(glossentry)與術語表集合(glossgroup)信息類型是在DITA 1.2中作為概念主題的特化而引入[11]。參照其術語表條目與術語表集合的文檔模板,可擴展專用工具、力矩、油液脂、維護計劃作業(yè)項目等服務信息的專門化應用,圖5為維修手冊中油液脂專門化的應用案例。

圖5 油液脂引用與油液脂匯總表主題及應用實例
借助內(nèi)容管理系統(tǒng)(Content Management System, CMS)構建映射圖,信息架構載體實現(xiàn)多語言不同主題間的關聯(lián)關系;通過定義與配置信息架構載體用于驅(qū)動篩選預先定制主題的特征值屬性,特征值可以是與車輛識別代號(Vehicle Identification Number, VIN)關聯(lián)的配置或物料清單(記載有關聯(lián)車輛的配置特征編碼或零部件編號信息)。服務手冊模板為針對特定型號的車輛預先編輯而成且包括所述特定型號車輛的所有配置信息對應的主題內(nèi)容,處理器依據(jù)車輛特征值集和設定的處理規(guī)則,實現(xiàn)對服務手冊模板主題的篩選與過濾,從而自動生成車輛的服務手冊[12]。定制主題與配置驅(qū)動特別適用于客車的小批量、訂單制特性,一個平臺車型的訂單車型,僅存在若干客戶定制的配置差異,其服務手冊有很大一部分內(nèi)容是相同的,主題配置驅(qū)動功能實現(xiàn)服務手冊自動高效編制,效率大大提升。
DITA的專門化、設計重用、多語言支持等優(yōu)勢,實現(xiàn)服務信息的全生命周期管理,有效地解決信息冗余等問題;主題配置驅(qū)動實現(xiàn)快速生成服務不同受眾和終端展現(xiàn)的數(shù)字出版物,滿足維修技術信息公開政策要求并提升了企業(yè)品牌形象。
DITA具備的靈活性和可塑性,除本文提到的應用于汽車服務手冊外,可擴展應用到三包憑證、服務通告等服務信息文檔中。隨著DITA在汽車服務技術信息領域應用的不斷挖掘,必將形成全面、成熟的行業(yè)解決方案。
[1] LAURA B,MICHELLE C,JENIFER S.DITA最佳實踐指南[M].李穎,栗曉磊,譯.北京:科學出版社,2019: 74-76.
[2] OASIS.Darwin Information Typing Architecture (DITA) TC[EB/OL].(2009-5-12)[2022-6-8].http://www.oasis-open.org/.
[3] OASIS.International Standards Consortium[EB/OL]. (2018-04-23)[2022-06-08].http://dita xml.org/.
[4] 范煒.達爾文信息類型架構DITA研究[J].情報雜志, 2009,28(11):172-175.
[5] 交通運輸部?環(huán)境保護部?商務部?工商總局?質(zhì)檢總局?國家認監(jiān)委知識產(chǎn)權局?保監(jiān)會關于印發(fā)《汽車維修技術信息公開實施管理辦法》的通知[J].中華人民共和國國務院公報,2016(6):87-95.
[6] 全國汽車維修標準化技術委員會.汽車維修技術信息公開規(guī)范:JT/T 1413—2022[S].北京:人民交通出版社,2021:3-6.
[7] 葉宇姍,解凱,曾慶濤,等.數(shù)字出版中的DITA技術[J].北京印刷學院學報,2016,24(4):29-32.
[8] OASIS.Drawin Information Typing Architecture (DITA) V1.3[EB/OL].(2015-12-15)[2022-06-08].http://docs.o asis-open.org/dita/dita/v1.3/.
[9] 高昂,劉鈺,邢立強.DITA數(shù)字出版技術[M].北京:電子工業(yè)出版社,2013:37-41.
[10] 全國汽車標準化技術委員會.機動車產(chǎn)品使用說明書:GB/T 40494—2021[S].北京:中國標準出版社, 2022:3.
[11] TONY S.The DITA Style Guide:Best Practices for Authors[M].Oxford:Scriptorium Publishing Services, Inc,2011:131-132.
[12] 羅希,陳少峰,寇素原,等.車輛用戶手冊的生成方法?獲取方法及其裝置:201810935529.0[P].2018-08-16.
Application of DITA in Digital Publishing Automobile Service Manual
HUANG Daqian, CHEN Zhen, NIE Jiahan
( BYD Auto Industry Company Limited, Shenzhen 518118, China )
Darwin information typing architecture(DITA)is a topic-oriented digital content struc- tured writing and publishing scheme based on extensible markup language(XML).DITA can realize the characteristics of information retrieval,organization and reusability,support the rapid generation of publications the different audiences and terminals,support the rapid generation of publications to serve different audiences and terminal display, is used by more automobile enterprises.Combined with the requirements of automobile maintenance technical information disclosure regulations and standards, the application of DITA in automobile service manual types and information classification, topics, architecture, and content reuse is introduced,information architecture and modeling of printed and electronic manuals to achieve a diverse range of deliverables.
DITA;Service manual; DITA topic;Tapping map;Content reuse
U462
A
1671-7988(2023)10-105-06
10.16638/j.cnki.1671-7988.2023.010.022
黃達潛(1989—),男,工程師,研究方向為汽車服務技術信息、技術傳播(汽車領域),E-mail:454375397 @qq.com。