docbook编辑器 XMLmind XML Editor的使用

版权所有,转载请注明来源http://gogo1217.iteye.com,违者必究!

XMLmind XML Editor(XXE),可视化xml编辑器,用于编写DocBook文档。

1、下载安装

请自行从官方地址下载,并安装好。地址:http://www.xmlmind.com/xmleditor/download.shtml

 

2、准备xsl

下载我分享在github的docbook转换样式表 https://github.com/gogo1217/docbook-xsl,该项目是一个maven工程,请自行mvn package编译,并将编译生成的压缩文件拷贝和解压至XXE目录。最终的目录结构如下所示:

 

 

3、设置字体

我们使用文泉驿正黑这款免费的开源中文字体(含英文字体)作为我们发布PDF的内嵌字体,该字体存放在上述压缩包的fonts目录下。
选择options/Preferences…,在弹出的窗口中选择Add-on/FOP下添加字体,界面如下:

点击“add”添加并设置字体,关于衬线字体、非衬线字体、等宽字体的解释,可以自行google。
WenQuanYiZenHei.ttf 用于标题显示 sans-serif (非衬线字体)

WenQuanYiZenHeiSharp.ttf 用于正文显示 serif(衬线字体)


WenQuanYiZenHeiMono.ttf 用于代码显示 monospace(等宽字体)

设置完后,界面如下,字体设置完毕后,可能需要重启下XXE才能生效。

4、设置自定义PDF转换XSL

选择options/Customize Configuration…/Customize Document Conversion Stylesheets,切换至PDF转换,然后点击add按钮,添加我们的自定义样式文件(xslt/pdf.xsl)。

 

 

5、添加PDF转换XSL参数

a)、设置PDF内嵌提示用的图片
选择options/Customize Configuration…/Change Document Conversion Parameters,切换至PDF转换,然后添加所需变量inlay.src.path,变量值指向docbook-xsl目 录。
如:
+docbook-xsl目录(inlay.src.path指向这里)

+-css

+-docbook
+-images
+–docbook
+—admon图片文件
+—callouts
+—-callouts图片文件

b)、设置语法高亮

默认情况下支持xml语法高亮,如需要支持更多,需指定参数highlight.xslthl.config,指向xslt/highlighting/xslthl-config.xml。

 

 

6、使用

在书写好docbook文档后,选择DocBook/Convert Document/Convert to PDF。xxe开始进行转换,转换完毕后,可以在你书写的书本同级目录看到输出结果。

大家也可以转换我分享的一个示例https://github.com/gogo1217/docbook-demo,这里是转换结果User_Guide.pdf (56.3 KB)

7、高级设置

a)、去掉保存时自动添加空白行

操作如下:取消Save选项中的Add open line的选中状态

 

b)、避免保存文件自动换行

这是因为xxe的默认行的字符数为70多,比较小,导致的。
操作如下:在Save选项中的Max.line.length设置为9999。

c)、编辑状态,中文不自动换行

操作如下:在view选项中选中Wrap words wider than available space。

 

猜你喜欢

转载自gogo1217.iteye.com/blog/2088628