网站开发的销售,网站建设书模板,免费查找资料的网站,四川省建设监督网随着DITA-OT 4.0的发布#xff0c;它提供了一种新的定制PDF样式方法#xff0c;这种方法就是PDF theme。这篇文章来聊一聊这种定制PDF输出的新方法和实验结果。
在进入PDF theme细节之前#xff0c;为各位读者梳理一下DITA-OT将DITA和Markdown发布成PDF的几种方法。
- 1 …随着DITA-OT 4.0的发布它提供了一种新的定制PDF样式方法这种方法就是PDF theme。这篇文章来聊一聊这种定制PDF输出的新方法和实验结果。
在进入PDF theme细节之前为各位读者梳理一下DITA-OT将DITA和Markdown发布成PDF的几种方法。
- 1 -
DITA-OT发布PDF的几种方法
DITA-OT是优秀的结构化内容发布工具是开源产品并得到广泛应用。很多公司将DITA-OT集成到自家的产品中还有公司在DITA-OT的基础上做了扩展。
现在在DITA-OT的基础上出现了多种发布PDF文档的方法。下边是其中两种请点开图看细节。 1. 使用PDF2插件
开源版DITA-OT将DITA和Markdown发布成PDF时使用的是上图中”1. 使用PDF2插件“的方法它使用的是XSLT/XSL-FO技术。
XSL-FO技术是DITA-OT用来发布PDF的技术目前也还有广泛的应用。当我们运行以下命令它使用的就是这种方法:
dita -i book.ditamap -f pdf -o out/pdf
此命令调用DITA-OT的PDF2插件将DITA内容转换成PDF。
在Oxygen XML Editor中选择”DITA Map PDF - based on XSL-FO发布文档时调用的也是这个插件 2. 使用pdf-css-html5
在2018年W3C发布了“CSS页面媒体模块级别3”标准用于支持使用CSS来将HTML页面发布成基于纸面的输出如PDF。这种方法得到了几个主流发布引擎厂商的支持比如Antenna HousePrinceXML和SyncRO Soft (也就是生产Oxygen XML Editor那家公司。
pdf-css-html5是SyncRO Soft基于DITA-OT开发的插件用于使用CSS技术来将DITA发布成PDF。这个插件只存在Oxygen XML Editor和Oxygen Publish Engine中是商用软件。
在Oxygen XML Editor中选择”DITA Map PDF - based on HTML CSS发布文档时调用的则是这个插件 如果使用开源版DITA-OT不包含商业插件在DITA-OT 4.0之前定制PDF样式需要使用XSLT/XSL-FO语言这对于TW来说有挑战。 “我是写文档的XSLT/XSL-FO什么鬼不想了解”
就算对于专业做样式定制的使用XSL-FO开发和维护成本总体较高。原因请见我之前文章的分析将CSS用于PDF发布
为了降低XSLT/XSL-FO定制PDF输出样式的难度和成本DITA-OT 4.0提供DITA theme来尝试降低定制PDF的难度和成本。
DITA-OT 4.0包括com.elovirta.pdf插件它通过提供theme参数扩展了默认的PDF2插件功能在不需要更改XSLT样式表的情况下更改PDF输出的样式。
- 2 -
DITA Theme概要
DITA theme可用于调整PDF输出的基本设置如封面图片、页面大小、编号、字体属性、背景色和边框、间距以及页眉和页脚等动态内容。
要使用自定义theme生成PDF输出dita调用命令如下
dita -i book.ditamap -f pdf -o out/pdf --themepath/to/custom-theme-file.yaml
theme文件可以用YAML或JSON格式编写DITA-OT安装目录中的docsrc/samples/themes文件夹提供了几个示例。
通过theme文件可以定制以下PDF选项 页面设置 页眉和页脚 内容元素的样式
1. 页面设置示例
page:size: A4orientation: portraittop: 20mmoutside: 20mmbottom: 20mminside: 30mmmirror-margins: true
2. 页眉和页脚示例
header:border-after: solid 1pt blackodd:content: {title}text-align: endeven:content: {chapter}text-align: start
3. 内容元素的样式示例
style:body:font-family: seriffont-size: 12ptspace-after: 6ptspace-before: 6ptstart-indent: 25pttopic:font-family: sans-seriffont-size: 26ptlink:color: bluetext-decoration: underline
DITA-OT的PDF theme文档在这里
https://www.dita-ot.org/dev/topics/pdf-themes
- 3 -
实验
在DITA-OT提供的示例theme基础上做以下调整
1整体和首页
设置中文字体加logo并居中 2页眉页脚
加分割线内容设置为文档标题 章节标题页脚中的页码居中显示加公司logo 3表格
表格标题居中显示表格序号自动生成标题行自动粗体并使用灰色背景 4图形
图形标题居中显示图形序号自动生成 5代码块和注
灰色背景适合代码的字体 - 4 -
总结
说一说使用DITA theme来定制PDF的感受 语法简单类似于CSS容易掌握 能够做一些简单的定制目前无法做到对输出的完全控制可以预测后续版本会有更多的增强 此方法是通过配置文件来控制XSL-FO的生成要理解配置的参数意义需要了解XSL-FO 点这里查看代码和生成的PDF文件。
