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>