使用xslt將gnome-help（yelp）xml轉換爲靜態html

Question

Linux上的一些gnome應用程序使用名爲yelp的幫助瀏覽器。例如，侏儒計算器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格式。你會發現一些項目將這個docbook文件轉換爲html的http://wiki.docbook.org/DocBookToXhtml。

問候 魔女

Answer 2

根據您的gcalctool有多老，它的幫助文件可能是用DocBook或野鴨。如果它是綠頭鴨，你會看到一堆文件。否則，它是DocBook。無論哪種方式，您都可以使用yelp-build來創建HTML文件。它是yelp-tools包的一部分，並使用與Yelp相同的轉換。對於DocBook的，通過頂級XML文件：

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

對於野鴨，傳遞包含.page文件的目錄：

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

yelp-build將建立HTML，複製圖像和其他媒體文件，並照顧CSS和JavaScript。