过去,很多组织需要编写和维护多个版本的文档,用于适应不同的平台和设备。这样工作模式工作量大、复杂度高。
通过采用 DITA 结构化写作方法,可以有效减少内容的重复,支持将同一数据发布成PDF、HTML、CHM等多种格式,从而降低了工作量,提高资料的准确性。
DITA 格式的内容是需要发布才能使用的。在发布方案中,被业界采用得最多的是DITA-OT(DITA Open Toolkit)。
作为一款强大的开源工具,DITA-OT支持定制文档的输出样式,可以生成符合自己公司品牌的、适用于多种设备和格式的输出。
DITA-OT已经被集成到多个结构化工具中,包括:Oxygen XML Editor和WebHelp,Adobe FrameMaker,XMetaL Author Enterprise,DITAToo,Heretto,Fluid Topics等。
DITA-OT 的优势体现在以下几个方面:
-
模块化架构:DITA-OT 基于 DITA(Darwin Information Typing Architecture)标准,采用模块化的方法来管理和组织文档内容。从版本 3.0 开始,DITA-OT 还加入了对 Markdown 的支持,这使得 XML 和 Markdown 格式可以结合输出,为文档创作提供更多的选择。
-
多样输出:DITA-OT 可以将同一内容转换成多种格式输出,如 HTML、PDF、EPUB 等,适用于各种不同的平台和设备。
-
定制化样式:DITA-OT 支持用户根据需求自定义样式和主题,以便更好地展示文档内容。
在结构化写作中,内容和样式的分离使得每个作者都能专注于内容创作,而无需担心排版问题。然而,文档最终的呈现效果以及读者的阅读体验仍然是需要关注的重要因素。
以这三大优势为支撑,DITA-OT 就像是一场接力赛的精彩呈现:模块化结构是起跑线,为技术文档的长期发展描绘了无限可能;多样输出是冲刺阶段,确保文档轻松适应各种输出格式的挑战。
而在中间环节,定制化样式则是背后的魔法,塑造文档的外貌与气质。这份外貌可以根据企业品牌、用户情感和平台设备需求的旋律,优雅地展现出独特的魅力。
定制之后,文档呈现出的异彩纷呈,不信?让我来为您展示!
我们就以PDF为例,来看看都定制了哪些样式 👇🏻
1 - 首页
首页通过定制化以后可以按照公司品牌形象统一风格,并且可以定义符合规范和符合公司要求的中文字体:
-
公司统一风格的首页
-
中文字体
2 - 页眉页脚
页眉页脚同样可以定制,添加公司 Logo、显示章节主题等:
-
奇数、偶数对称页眉
-
显示公司 Logo、章节主题
-
页眉和正文自定义分割线:线宽、颜色自定义
-
页脚自定义内容 - 页码位置和自动编号、添加版权信息、网址信息等
3 - 有序/无序列表
-
左侧对齐、左侧缩进
-
多级列表嵌套自动编号、自定义缩进距离
-
自定义无序列表 Icon
4 - 图
-
图片题注位于图片上方居中显示
-
图片可以自动编号
-
根据文档语言显示文字,例如:中文显示“图 1”,英文显示“Fig 1”
-
图片题注和图片显示在一页
5 - 表格
-
表格标题行字体加粗并且居中
-
表格标题行彩色高亮
-
PDF 全文表格固定宽度:例如100%显示
-
跨页的长表格标题行重复显示
-
表格题注位于表格正上方,并且表格题注自动编号
-
根据文档语言显示标题文字,例如:中文显示“表 1”,英文显示“Table 1”
-
表格题注和表格显示在一页,如果表格跨页,表格题注也重复显示
6 - 提示文字
提示文字也可以按照全文风格进行样式定制,使内容突出醒目:
-
自己风格的提示文字
PDF 格式中的精致样式中的活力演绎,在 DITA-OT 的魔法之下,变得如此引人注目!HTML 格式也同样可以进行丰富的定制!
而这种神奇的过程又是如何实现的呢?或许您想问,我们作为创作者,是否也能够驾驭这种创作魔力?
当然可以!制作定制化样式,让我们一起探索吧!🚀