Re: faq.xml.qna, yelp doesn't handle QandA
Michèle Garoche <[email protected]> Mon, 9 May 2005 19:53:51 +0200
| Newsgroups | gmane.editors.conglomerate.devel |
|---|---|
| Message-ID | <[email protected]> |
Le 9 mai 2005 à 19:35, Sean Wheller a écrit : > On Monday 09 May 2005 19:13, David Malcolm wrote: > >>> If we must package the FAQ then lets add a transformation to the >>> cong >>> build and ship a html file instead. >>> >> >> So we have a separate DocBook XML file for the FAQ, which gets >> transformed to HTML, and we stick it on the website and as in the >> tarball? This sounds like a good way forward to me. >> > > Not quite. :-) The FAQ is a separate XML file, it should not be > included as an > XML-instance in the package. Rather, it should be transformed to > HTML and the > HTML should be packaged. > > The user manual stays as XML. No need for preprocessing before > packaging > because it will work under yelp. If you transform the faq, which is a rather short file, comparing to the remaining doc, you'll put a severe load on the required dependancies: docbook and the like. Cheers, Michèle <http://micmacfr.homeunix.org>