Comment 3 for bug 387260

Yes, this should be possible. The current PDF seems to be made with a LaTex converter, and some parts are not well readable.

The attached file "referencer-plugins.pdf" is a printout of Yelp. Very nice, but the links doesn't work. That's why I've tried to use another converter. The docbook2odf command produces an *.odt file with well formatted hyperlinks, and we can create a PDF with OpenOffice, but it is buggy. See the file "referencer-plugins.odt.pdf".

At this time, the best way was to present a direct HTML conversion at Referencer's web page. You can get a valid HTML file by running the following command:

xsltproc /usr/share/xml/gnome/xslt/docbook/html/db2html.xsl referencer-plugins.xml > referencer-plugins.html

Be careful, a lot of subfiles will be created. But the appearance is the same as in Yelp. All links are working. And for offline-reading you can set a hint that the users can print a PDF file with Yelp. That's the simplest way. Additionally, you can provide the user manual at the same way at your web page.

Best Regards,
Mario