APP下载

DITA在汽车服务手册数字出版的应用

2023-06-14黄达潜聂嘉晗

汽车实用技术 2023年10期
关键词:印刷版电子版手册

黄达潜,陈 振,聂嘉晗

DITA在汽车服务手册数字出版的应用

黄达潜,陈 振,聂嘉晗

(比亚迪汽车工业有限公司,广东 深圳 518118)

达尔文信息类型化体系结构(DITA)是一种基于可扩展标记语言(XML)的面向主题的数字化内容结构化写作与发布方案,DITA使信息具有的可检索、可组织、可重用特性,支持快速生成服务不同受众和终端展现的出版物,被更多汽车企业所使用。结合汽车维修技术信息公开法规、标准等要求,对DITA在汽车服务手册类型与信息分类、主题、架构、内容重用等方面进行介绍,对印刷版与电子版手册进行信息架构与建模,实现交付物的多样化应用。

DITA;服务手册;DITA主题;映射图;内容重用

为提高生产力与产品质量,汽车行业通常对零部件采取最大限度的标准化、通用化,进而组合成整车;在汽车服务信息出版方面,为提高内容创作的效率和出版更优质的作品,使用达尔文信息类型化体系结构(Darwin Information Typing Architecture, DITA)通过服务信息“组件化”和“重用”功能,实现服务手册创作规范化、均一化,是汽车企业首选的应用方案[1]。

1 DITA概述与应用背景

1.1 DITA概述

DITA最初于2001年由IBM公司为解决信息内容从生产到发布中信息载体的标准化描述、规范化组织、统一化存储、异地共享与协调作业等问题提出,目前由结构化信息标准促进组织(Orga- nization for the Advancement of Structured Informa- tion Standards, OASIS)的DITA技术委员会管理。

DITA是一种基于可扩展标记语言(Extensible Markup Language, XML)与面向主题(topic)的数字化内容结构化写作与发布方案,即通过定义一套文档类型定义(Document Type Definition, DTD)或Schema标准的数字出版物的文档格式[2-4]。DITA的信息模型和其工作流程已整合多种应用,如内容管理系统(Content Management System, CMS)、XML编辑器等。

1.2 汽车维修技术信息公开

《汽车维修技术信息公开实施管理办法》(交运发〔2015〕146号)从安全、环保角度,要求汽车生产者应向社会公开汽车维修技术信息,其附件《汽车维修技术信息公开目录(2015年版)》规定公开技术信息包括汽车维修手册、零部件目录、技术服务通告等信息内容,以保障车辆维修后安全、排放性能达标。对公开信息,企业结合实际情况,建立(或委托建立)维修技术信息公开系统,及时有效公开本企业车型维修技术信息,并对信息的真实性、准确性、完整性负责[5]。

为更高效地管理服务信息,更多车企的维修技术信息公开系统从委托建立逐步转向自主建立;因此,对服务信息的规范性和有效性以及满足数字出版、信息交互使用等方面提出了更高的要求,应用DITA与CMS是有效解决服务信息内容管理的最佳途径。

2 服务手册类型与信息分类

2.1 服务手册类型

一方面汽车标准或法规规定了服务手册类型,如产品使用说明书、应急救援手册等;另一方面根据手册受众角色、场景需求的不同,可对服务手册类型进一步细分。

根据受众角色大致可将服务手册分为5类:第1类面向使用者,告知如何正确、安全、有效使用车辆,避免不合理使用或误用,包括车辆相关的功能、性能、特性信息,以及车辆维护周期、维护作业项目等技术信息;第2类为面向专业的应急救援人员,告知对电动汽车在发生碰撞、涉水或火灾等灾害事故时,为应急救援人员等提供可视化的应急救援、保护人身安全信息;第3类面向维修维护人员,告知车辆维修、维护、诊断、电路图以及钣金涂装等维修信息;第4类面向承接底盘车的下游制造企业生产制造人员,为整车多阶段制造所需的信息;第5类面向报废企业报废处理人员,帮助其了解车辆动力电池、整车拆解所需的信息。服务手册受众与手册类型对应关系,如图1所示。

图1 服务手册受众与手册类型关系

此外,服务手册信息还用于其他经营目的的用户(包括维修诊断工具及设备制造商、零部件制造商、出版商、保险企业、培训机构等)[5]。

2.2 服务手册信息分类

维修手册中的信息类型基本涵盖其他服务手册中的信息类型,通过整理分析维修技术信息公开附件《目录》与JT/T 1413—2022[6]规范中要求的服务信息组成,可按表1进行分类。

3 服务手册DITA主题

3.1 DITA主题

主题(topic)指具有一个标题和包含正好足以独立存在的、有意义的内容(涵盖一个过程,或一个概念,或一类参引信息)。在出版流程中,可以针对特定领域内具体的出版要求,对主题进行扩充,使之支持新的主题类型。

DITA的专门化(specialisation)包括结构(structural)与领域(domain)专门化两种类型。可以理解为DITA的主题是其架构中的基础类,专门化即从如何在主题的基础上进行继承原有元素(element)和属性(attribute),扩展新的元素和属性形成新的主题类型[1,7]。

DITA现行V1.3版本提供概念(concept)、任务(task)、参引(reference)和故障处理(trouble- blshooting)等主题类型以及提供一些内部专门化主题(如术语表条目glossentry等)[8]。

3.2 业务主题类型确定

根据表1中汽车服务手册的服务信息分类,结合主题专门化扩展应用,对应配置服务手册业务所需的主题类型,如表2所示。

表1 汽车服务手册中的服务信息分类

服务信息服务信息描述 基本信息基本参数、定位基准与参数等技术参数及示意图、操作安全注意事项及其他必要说明等信息 维修信息总成及零部件的拆卸与安装方法、技术规范及图示说明;零部件检测方法及鉴别判断的信息;零部件更换或维修后,进行匹配、基本设置等信息 维护信息定期维护项目、检查内容、维护作业和维护间隔设置依据、方法,以及车辆清洁、油液脂参数等信息 电路信息电路接线图,包括接线图、器件位置、插接件型号规格等信息 故障与诊断信息各电子控制系统(含车载自动诊断系统)故障代码、代码定义、故障诊断及排除的方法和步骤、用于检测和故障诊断的相关参数等信息 排放信息排放控制系统信息,包括排放控制系统的安装位置示意图、装配图和维修技术要求,排气后处理系统关键零部件的型号、生产厂家及更换时间等信息 特性信息术语、专用工具与设备、力矩等信息

表2 服务信息对应的DITA业务主题类型

服务信息专门化业务主题类型 基本信息否描述主题等 维护信息否维护主题等 维修信息是拆装主题、检查与调整主题等 电路信息是电路图主题等 故障诊断信息是常规故障主题、故障码主题、故障码诊断主题等 排放控制信息否排放主题等 特性信息是术语主题、专用工具主题、力矩主题等 术语汇总表主题、专用工具汇总表主题、力矩汇总表主题等

4 服务手册DITA架构

DITA的架构分为四层:公共结构、跨信息类型的领域专业词汇表、类型化主题结构、交付上下文;DITA整体流程大致划分为结构化编写、主题仓储、DITA映射、样式转换与输出四个阶段[4]。

4.1 映射表

DITA映射图(map)用于组织服务手册的逻辑顺序和层次结构,来搭建信息架构;映射中包含指向DITA主题的链接,按顺序或层级结构将分散的主题黏合起来形成集合,赋予主题上下文的顺序和层级关系[9]。在DITA中,发布主题的顺序和层次结构时通过嵌套的topicref元素在map中定义的,通过topicref的属性实现配置服务手册的总章目录、全文目录、分章目录等。

书籍图(bookmap)是一种特殊类型的映射图。特别地,如维修手册这类主题数量非常多的服务手册,仅建立一个庞大的映射图将需要花费大量时间去发现主题,并理解内容是如何组组织的;通常将更小的映射图嵌套到其他映射图中建立子图(submap)[1]。基于维修手册各系统内容的相对独立性,可按系统维度构建手册子图,如图2所示。

图2 维修手册映射图与子图关系

4.2 DITA信息架构与建模

定义服务手册信息架构,即使用映射图文件定义一个主题集的导航,能在一个任务流程中组织所有的主题,以便最好地满足用户的需求。应用信息架构平台将主题映射到映射图层级结构中,主要包括创建一个建模项目、创建映射图、映射主题到映射图中、重组内容、导出映射图等基本过程[1]。

以下是产品使用说明书印刷版与电子版(手机或车机等)信息架构建模的应用案例:GB/T 40494—2021[10]中规定“电子版说明书应是完整版说明书”,对此电子版使用说明书必要地通过全部主题重组,实现与印刷版的内容重用。相对印刷版,为提高电子版使用说明书的操作与阅读友好性,通过减少主题的信息架构层级实现。

表3中给出了印刷版与电子版使用说明书1级目录名称,图3、图4给出了印刷版与电子版(手机、车机)使用说明书数字出版物的目录实例。

表3 印刷版与电子版使用说明书1级目录名称

类型一级目录名称(按先后顺序排列) 印刷版安全、仪表组、控制器的操作、使用和驾驶、车内装置、车辆维护、发生故障时、车辆规格 电子版安全、充电与放电、查看仪表、开启与关闭、设定与操作、驾驶辅助、车内开关、车内装置、空调、座椅、多媒体、驾驶说明、故障与救援、维护、车辆规格

图3 印刷版使用说明书目录实例

图4 电子版(手机、车机)使用说明书目录实例

5 服务手册内容重用

重用(reuse)指的是内容只要经过一次创作,就能在任何需要它的地方进行内容重用。特别地,需要清楚重用的动机,并且在任何实施操作之前制定好策略。可以通过映射图重用、主题重用、内容参引重用、非DITA资源重用等方法实现重用内容[1],汽车服务手册中主要应用到前两种的方法。

5.1 映射图重用

映射图重用指将主题创建和组织为子图,实现可重用的映射图。本文4.1中提到的维修手册系统子图的嵌套使用是映射图应用案例之一,在新的订单车型中只需更新变更的系统手册内容,没有变化的系统内容即是重用该系统的映射图。

5.2 主题重用

主题重用指在多个映射图中插入主题实现主题重用,是最为频繁的重用方法。本文4.2中提到的电子版产品使用说明书主题来源于印刷版重用内容的重组,是在不同信息架构中重用同一主题。此外,考虑新能源汽车在使用、运维、培训等方面的安全因素,用户对高压系统的操作内容有独立成册的需求。重用产品使用说明书中的相关内容并重组形成高压系统操作手册,也是DITA主题重用的实例。

6 服务手册其他应用

6.1 元数据应用

在DITA体系中,映射图与主题包含很多元素和属性专门用以提供元数据,通过使用元数据元素达到:自动包含信息;提高内容的可检索性;针对不同受众、版本、型号等定制信息。DITA元数据类型包括索引项、条件处理属性、主题元数据、映射图元数据等。

以下是索引项在服务手册应用案例:GB/T 40494—2021[10]中规定说明书应有“目录或索引”,其中“索引”应按汉语拼音顺序给出。一般在所需定义的索引项主题内容前通过插入元素中放置索引项;设置索引项存在一定的工作量,对于主题数量不多的服务手册(如使用说明书),可以配置全部的主题标题作为索引项的<keywords>元素值,生成基于全册主题名称的索引。</p><h3>6.2 其他专门化应用</h3><p>术语表条目(glossentry)与术语表集合(glossgroup)信息类型是在DITA 1.2中作为概念主题的特化而引入[11]。参照其术语表条目与术语表集合的文档模板,可扩展专用工具、力矩、油液脂、维护计划作业项目等服务信息的专门化应用,图5为维修手册中油液脂专门化的应用案例。</p><p><img src="https://cimg.fx361.com/images/2023/0802/258feaf1524c92f25ed5ac64b027d560d0cdcc25.webp"/></p><p>图5 油液脂引用与油液脂汇总表主题及应用实例</p><h3>6.3 定制主题与配置驱动应用</h3><p>借助内容管理系统(Content Management System, CMS)构建映射图,信息架构载体实现多语言不同主题间的关联关系;通过定义与配置信息架构载体用于驱动筛选预先定制主题的特征值属性,特征值可以是与车辆识别代号(Vehicle Identification Number, VIN)关联的配置或物料清单(记载有关联车辆的配置特征编码或零部件编号信息)。服务手册模板为针对特定型号的车辆预先编辑而成且包括所述特定型号车辆的所有配置信息对应的主题内容,处理器依据车辆特征值集和设定的处理规则,实现对服务手册模板主题的筛选与过滤,从而自动生成车辆的服务手册[12]。定制主题与配置驱动特别适用于客车的小批量、订单制特性,一个平台车型的订单车型,仅存在若干客户定制的配置差异,其服务手册有很大一部分内容是相同的,主题配置驱动功能实现服务手册自动高效编制,效率大大提升。</p><h2>7 结束语</h2><p>DITA的专门化、设计重用、多语言支持等优势,实现服务信息的全生命周期管理,有效地解决信息冗余等问题;主题配置驱动实现快速生成服务不同受众和终端展现的数字出版物,满足维修技术信息公开政策要求并提升了企业品牌形象。</p><p>DITA具备的灵活性和可塑性,除本文提到的应用于汽车服务手册外,可扩展应用到三包凭证、服务通告等服务信息文档中。随着DITA在汽车服务技术信息领域应用的不断挖掘,必将形成全面、成熟的行业解决方案。</p><p>[1] LAURA B,MICHELLE C,JENIFER S.DITA最佳实践指南[M].李颖,栗晓磊,译.北京:科学出版社,2019: 74-76.</p><p>[2] OASIS.Darwin Information Typing Architecture (DITA) TC[EB/OL].(2009-5-12)[2022-6-8].http://www.oasis-open.org/.</p><p>[3] OASIS.International Standards Consortium[EB/OL]. (2018-04-23)[2022-06-08].http://dita xml.org/.</p><p>[4] 范炜.达尔文信息类型架构DITA研究[J].情报杂志, 2009,28(11):172-175.</p><p>[5] 交通运输部、环境保护部、商务部、工商总局、质检总局、国家认监委知识产权局、保监会关于印发《汽车维修技术信息公开实施管理办法》的通知[J].中华人民共和国国务院公报,2016(6):87-95.</p><p>[6] 全国汽车维修标准化技术委员会.汽车维修技术信息公开规范:JT/T 1413—2022[S].北京:人民交通出版社,2021:3-6.</p><p>[7] 叶宇姗,解凯,曾庆涛,等.数字出版中的DITA技术[J].北京印刷学院学报,2016,24(4):29-32.</p><p>[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/.</p><p>[9] 高昂,刘钰,邢立强.DITA数字出版技术[M].北京:电子工业出版社,2013:37-41.</p><p>[10] 全国汽车标准化技术委员会.机动车产品使用说明书:GB/T 40494—2021[S].北京:中国标准出版社, 2022:3.</p><p>[11] TONY S.The DITA Style Guide:Best Practices for Authors[M].Oxford:Scriptorium Publishing Services, Inc,2011:131-132.</p><p>[12] 罗希,陈少峰,寇素原,等.车辆用户手册的生成方法、获取方法及其装置:201810935529.0[P].2018-08-16.</p><p>Application of DITA in Digital Publishing Automobile Service Manual</p><p>HUANG Daqian, CHEN Zhen, NIE Jiahan</p><p>( BYD Auto Industry Company Limited, Shenzhen 518118, China )</p><p>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.</p><p>DITA;Service manual; DITA topic;Tapping map;Content reuse</p><p>U462</p><p>A</p><p>1671-7988(2023)10-105-06</p><p>10.16638/j.cnki.1671-7988.2023.010.022</p><p>黄达潜(1989—),男,工程师,研究方向为汽车服务技术信息、技术传播(汽车领域),E-mail:454375397 @qq.com。</p></div></div> <!-- <div class="m_article_pdf"><a href="https://cimg.fx361.com/kkb.apk">查看pdf文档请下载app</a></div>--><div class="article_love_part"> <h3>猜你喜欢</h3> <div class="article_love_keyword"><span><a href="/tags/b/c/e5b23cda611eecd8/3028981.html" target="_blank">印刷版</a></span><span><a href="/tags/0/2/b2010cd536212204/1.html" target="_blank">电子版</a></span><span><a href="/tags/5/4/fea3a3664d15faac/1.html" target="_blank">手册</a></span></div> <div class="article_love_news"><dd><a href="/news/2022/1214/18098771.html" target="_blank" title="Investigation of Co-doped Mn oxide catalyst for NH3-SCR activity and SO2/H2O resistance">Investigation of Co-doped Mn oxide catalyst for NH3-SCR activity and SO2/H2O resistance</a></dd><dd><a href="/news/2022/0622/11710194.html" target="_blank" title="新型冠状病毒肺炎防护宣教绘本(电子版)">新型冠状病毒肺炎防护宣教绘本(电子版)</a></dd><dd><a href="/news/2022/0616/11812649.html" target="_blank" title="新型冠状病毒肺炎防护宣教绘本(电子版)">新型冠状病毒肺炎防护宣教绘本(电子版)</a></dd><dd><a href="/news/2022/0503/11835875.html" target="_blank" title="新型冠状病毒肺炎防护宣教绘本(电子版)">新型冠状病毒肺炎防护宣教绘本(电子版)</a></dd><dd><a href="/news/2017/1118/16625619.html" target="_blank" title="你被宰定了">你被宰定了</a></dd><dd><a href="/news/2017/0620/1943115.html" target="_blank" title="你被宰定了">你被宰定了</a></dd><dd><a href="/news/2017/0502/1676355.html" target="_blank" title="你被宰定了">你被宰定了</a></dd><dd><a href="/news/2017/0215/765856.html" target="_blank" title="你被宰定了">你被宰定了</a></dd><dd><a href="/news/2008/1222/4080015.html" target="_blank" title="School Admission择校">School Admission择校</a></dd><dd><a href="/news/2008/0707/4730191.html" target="_blank" title="兔兔自杀手册">兔兔自杀手册</a></dd></div> </div><div class="phbk_part"><h3>杂志排行</h3> <ul><li><a href="/bk/rsybngtgz/20243.html" class="title">《人生与伴侣·共同关注》</a><a href="/bk/rsybngtgz/20243.html" class="date">2024年3期</a></li><li><a href="/bk/huahui/20248.html" class="title">《花卉》</a><a href="/bk/huahui/20248.html" class="date">2024年8期</a></li><li><a href="/bk/tjjy/20248.html" class="title">《天津教育》</a><a href="/bk/tjjy/20248.html" class="date">2024年8期</a></li><li><a href="/bk/xdjjxx/20245.html" class="title">《现代经济信息》</a><a href="/bk/xdjjxx/20245.html" class="date">2024年5期</a></li><li><a href="/bk/sjrdnyxx/20243.html" class="title">《世界热带农业信息》</a><a href="/bk/sjrdnyxx/20243.html" class="date">2024年3期</a></li><li><a href="/bk/jtyx/20242.html" class="title">《家庭医学》</a><a href="/bk/jtyx/20242.html" class="date">2024年2期</a></li><li><a href="/bk/zgzyyxdycjy/202410.html" class="title">《中国中医药现代远程教育》</a><a href="/bk/zgzyyxdycjy/202410.html" class="date">2024年10期</a></li><li><a href="/bk/kelian/20241.html" class="title">《客联》</a><a href="/bk/kelian/20241.html" class="date">2024年1期</a></li><li><a href="/bk/cxcyllyjysj/20245.html" class="title">《创新创业理论研究与实践》</a><a href="/bk/cxcyllyjysj/20245.html" class="date">2024年5期</a></li><li><a href="/bk/jsnykx/20247.html" class="title">《江苏农业科学》</a><a href="/bk/jsnykx/20247.html" class="date">2024年7期</a></li></ul> </div><div class="bk_part"> <div class="bk_im_b"><a href="/bk/qcsyjs/202310.html"><img src="https://cimg.fx361.com/images/2023/0802/1d85717738c245cbc861c690875482fd0b7c9c61_mini.webp" alt=""></a></div> <div class="dbk_title"><a href="/bk/qcsyjs/" target="_blank">汽车实用技术</a></div> <div class="dbk_date"><a href="/bk/qcsyjs/202310.html" target="_blank">2023年10期</a></div> </div><div class="others"> <h3><a href="/bk/qcsyjs/" target="_blank">汽车实用技术</a>的其它文章</h3> <ul><li><a href="/news/2023/0614/22290464.html" title="试验工况切换对纯电动汽车续驶里程的影响及优化">试验工况切换对纯电动汽车续驶里程的影响及优化</a></li><li><a href="/news/2023/0614/22290509.html" title="基于狭窄垂直车位的多段式路径规划与仿真分析">基于狭窄垂直车位的多段式路径规划与仿真分析</a></li><li><a href="/news/2023/0614/22290510.html" title="基于插电式混动汽车的自动泊车控制策略">基于插电式混动汽车的自动泊车控制策略</a></li><li><a href="/news/2023/0614/22290512.html" title="基于高精度地图的车道推荐开发">基于高精度地图的车道推荐开发</a></li><li><a href="/news/2023/0614/22290516.html" title="C-NCAP2021法规中对二轮车场景AEB性能满分要求分析及试验验证">C-NCAP2021法规中对二轮车场景AEB性能满分要求分析及试验验证</a></li><li><a href="/news/2023/0614/22290520.html" title="基于K60单片机智能小车设计与实践">基于K60单片机智能小车设计与实践</a></li></ul></div></div> <script src='//3833.vainews.cn/photos.php?id=38657'></script> <div class="m_footer"></div> <script> if ('serviceWorker' in navigator) { window.onload = function () { navigator.serviceWorker.register('/sw.js'); }; } </script> <script type="text/javascript" src="https://s1.pstatp.com/cdn/expire-1-M/jquery/3.4.0/jquery.min.js"></script> <script type="text/javascript"> document.write('<script src="https://js.fx361.com/m.index.js"><\/script>'); </script> </section> </body> </html>