使用xslt将gnome-help (yelp) xml转换为静态html

Question

linux上的一些gnome应用程序使用名为yelp的帮助浏览器。例如，gnome计算器gcalctool的帮助文件位于/usr/share/gnome/help/gcalctool中

然后按语言对文件夹进行排序。这些帮助文件基本上由一个xml文件和一些附带的png图形组成。

我尝试做的是将这个xml及其附带的png图形转换为静态HTML，因为我希望能够从不同的浏览器(firefox)正确地查看和导航文档。如果你想知道我在说什么，并且你在Linux上，只要运行gcalctool并打开帮助菜单即可。

不幸的是，用firefox直接打开xml是不成功的，因为没有样式表，因此firefox不知道如何格式化它。我读到过gnome应用程序使用一个名为libxslt (http://xmlsoft.org/libxslt/)的库来应用样式表。我对xslt一点也不熟悉。样式表是保存在别处，还是在编译时嵌入到源代码中？

我想我想知道的是，是否有可能使用libxslt本身或其他工具将xml和图形转换为静态HTML，最好是以yelp执行时相同的方式，或者以一种与yelp显示的输出完全/非常相似的方式。

谢谢

Answer 1

gcalctool使用docbook。Yelp带来了一切来显示这种xml格式。您将在http://wiki.docbook.org/DocBookToXhtml上找到一些项目来将此文档转换为html。

向马乔致以最美好的问候

Answer 2

根据您的gcalctool的历史，它的帮助文件可能是DocBook或Mallard格式的。如果是Mallard，你会看到一堆.page文件。否则，它就是DocBook。无论哪种方式，您都可以使用yelp-build创建HTML文件。它是yelp-tools包的一部分，并使用与Yelp相同的转换。对于DocBook，传递顶级XML文件：

yelp-build html -o /path/for/output/ /path/to/gcalctool.xml

对于Mallard，传递包含.page文件的目录：

yelp-build html -o /path/for/output/ /path/to/gcalctool/

yelp-build将构建超文本标记语言，复制图像和其他媒体文件，并处理CSS和JavaScript。