`
gogo1217
  • 浏览: 150058 次
  • 性别: Icon_minigender_1
  • 来自: 上海
社区版块
存档分类
最新评论

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。

 

  • 大小: 122.2 KB
  • 大小: 19.5 KB
  • 大小: 75.2 KB
  • 大小: 42.7 KB
  • 大小: 43.4 KB
  • 大小: 41.6 KB
  • 大小: 56.4 KB
  • 大小: 51.7 KB
  • 大小: 27.8 KB
  • 大小: 37.3 KB
  • 大小: 32.6 KB
  • 大小: 32 KB
分享到：
| MaOS10.9.1 安装Oracle JDK7,启动eclipse ...
评论
16 楼 gogo1217 2014-07-12  
这个通过样式表就能控制吧。HTML的排版效果更多的是CSS样式表的事情了。
houyongbo03 写道
重装xxe解决了！请问生成html的，段落首行缩进是怎么设置的？
<xsl:param name="body.start.indent">2pt</xsl:param>
在网上查了一个这个参数，但是设置上了没效果！

15 楼 houyongbo03 2014-07-12  
重装xxe解决了！请问生成html的，段落首行缩进是怎么设置的？
<xsl:param name="body.start.indent">2pt</xsl:param>
在网上查了一个这个参数，但是设置上了没效果！
14 楼 houyongbo03 2014-07-11  
我用xxe生成文件，每行开头的两个字总是重复不知道什么原因？“基础介绍”就变成了“基基介绍”不知道是不是有什么地方的设置不对，恳请帮助！
13 楼 houyongbo03 2014-07-11  
找到原因了，不知道为什么！我在每行开始之前加一个空格就正常了！
12 楼 houyongbo03 2014-07-11  
我是生成HTML，大虾呀，求qq吧！
gogo1217 写道
是否按照我的过程设置了字体？
houyongbo03 写道
再打扰一下，我文档内容是中文的，生成的文件，中文都出问题了！
请问有遇到过这样的问题吗？谢谢！


11 楼 gogo1217 2014-07-10  
是否按照我的过程设置了字体？
houyongbo03 写道
再打扰一下，我文档内容是中文的，生成的文件，中文都出问题了！
请问有遇到过这样的问题吗？谢谢！

10 楼 houyongbo03 2014-07-10  
刚刚不知道为何图片发不了，我文件里面第一章叫“基础信息”，结果生成文件后变成“第 1 章 基基信息”
我的中文本地化配置改成你的pdf里面的配置了
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:exsl="http://exslt.org/common" version="1.0" exclude-result-prefixes="exsl">
	<xsl:import href="chunk.xsl"/>
	<!-- 修正默认中文语言中的 #和多余的.  -->
	<xsl:param name="local.l10n.xml" select="document('')"/>
	<l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0">
		<l:l10n language="zh_cn">
			<l:context name="title-numbered">
				<l:template name="chapter" text="第 %n 章 %t"/>
				<l:template name="section" text="%n %t"/>
				<l:template name="sect1" text="%n %t"/>
				<l:template name="sect2" text="%n %t"/>
				<l:template name="sect3" text="%n %t"/>
				<l:template name="sect4" text="%n %t"/>
				<l:template name="sect5" text="%n %t"/>
				<l:template name="appendix" text="附录 %n %t"/>
				<l:template name="article/appendix" text="%n %t"/>
				<l:template name="bridgehead" text="%n %t"/>
				<l:template name="part" text="部分 %n %t"/>
			</l:context>
			<l:context name="title">
				<l:template name="equation" text="公式 %n %t"/>
				<l:template name="example" text="例 %n %t"/>
				<l:template name="figure" text="图 %n %t"/>
				<l:template name="procedure.formal" text="过程 %n %t"/>
				<l:template name="productionset.formal" text="产品 %n"/>
				<l:template name="table" text="表 %n %t"/>
			</l:context>
		</l:l10n>
	</l:i18n>
	<!-- 启用中文本地化-->
	<xsl:param name="l10n.gentext.default.language" select="'zh_cn'"/>
	<!--文件输出编码-->
	<xsl:param name="chunker.output.encoding" select="'UTF-8'"/>
	<xsl:param name="chunker.output.indent" select="'yes'"/>
	<xsl:param name="toc.section.depth" select="2"/>
	<xsl:param name="section.autolabel" select="1"/>
	<xsl:param name="section.label.includes.component.label" select="1"/>
	<xsl:param name="admon.graphics" select="1"/>
	<xsl:param name="admon.graphics.path" select="'images/'"/>
	<xsl:param name="admon.graphics.extension" select="'.png'"/>
	<xsl:param name="admon.textlabel" select="0"/>
</xsl:stylesheet>
9 楼 houyongbo03 2014-07-10  
再打扰一下，我文档内容是中文的，生成的文件，中文都出问题了！
请问有遇到过这样的问题吗？谢谢！
8 楼 gogo1217 2014-07-10  
直接使用导出HTML即可，非单个的html。
houyongbo03 写道
版主您好
我改了一个xsl文件，里面的设置怎么都没有生效呀？
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:exsl="http://exslt.org/common" version="1.0" exclude-result-prefixes="exsl">
	<xsl:import href="chunk.xsl"/>
	<xsl:param name="local.l10n.xml" select="document('')"/>
	<l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0">
		<l:l10n language="zh_cn">
			<l:context name="title-numbered">
				<l:template name="chapter" text="第 %n 章 %t"/>
				<l:template name="section" text="%n %t"/>
			</l:context>
		</l:l10n>
	</l:i18n>
	<!--文件输出编码-->
	<xsl:param name="chunker.output.encoding" select="'UTF-8'"/>
	<xsl:param name="chunker.output.indent" select="'yes'"/>
	<xsl:param name="toc.section.depth" select="2"/>
	<xsl:param name="section.autolabel" select="1"/>
	<xsl:param name="section.label.includes.component.label" select="1"/>
	<xsl:param name="admon.graphics" select="1"/>
	<xsl:param name="admon.graphics.path" select="'images/'"/>
	<xsl:param name="admon.graphics.extension" select="'.png'"/>
	<xsl:param name="admon.textlabel" select="0"/>
</xsl:stylesheet>

我就是想将生成的html文件能用中文显示上一页、下一页、主页、向上，还有章节页显示中文。非常感谢！

7 楼 houyongbo03 2014-07-09  
版主您好
我改了一个xsl文件，里面的设置怎么都没有生效呀？
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:exsl="http://exslt.org/common" version="1.0" exclude-result-prefixes="exsl">
	<xsl:import href="chunk.xsl"/>
	<xsl:param name="local.l10n.xml" select="document('')"/>
	<l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0">
		<l:l10n language="zh_cn">
			<l:context name="title-numbered">
				<l:template name="chapter" text="第 %n 章 %t"/>
				<l:template name="section" text="%n %t"/>
			</l:context>
		</l:l10n>
	</l:i18n>
	<!--文件输出编码-->
	<xsl:param name="chunker.output.encoding" select="'UTF-8'"/>
	<xsl:param name="chunker.output.indent" select="'yes'"/>
	<xsl:param name="toc.section.depth" select="2"/>
	<xsl:param name="section.autolabel" select="1"/>
	<xsl:param name="section.label.includes.component.label" select="1"/>
	<xsl:param name="admon.graphics" select="1"/>
	<xsl:param name="admon.graphics.path" select="'images/'"/>
	<xsl:param name="admon.graphics.extension" select="'.png'"/>
	<xsl:param name="admon.textlabel" select="0"/>
</xsl:stylesheet>

我就是想将生成的html文件能用中文显示上一页、下一页、主页、向上，还有章节页显示中文。非常感谢！
6 楼 houyongbo03 2014-07-09  
版主，您好：
5 楼 houyongbo03 2014-07-09  
gogo1217 写道
已经修复，请从github获取最新代码，目前没有对html的样式表进行美化，直接使用的jboss的，所以可能会有点难看。
houyongbo03 写道
版主，您好：
请问你有没有使用你的包生成过html的文档（xhtml.xsl），我参照你的方法修改生成html的文件报：
Error: Variable use.simplified.author.group has not been declared; SystemID: file:/D:/Program%20Files%20(x86)/XMLmind_XML_Editor/docbook-xsl-0.0.1-SNAPSHOTS/xslt/xhtml-common.xsl; Line#: 81; Column#: -1
Error: Variable confidential has not been declared; SystemID: file:/D:/Program%20Files%20(x86)/XMLmind_XML_Editor/docbook-xsl-0.0.1-SNAPSHOTS/xslt/xhtml-common.xsl; Line#: 438; Column#: -1


非常感谢！
4 楼 gogo1217 2014-07-09  
已经修复，请从github获取最新代码，目前没有对html的样式表进行美化，直接使用的jboss的，所以可能会有点难看。
houyongbo03 写道
版主，您好：
请问你有没有使用你的包生成过html的文档（xhtml.xsl），我参照你的方法修改生成html的文件报：
Error: Variable use.simplified.author.group has not been declared; SystemID: file:/D:/Program%20Files%20(x86)/XMLmind_XML_Editor/docbook-xsl-0.0.1-SNAPSHOTS/xslt/xhtml-common.xsl; Line#: 81; Column#: -1
Error: Variable confidential has not been declared; SystemID: file:/D:/Program%20Files%20(x86)/XMLmind_XML_Editor/docbook-xsl-0.0.1-SNAPSHOTS/xslt/xhtml-common.xsl; Line#: 438; Column#: -1

3 楼 houyongbo03 2014-07-08  
我用你的方法生成pdf已经能成功了，但是我现在要生成html的格式，谢谢！
2 楼 houyongbo03 2014-07-08  
版主，您好：
请问你有没有使用你的包生成过html的文档（xhtml.xsl），我参照你的方法修改生成html的文件报：
Error: Variable use.simplified.author.group has not been declared; SystemID: file:/D:/Program%20Files%20(x86)/XMLmind_XML_Editor/docbook-xsl-0.0.1-SNAPSHOTS/xslt/xhtml-common.xsl; Line#: 81; Column#: -1
Error: Variable confidential has not been declared; SystemID: file:/D:/Program%20Files%20(x86)/XMLmind_XML_Editor/docbook-xsl-0.0.1-SNAPSHOTS/xslt/xhtml-common.xsl; Line#: 438; Column#: -1
1 楼 houyongbo03 2014-07-07  
版主真是说话算话！太谢谢了！
发表评论

您还没有登录,请您登录后再发表评论

相关推荐

    XMLmind XML Editor 5.5.0 破解版

    XMLmind XML Editor是一个优秀的XML可视化编辑器，并且支持docbook的编辑与生成，这是我所看到的最好的XML可视化编辑器，体积小，功能全。当前最新版为5.5.0，基于Java。 破解方法很简单，就是找到安装目录下的bin/...

    XMLmind XML Editor 個人版

    xxe 個人版本，現在官網已經找不到了，只有評估版供下載。 不喜歡付費又不想破解的， 可以用這個。 在 windows 和 linux 下都可以用的

    oXygen XML Editor（XML脚本编辑软件）

    oXygen XML Editor是一个多平台的XML编辑器（里诺下载站提供），XSLT / XQuery的调试器和分析器具有完整的Unicode支持。它提供了一个强大的代码洞察力，可以遵循DTD，RELAX NG或者XML架构，甚至可以从部分编辑过的...

    docbook向导书

    简单介绍XMLmind XML Editor的试用，XMLmind XML Editor是一个编辑XML文件很好用的编辑器，其向导对该软件有详细说明，不过是英文地....

    docbook-xml-4.2.zip

    docbook-xml-4.2.zip docbook-xml-4.2.zip

    docbook-xml-4.5.zip

    docbook用xml书写时的dtd

    Oxygen xml editor 12

    安装文件下载地址： http://www.newhua.com/soft/17613.htm 运行.bat 先算号，再打补丁。

    XMLMind DocBook工具

    XMLMind DocBook工具

    Serna Free XML编辑器

    Serna Free是开源的、跨平台的、所见即所得的XML编辑器， 易上手，功能强大，可以应付复杂的XML技术，支持DITA、Docbook、XHTML、TEI P4和NITF等XML文件类型。Serna由Syntext开发，Serna Free是其开源版本（最新版本...

    Oxygen.XML.Editor.v14.2.Key.and.Patch (for build 2013051016)

    Oxygen.XML.Editor.Enterprise.Edition.v14.2（build 2013051016）激活补丁 本激活补丁适用于build id：2013051016版本（包含x86和x64版本）。 使用方法： 1）从...

    Oxygen.XML.Editor.v14.2.Key.and.Patch-FALLEN

    Oxygen.XML.Editor.Enterprise.Edition.v14.2（build 2013040919）激活补丁 本激活补丁适用于build id：2013040919版本（包含x86和x64版本）。 使用方法： 1）从...

    DocBook5安装文件

    1 docbook-xsl-ns-1.75.2.zip解压到D:\docbook 2 另外四个压缩包解压出来，把里面的bin，include...3 新建一个bat，内容为：xsltproc -o book_cn.html D:\docbook\docbook-xsl-ns-1.75.2\html\docbook.xsl book_cn.xml

    docbook 指南

    docbook 有关xml格式的文档说明。有需求的可以参考，非常不错。

    DocBook的使用指南(English Version)

    国内DocBook的使用还不普便,主要是相关使用文档,示例太少. 我自己写的一份Quick Reference的DocBook使用指南,希望能对国内DocBook的普及有一点点帮助.

    DocBook文档管理工具

    DocBook is a very popular set of tags for describing books, ... DocBook is defined using the native DTD syntax of SGML and XML. Like HTML, DocBook is an example of a markup language defined in SGML/XML.

    DocBook

    关于的DocBook的资料, 本人看过,觉得很不错,讲解很详细,应该对想学习DocBook的人有些帮助

    html2docbook:一个简单的 WYSIWYG HTML 到 Docbook 编辑器的源代码，位于 http

    WYSIWY（有点）G Docbook 章节编辑。 h1：章节 h2：Sect1 h3：Sect2 h4：Sect3 其余见源码。 在这方面有很多工作要做，当我有更多时间时我会这样做。 执照 MIT 许可证 (MIT) 版权所有 (c) 2012 Brian P. Hogan ...

    xml-vim:关于Vim编辑器如何帮助您进行XML（Docbook）编辑的简短文章

    xml-vim 关于Vim编辑器如何帮助您进行XML（/ Docbook）编辑的简短文章

    DocBook学习笔记

    DocBook 是一种模式（在多种语言下可用，包括RELAX NG、SGML 和 XML DTDs ，以及 W3C XML 模式），它由OASIS 的DocBook 技术委员会维护。它非常适合于关于计算机硬件和软件的书籍和论文（虽然它绝不限于这些应用）。...

Magicbox
Global site tag (gtag.js) - Google Analytics