整理在翻译与校对Spring 2.0 Reference时使用DocBook时的技巧与注意点
一、XML文件的编辑与校对
翻译校对时,在XML文件头前增加:
<!DOCTYPE chapter SYSTEM "../lib/docbook-dtd/docbookx.dtd">
<?xml-stylesheet type="text/xsl" href="../styles/fopdf.xsl" mce_href="../styles/fopdf.xsl"?>
提交前把这两行删除,以保证XML的合式,并可以实时用浏览器查看最终的结果并进行调整。
二、段落首行缩进两个字符
通常中文文档的段落首行会缩进两个字符。
HTML版本的输出在styles/html.css样式表里面增加样式定义即可,注意build时html.css也要拷贝过去,要不然,无效果,如下:
P
{
text-indent: 2em;
}
用FOP转换成PDF时可以通过设置param.xsl的参数。
方法是:在<xsl:attribute-set name="normal.para.spacing">中增加属性<xsl:attribute name="text-indent">2em</xsl:attribute>
变成如下即可:
<xsl:attribute-set name="normal.para.spacing">
<xsl:attribute name="text-indent">2em</xsl:attribute>
<xsl:attribute name="space-before.optimum">1em</xsl:attribute>
<xsl:attribute name="space-before.minimum">0.8em</xsl:attribute>
<xsl:attribute name="space-before.maximum">1.2em</xsl:attribute>
</xsl:attribute-set>
三、编译生成.chm文件
先利用DocBook及xsltproc来生成.hhp和.hhc文件以及所需的.html文件,然后利用hhc.exe来编译即可
命令如下:
C:\OpenDoc\Libxml\bin\xsltproc --output C:\OpenDoc\Spring\Reference\spring2rc2_zh_cn\dist\ C:\OpenDoc\DocBook\htmlhelp\htmlhelp.xsl C:\OpenDoc\Spring\Reference\spring2rc2_zh_cn\src\index.xml
由于要处理中文的问题,需要配置如下参数,下面对DocBook一些配置参数一些说明:
1、chunker.xsl中的
<xsl:param name="chunker.output.method" select="'html'"/><!-- -->
<xsl:param name="chunker.output.encoding" select="'ISO-8859-1'"/><!-- 输出的html中的text/html; charset=值 -->
<xsl:param name="chunker.output.indent" select="'yes'"/><!-- 输出的html会换行 -->
<xsl:param name="chunker.output.omit-xml-declaration" select="'no'"/>
<xsl:param name="chunker.output.standalone" select="'no'"/>
<xsl:param name="chunker.output.doctype-public" select="''"/>
<xsl:param name="chunker.output.doctype-system" select="''"/>
<xsl:param name="chunker.output.media-type" select="''"/>
<xsl:param name="chunker.output.cdata-section-elements" select="''"/>
<xsl:param name="saxon.character.representation" select="'native'"/><!-- 对于非ASCII码,按本地字符形式显示。缺省为entity;decimal,这样会把非ASCII码显示为数字实体的形式。可以用native来显示本地字符形式 -->
2、param.xsl中的
<xsl:param name="html.stylesheet" select="'styles/html.css'"/><!-- 使用css层式表 -->
<xsl:param name="l10n.gentext.language" select="'zh_cn'"/><!-- 生成的网页会使用中文习惯,如使用“目录”不用“Table of Content”,用“下一页”不用“Next”,用“章”不用“Chapter”,用“部分”不用“Part”,等等 -->
<xsl:param name="htmlhelp.encoding" select="'GBK'"/><!-- 生成.hhp及.hhc的编码,默认为iso-8859-1 -->
<xsl:param name="l10n.gentext.default.language" select="'en'"/><!-- -->
<xsl:param name="htmlhelp.chm" select="'Spring_2.0_Reference_zh_CN.chm'"/><!-- 编译生成.chm的文件名 -->
<xsl:param name="section.autolabel" select="0"/><!-- -->
<xsl:param name="section.label.includes.component.label" select="0"/><!-- -->
再用Microsoft HTML Help Workshop工具里的hhc.exe程序里命令行工具,hhw.exe为图形化操作界面,大家可能都比较熟悉了。
利用它们都可以进行编译chm文件。hhc.exe命令格式如下:
Usage: hhc <filename>
where <filename> = an HTML Help project file
Example: hhc myfile.hhp
如:hhc dist\htmlhelp.hhp
这样就可以编译出 Spring_2.0_Reference_zh_CN.chm 文件了,重要的是编辑出来的.chm可以进行中英文的搜索与正常的字符拷贝等。
四、其它继续整理总结中。。。
分享到:
相关推荐
在我们继续之前,有些许感谢的话要说:为了生成Hibernate参考指南,Chris Bauer(Hibernate 项目组成员)准备和调整了DocBook-XSL软件,同时也让我们生成了该文档。同样需要感谢Russell Healy,对于某些问题,他提供...
例如,你可以利用控制反转容器在前台的展现层使用Struts,还可以只使用 Hibernate集成编码 或是 JDBC抽象层 去处理数据存储。Spring被设计成(并将继续保持)无侵入性的方式,意味着应用几乎不需要对框架进行依赖...
例如,你可以利用控制反转容器在前台的展现层使用Struts,还可以只使用 Hibernate集成编码 或是 JDBC抽象层 去处理数据存储。Spring被设计成(并将继续保持)无侵入性的方式,意味着应用几乎不需要对框架进行依赖...
### DocBook 使用指南知识点概述 #### 一、简介与背景 **DocBook**是一种用于技术文档编写的语义标记语言,广泛应用于各种技术文档的创作之中。它采用XML(可扩展标记语言)作为基础,允许作者创建结构化的文档,...
在O'Reilly时代,DocBook得到了进一步的发展和完善,其后在Davenport时代,DocBook在文档结构和可扩展性上又有了新的提高。OASIS时代则进一步增强了DocBook标准。DocBook在版本5.0中引入了新的特性,这些新特性是该...
《DocBook 5.0中文版》是一本深入讲解DocBook 5.0技术细节的权威指南,由Norman Walsh和Leonard Muellner撰写,旨在帮助读者掌握使用XML进行结构化文档创作的方法与技巧。本书不仅适合XML和DocBook的新手,也适合...
【使用DocBook】是一种在IT行业中广泛采用的技术,主要用于创建结构化和技术性的文档。DocBook是一种XML架构,它定义了一套元素,使得作者能够描述文档的结构而不关注其外观。这个框架尤其适合编写用户手册、技术...
- **文档结构**:在编写 Docbook 文档时,应遵循其结构化规范,合理使用各种标签来组织内容,这样不仅有助于提高文档质量,也能更好地利用 Docbook 的特性进行转换。 - **实体定义**:合理使用实体定义可以提高文档...
这篇“docbook使用心得”博文链接分享了作者在使用 DocBook 过程中的经验与技巧。 在深入理解 DocBook 之前,我们先来了解一下 XML(可扩展标记语言)。XML 是一种用于描述数据的语言,其设计目标是传输和存储数据...
在使用DocBook时,有几个关键知识点是必须了解的: 1. **基本元素**:DocBook定义了一系列元素,如章节、段落、列表、表格、代码示例等,这些元素构成了技术文档的结构。了解每个元素的作用和用法是至关重要的。 2...
在编译mosquitto时,DocBook和其XSL转换器的使用可能涉及以下步骤: 1. 首先,需要解压“docbook-style-xsl.zip”并安装RPM包,以确保系统中有正确的XSL转换工具。 2. 使用DocBook XML格式编写或获取mosquitto的文档...
关于的DocBook的资料, 本人看过,觉得很不错,讲解很详细,应该对想学习DocBook的人有些帮助
### DocBook知识点详解 #### 一、DocBook概述 **DocBook**是一种强大的文档标记语言标准,主要用于技术文档的编写,尤其是与计算机硬件和软件相关的书籍及论文。它支持多种语言,包括RELAX NG、SGML (Standard ...
1 docbook-xsl-ns-1.75.2.zip解压到D:\docbook 2 另外四个压缩包解压出来,把里面的bin,include和lib三个文件夹拷贝到D:\docbook\xsltproc目录下 2 环境变量Path中增加 D:\docbook\xsltproc\bin 3 新建一个bat,...
《DocBook XML 4.2:构建技术文档的利器》 DocBook,作为一个标准化的XML词汇表,是用于编写技术文档的强大工具。DocBook XML 4.2版本是这一系列中的一个重要里程碑,它提供了丰富的元素和属性,使得作者能够详细地...
在软件开发领域,Gradle是一种强大的构建自动化工具,尤其在Java和相关技术栈中广泛应用。Spring框架作为Java生态系统中的核心组件,其构建和发布过程也需要高效、灵活的管理。"gradle-plugins"项目就是为了解决这个...
DocBook是一种广泛使用的标准,用于结构化和组织技术文档,特别是在软件开发领域。它提供了一套XML元素,这些元素用于定义技术文档的各种组成部分,如章节、摘要、代码示例等。"docbook-xml-4.5.zip" 是一个包含...
这个"docbook-xsl-1.73.2.zip"压缩包包含的是DocBook XSL样式表的1.73.2版本,这是一个关键组件在将DocBook XML文档转换成各种输出格式的过程中。 首先,让我们深入理解DocBook XML。DocBook是一种结构化的标记语言...
标题中的“pandoc-2.0.1.1-windows.zip”指的是Pandoc的Windows版本的安装包,这是版本号为2.0.1.1的压缩文件,专为在Windows操作系统上运行设计。Pandoc是一款强大的文档转换工具,能够处理多种标记语言和格式之间...