`
gogo1217
  • 浏览: 152316 次
  • 性别: 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 個人版

    XMLmind XML Editor（XXE）是一款专业级的XML编辑器，专为处理XML文档和DocBook等特定格式而设计。这款编辑器提供了丰富的功能，使得XML文档的创建、编辑和格式化变得更加简单。虽然官方已不再提供个人版的下载，但...

    docbook向导书

    **XMLmind XML Editor** 是一款专为处理 XML 文件设计的强大编辑器，它支持多种 XML 语言，如 DocBook、DITA 等，并提供了一系列高效的功能来帮助用户创建、编辑和管理 XML 文档。 ##### 1.1 安装要求 在安装 ...

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

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

    使用DocBook

    - **XML编辑器**：例如Oxygen XML Editor、XMLMind XML Editor等，提供语法高亮和验证功能。 - **验证器**：如XMLStarlet、xmllint等，检查文档的正确性。 - **转换工具**：典型的有Apache FOP用于生成PDF，XSL-...

    Oxygen_XML_Editor_21.0_Build_2019022207_macOS_Downloadly.ir.rar

    在实际应用中，Oxygen XML Editor广泛应用于XML文档的创建和维护，例如技术文档、XML数据库、电子书、Web服务以及各种行业标准（如TEI、DocBook等）的文档处理。无论你是XML初学者还是资深开发者，这款编辑器都能为...

    Python库 | docbook2sla-0.0.6.tar.gz

    在实际应用中，Python库docbook2sla可能与其他工具链结合使用，例如与DocBook编辑器（如XMLmind XML Editor）或构建工具（如Makefile或Sphinx）配合，形成完整的文档处理流程。这样，开发者可以在保持文档结构化的...

    windows下配置docbook

    4. **安装 XML 编辑器**：推荐使用 Oxygen XML Editor 或 XMLSpy 这样的专业编辑器，它们提供了对 Docbook 的良好支持。 **2.2 配置环境** 1. **设置环境变量**：确保 JDK、Apache Ant 和 Docbook XSL 样式表的...

    DocBook文档

    8. **集成环境**：有些IDE和文本编辑器（如 Oxygen XML Editor, Emacs with nXML mode 等）提供了对DocBook的良好支持，可以帮助提升编写效率。 9. **社区与资源**：DocBook有一个活跃的开发者社区，提供了许多在线...

    JEX - Java Easy XML editor-开源

    **Java Easy XML Editor (JEX) - 开源XML编辑器** **简介** JEX，全称为Java Easy XML editor，是一款专为Java开发者设计的开源XML编辑工具。它以简洁、直观的用户界面和便捷的层次结构操作为特点，旨在简化XML文档...

    docbook5 测试文件1.pdf

    1. **XML编辑器**：选择一款适合的XML编辑器，如Oxygen XML Editor或XMLSpy。 2. **XSLT处理器**：例如Saxon或者Xalan-J。 3. **DocBook XSL样式表**：这是将DocBook XML转换为其他格式的核心工具。 4. **字体配置**...

    vex-1.2.1-plugins.zip

    VEX，全称为Visual Editor for XML，是一款专为Eclipse集成开发环境设计的插件，旨在将Eclipse转变为一个功能强大的XML编辑器。这个“vex-1.2.1-plugins.zip”压缩包包含了使Eclipse能够支持XML文档编写，特别是针对...

    企业级Git Server服务的部署与应用1

    执行`./configure`命令进行配置，这里的关键参数包括安装路径、配置文件路径、编辑器路径以及各种库的路径。例如： ``` ./configure --prefix=/usr/local/git \ --with-gitconfig=/usr/local/git/etc/gitconfig \...

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