【记录】尝试给Docbook添加MathML的支持

【背景】

收到别人一个邮件，说是在使用Docbook转PDF时，

对于：

的Math的公示，Docbook不支持，出现下面的错误：

然后其另外也去试了试：

“在转之前用jeuclid先处理xml文件，把公式转成图片，然后再把公式这段代码直接给替换成图片，然后在转成PDF”

【折腾过程】

1.然后去搜了很多相关的资料：

Docbook, MathML and PDF

MathML

The DocBook MathML Document Type

http://docbook.org/xml/mathml/1.0/dbmathml.dtd

mml:*

DocBook Specifications

-》

DocBook MathML Module

W3C MathML implementations page

W3C MathML implementations page

lf201, Applications: 编辑DocBook XML文档

-》》》》

发现：

http://www.w3.org/1998/Math/MathML/

是可以打开的->有效的namespace

而

http://www.sagehill.net/docbookxsl/MathML.html

->

http://www.w3.org/Math/DTD/mathml2

是打不开的

->无效的namespace？

但是：

是

http://www.w3.org/Math/DTD/

是可以打开的。

对应的有：

http://www.w3.org/Math/DTD/mathml3/mathml3.dtd

和：

http://www.w3.org/Math/DTD/mathml2/mathml2.dtd

2.此处再去对于上述用到的namespace：

http://www.w3.org/1998/Math/MathML/

确认是可以打开的：

3.去搜了搜：

jeuclid

找到：

JEuclid – 其它开源项目 – Java开源大全

发现是：

一个工具，可以讲mathml转换为图片的。

4.所以，此刻就是去自己试试，自己此处是否可以正常工作：

不过现在搜索：

Unknown formatting object   MathML math encountered a child of

找到：

Re: [docbook] Need help using MathML ("Unknown formatting object "{http:

其主要建议是：use namespace-aware stylesheets.

那待会自己去试的时候，也可以注意这点了。

5.写测试代码期间才发现，我之前自己的Docbook的源码中，就包含了MathML了：

只是之前没用过罢了。

6.测试代码：

结果编译出错：

看起来，此处的fop中，暂时不支持MathML。

估计需要加入对应的库才可以？

7.把测试代码换成：

MathML

中的：

即：

然后结果是：

还是同样错误。

8.google搜：

Unknown formatting object "{http://www.w3.org/1998/Math/MathML}math" encountered (a child of fo:instream-foreign-object}

找到：

docbook General – Need help using MathML ("Unknown formatting object "{http://www.w3.org/1998/Math/MathML}math" encountered")

然后去看看：

http://jeuclid.sourceforge.net/trunk/jeuclid-fop/

然后找到对应的下载的地方：

http://jeuclid.sourceforge.net/trunk/index.html

->

http://sourceforge.net/projects/jeuclid/files/3.1.x/

->

http://sourceforge.net/projects/jeuclid/files/3.1.x/3.1.9/

->

找了下fop的jar库：

jeuclid-fop-3.1.9-distribution.zip

然后解压拷贝对应的：

• jeuclid-core-3.1.9.jar
• jeuclid-fop-3.1.9.jar

到fop的lib中：

然后再去编译看看。

然后就真的没有错误了。

生成的pdf效果是：

很明显，没有看到我们想要的复杂的效果。

所以再去试试别的MathML的例子。

9.去把jeuclid中的example：

E:\dev_root\docbook\tools\MathML\jeuclid-fop-3.1.9-distribution\jeuclid-fop-3.1.9\example\example.mml

中的内容整合过来试试：

编译结果是出错：

10.算了，换成带namespace的：

编译结果是：

还是出错。

11.算了，去找个简单的MathML的例子吧。。

docbook General – Need help using MathML ("Unknown formatting object "{http://www.w3.org/1998/Math/MathML}math" encountered")

结果是：

可以正常生产pdf：

12.再去试试：

结果是：

出错了：

所以去尝试解决此MathML的语言错误。

13.去查查MathML的语法。

找到了官网：

MathML Namespace

->

Mathematical Markup Language (MathML) Version 3.0

->

Presentation Markup

里面有N多例子和详细语法的解释。

14.最后，终于搞清楚上述的错误原因了：

误把informalequation弄成了inlineequation

->是的编译时出错，说是，对于（inlineequation的）instream-foreign-object其下不支持fo:flow

->而对于本身informalequation，是正常支持的

最后，用：

就可以正常的生成pdf了：

15.另外，再去参考官网的很多例子：

去试试各种效果：

（1）代码：

效果：

评价：不太好，和原先官网的效果有很大差距。。。

（2）代码：

效果：

评价：效果真心不错。

16.另外再参考：

Presentation Examples

最后来个大集合：

效果：

评价：

其中部分的内容，显示异常，比如开根号之后的27次方等内容。

【总结】

此处在fop中用jeuclid去支持MathML的效果是：

1.一般的内容，都是可以正常输出pdf效果的。

2.有些复杂的，输出效果，要么是格式不对，要么是缺少内容。

总体评价：凑合用吧。

转载请注明：在路上 » 【记录】尝试给Docbook添加MathML的支持