Re: Question about faq.xml

Le 31 janv. 2005, à 14:08, Geert Stappers a écrit :
> On Mon, Jan 31, 2005 at 01:40:57PM +0100, Geert Stappers wrote:
>> On Wed, Dec 29, 2004 at 12:06:23PM +0100, Michèle Garoche wrote:
>>> Would not faq.xml be inserted inside conglomerate.xml, as appendix 
>>> for
>>> example, so that it is available when users browse the user manual?
[snip]
> Not processed by me, here I do need help.
Sorry, I did not understand you want me to help you.

1 - The doctype in conglomerate.xml is wrong:
It is:
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
                       
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
It should be:
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
                       
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
Note the V4.1.2 on the first line in the corrected version.

2 - yelp does not handle correctly quandaset (template calls FIXME, so 
that all is displayed in red color with default font size).
The way to handle this is to transform the quandaset into sections, 
like this:
		<sect1 id="generalfaq">
			<title>General questions</title>
			<sect2>
				<title>Why not just use XXX xml editor?</title>
					<para>blah blah. </para>
			</sect2>
		</sect1>
          ...
instead of:
	<qandaset>
		<qandadiv id="generalfaq">
			<title>General questions</title>
			<qandaentry>
				<question>
					<para>Why not just use XXX xml editor?</para>
				</question>
				<answer>
					<para>blah blah. </para>
				</answer>
			</qandaentry>
		</qandadiv>
          ...
      </quandaset>

I've done it manually and integrated it into conglomerate.xml just 
before the appendixes. It loads perfectly with yelp.

Now the question is:
Do you mind having this version on the web site?
Or do you prefer a script in the doc source to patch on the fly the faq 
as it is on the web site to be further processed for displaying with 
yelp? (I don't suggest a patch, since it would be a nightmare each time 
the faq were updated).

Michèle
<http://micmacfr.homeunix.org>

_______________________________________________
Conglomerate-devel mailing list
[email protected]
http://lists.copyleft.no/mailman/listinfo/conglomerate-devel