Re: faq.xml.qna

Le 9 mai 2005 à 19:36, David Malcolm a écrit :

> On Sun, 2005-05-08 at 16:53 +0200, Sean Wheller wrote:
>
>> On Sunday 08 May 2005 16:49, Michèle Garoche wrote:
>>
>>>> Michèle if you can do yelp path/to/faq.xml and it opens then the
>>>> problem is
>>>> not with docs. But please see what I have done below.
>>>>
>>>
>>> That would not be a solution, too complicated for mac users, they  
>>> are
>>> not used to go with complicated paths. But as I said, there is no
>>> reason why it should not work.
>>>
>>
>> No, you miss understood me. I was meaning just for testing.  
>> Naturally, no user
>> should have to open the help in this way. It was just for you to  
>> test.
Oh, no need to test. I know it works provided that the file conforms  
to the gnome doc specification. I've already done it on many many files.

>>
>>
>>>> Not much I can do about this, the Yelp maintainer needs to add
>>>> support for
>>>> this.
>>>>
>>>
>>> No, this is simple, just a special xds file and it should be well. I
>>> can write it if needed. Otherwise the solution is to transform it as
>>> an article, that's what I've done in my patch.
>>>
>>> But anyway, I can do it just for Mac, if it is not wanted in the  
>>> tree.
>>>
>>
>> Yelp does not support xds files. I am now wholly confused.
>>
>
> I'm guessing Michèle meant an xsl file.  Though using xsltproc would
> probably do the job without needing that extra work (assuming I've
> understood correctly).
That's not yelp which supports xds file, but the process of making  
the doc supports it, so that it is possible to use that, or even  
better an xsl file and process the file through xsltproc, but that  
means that part of doc is process through gnome-doc process and  
another part through docbook. Part is viewed with yelp, another part  
with a browser.

Then the problem is more which call use to open the file, that's here  
the problem. That's what makes the menu help not working. It is, at  
least on the mac, possible to open a specific file in a specific  
location with either a browser (open foo.html), but the gnome- 
specific calls do not work.

Or third solution, if it is decided that the faq should be on the web  
site and nowhere else, the call to a remote file works.

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