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。