整理在翻译与校对Spring 2.0 Reference时使用DocBook时的技巧与注意点

一、XML文件的编辑与校对

翻译校对时，在XML文件头前增加：
[code]
<!DOCTYPE chapter SYSTEM "../lib/docbook-dtd/docbookx.dtd">
<?xml-stylesheet type="text/xsl" href="../styles/fopdf.xsl" mce_href="../styles/fopdf.xsl"?>
[/code]
提交前把这两行删除，以保证XML的合式，并可以实时用浏览器查看最终的结果并进行调整。

二、段落首行缩进两个字符
通常中文文档的段落首行会缩进两个字符。
HTML版本的输出在styles/html.css样式表里面增加样式定义即可，注意build时html.css也要拷贝过去，要不然，无效果，如下：
[code]
P
{
text-indent: 2em;
}
[/code]
用FOP转换成PDF时可以通过设置param.xsl的参数。
方法是：在<xsl:attribute-set name="normal.para.spacing">中增加属性<xsl:attribute name="text-indent">2em</xsl:attribute>
变成如下即可：
[code]
<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>
[/code]
三、编译生成.chm文件
先利用DocBook及xsltproc来生成.hhp和.hhc文件以及所需的.html文件，然后利用hhc.exe来编译即可
命令如下：
[code]
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
[/code]
由于要处理中文的问题，需要配置如下参数，下面对DocBook一些配置参数一些说明：
1、chunker.xsl中的
[code]
<xsl:param name="chunker.output.method" select="'html'"/>
<xsl:param name="chunker.output.encoding" select="'ISO-8859-1'"/>
<xsl:param name="chunker.output.indent" select="'yes'"/>
<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'"/>
[/code]
2、param.xsl中的
[code]
<xsl:param name="html.stylesheet" select="'styles/html.css'"/>
<xsl:param name="l10n.gentext.language" select="'zh_cn'"/>
<xsl:param name="htmlhelp.encoding" select="'GBK'"/>

<xsl:param name="l10n.gentext.default.language" select="'en'"/>

<xsl:param name="htmlhelp.chm" select="'Spring_2.0_Reference_zh_CN.chm'"/>

<xsl:param name="section.autolabel" select="0"/>
<xsl:param name="section.label.includes.component.label" select="0"/>
[/code]
再用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可以进行中英文的搜索与正常的字符拷贝等。

四、其它继续整理总结中。。。

整理在翻译与校对Spring 2.0 Reference时使用DocBook时的技巧与注意点相关推荐

Spring 3.0参考之SpEL
http://sishuok.com/forum/blogPost/list/2463.html http://docs.spring.io/spring/docs/3.0.x/reference/e ...
ApacheCN 翻译、校对、笔记整理活动（有偿）进度公告 2022.7
命令行上的数据科学第二版[校对][千字两元] 仓库:https://github.com/apachecn/ds-cmd-line-2e-zh 整体进度:https://github.com/apac ...
【翻译 Spring 5.0.4.RELEASE】1.The IoC container
其中最重要的是Spring框架的控制反转(IoC)容器. Spring框架的IoC容器的全面处理紧随其后,全面涵盖了Spring的面向方面编程(AOP)技术. Spring框架拥有自己的AOP框架,这 ...
www.how2j.com_HOW-TO：快速开始使用Spring 4.0，以构建简单的REST-Like API（演练）
www.how2j.com HOW-TO:快速开始使用Spring 4.0,以构建简单的REST-Like API(演练) 关于使用Spring MVC创建Web API的另一篇教程. 不太复杂. 只 ...
如何：从Spring 4.0快速入门以构建简单的REST-Like API（演练）
如何:从Spring 4.0快速入门以构建简单的REST-Like API(演练) 关于使用Spring MVC创建Web API的另一篇教程. 不太复杂. 只是一个演练. 生成的应用程序将提供简单的 ...
Spring Boot3.0正式发布及新特性解读
Spring Boot 3.0 正式发布同时发布更新的还有 2.7.x 和 2.6.x 两条版本线,Spring Boot 是我见过的发版最守时的技术框架之一. Spring Boot 3.0 现已 ...
小米手机超越苹果，成欧洲第二；马斯克特斯拉内部邮件：痛恨开会，少讲黑话；Spring 6.0 发布|极客头条
「极客头条」-- 技术人员的新闻圈! CSDN 的读者朋友们早上好哇,「极客头条」来啦,快来看今天都有哪些值得我们技术人关注的重要新闻吧. 整理 | 梦依丹出品 | CSDN(ID:CSDNnews ...
小米手机超越苹果，成欧洲第二；马斯克特斯拉内部邮件：痛恨开会，少讲黑话；Spring 6.0 发布|极客头条...
「极客头条」-- 技术人员的新闻圈! CSDN 的读者朋友们早上好哇,「极客头条」来啦,快来看今天都有哪些值得我们技术人关注的重要新闻吧. 整理 | 梦依丹出品 | CSDN(ID:CSDNnews ...
文献—Emergent simplicity in microbial community assembly--论文全过程详细阅读整理与翻译
本文对Emergent simplicity in microbial community assembly-- 论文全过程详细阅读整理原始文献Goldford J E , Lu N , Bajic ...

整理在翻译与校对Spring 2.0 Reference时使用DocBook时的技巧与注意点

整理在翻译与校对Spring 2.0 Reference时使用DocBook时的技巧与注意点相关推荐

最新文章

热门文章