Re: faq.xml.qna

Le 7 mai 2005 à 08:27, Sean Wheller a écrit :
> On Saturday 07 May 2005 01:25, Michèle Garoche wrote:
>>
>> I have:
>>   yelp pathtomanual (and then I need faq integrated into manual)
>> which works
>>   Help > Web site works
> Understood.
>>   Help > FAQ does not work
> This one cannot work in Yelp directly from the XML because Yelp  
> does not
> support qanda sets. While the XML-instance may be loaded, Yelp  
> cannot format
> it because it does not have support for the Docbook question and  
> answer
> format.
That was already said many times.

> The alternative is for us to first transform the FAQ from XML to
> X/HTML. Then when you select the event Help > FAQ it will display  
> the FAQ in
> your default browser.
I already said that does not work. How can I express it so that you  
take it into account?

>>   Help > Manual does not work
> This is not good.
good or not, that's not the problem here. The fact is it does not work.

> Do you get any error messages from Yelp when you invoke Yelp
> passing it the faq file?
I told you that not a single file shows in Menu->Help on fink because  
somewhere a path to /usr/... is hardcoded. This is a known issue. So  
Menu->Help is a no no for Mac users.


> Please test conglomerate.xml with xmllint to see whether or not it  
> is valid
> and well-formed. I recently committed a patch to cvs that made the  
> document
> such. If the doc is not well-formed, please get the  
> conglomerate.xml from cvs
> and try that.
When, it has not appeared yet on cvs (I'm on cvs anonymous).

> I removed FAQ from this version of the user manual. On my system I  
> am able to
> open the file in help.
Your system is not mine. Just admit that Menu->Help does not work on  
mine and we can go further.
But yelp works.

>> Actually I have preferences, since there is no reason that mac users
>> have to connect to internet to read the help. So for me faq into
>> manual is better, because then yelp manual wich allows to read the  
>> faq.
>> That's the same if the faq is not integrated into the manual by the
>> way, yelp manual should work.
>>
> Yes, you are correct. They should not have to connect to the Internet.
> However, the HTML file can also reside on the local file system.  
> Therefore
> the event Help > FAQ will load an HTML file from the local disk,  
> not the
> network.
If you invoke yelp faq and the faq is in article format it works. If  
you invoke Menu->Help->Faq it does not work. And request from the  
user that it goes under a very long path to discover where the faq  
is, is not a good alternative for Mac users which are used to have a  
bunch of facilities (i.e. everything accessible from menus inside the  
application), so that they don't even know  where to search. That's  
why yelp is a good alternative. Because just launching yelp is not  
too high demand.

>
> I realize this does not fix your problem for now. But, it may be a  
> way forward
> for the next release. What do you think?
Well, that's up to you. If I cannot compile conglomerate till the  
next release, that means I cannot test it on Mac, which means also  
that it's more than likely that I will not package it for fink. (i.e.  
I'm the fink's maintainer for conglomerate).

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