Re: Question related to API doc editing

Florian,


I have contacted Robin Berjon, the editor of ReSpec tool.


Your # fragment is a bug with the SHJS library (see Robin's email bellow).

It should be fixed if you use the lastest version at
   http://dev.w3.org/2009/dap/ReSpec.js/

Best,
Thierry




Le 07/03/2011 10:50, Robin Berjon a écrit :
 > Hi Thierry,
 >
 > On Mar 7, 2011, at 08:58 , Thierry MICHEL wrote:
 >> But I have a small issue;
 >>
 >> How can we code a link to an URI and its fragment, the "#" in a URL 
inside an Example section in order to keep the complete link?
 >> like
 >> "http://www.ontologyportal.org/WordNet#WN30Word-standardisation"
 >> (see section 4.5.3.3.2)
 >> 
http://dev.w3.org/2008/video/mediaann/mediaont-api-1.0/mediaont-api-1.0.html#example-in-javascript-10
 >
 > This is a bug with the SHJS library that we include to do syntax 
highlighting. I believe that I've fixed it in ReSpec but it doesn't show 
up in your document because you link to your own copy of ReSpec. Please 
update your copy to see if it solves your problem. In general, it's 
probably a better idea to link to the original copy in your documents so 
that you get fixes immediately (especially for the bibliography DB which 
gets updated quite often).
 >
 > --
 > Robin Berjon
 >    robineko — hired gun, higher standards
 >    http://robineko.com/
 >
 >
 >
 >
















Le 07/03/2011 08:49, Thierry MICHEL a écrit :
> ReSpec relies on an external database of references stored as the
> berjon.biblio Javascript object
>
>
> I am not an expert of this new publication tool, as I never used it, but
> to add a normative Reference I see that you should use this file
> http://dev.w3.org/2008/video/mediaann/ReSpec.js/bibref/biblio.js
>
> there is a long list of references you can use there, or add new ones.
>
> Then use double brakets, for example [[HTTP11]] to link to the HTTP11
> normative Reference. The script will automatically do the linking.
>
>
> For the # in the URL, I see the issue for
> "http://www.ontologyportal.org/WordNet#WN30Word-standardisation",
>
> The ReSpec documentation [1] does not help much.
>
> Wonsuk do you have a clue ?
>
> Else I will ask Robin Berjon, the editor of this tool.
>
>
> [1] http://dev.w3.org/2008/video/mediaann/ReSpec.js/documentation.html
>
> Thierry.
>
>
> Le 02/03/2011 16:22, Florian Stegmaier a écrit :
>> HI Thierry& Wonsuk!
>>
>> Werner and i have a small question related to the editing of the
>> document:
>>
>> * How can we code the "#" in a URL inside a Example section in order
>> to keep the complete link? (see 4.5.3.3.2)
>> * How to add a normative Reference?
>>
>> Thanks in advance! The current version in dev space [1] is more or
>> less stable. I will post the new version today/tomorrow via the
>> mailing list.
>>
>> Best,
>> Florian
>>
>> [1]
>> http://dev.w3.org/2008/video/mediaann/mediaont-api-1.0/mediaont-api-1.0.html
>>
>> _____________________________
>> Dipl. Inf. Florian Stegmaier
>> Chair of Distributed Information Systems
>> University of Passau
>> Innstr. 43
>> 94032 Passau
>>
>> Room 248 ITZ
>>
>> Tel.: +49 851 509 3063
>> Fax: +49 851 509 3062
>>
>> stegmai@dimis.fim.uni-passau.de
>> https://www.dimis.fim.uni-passau.de/iris/
>> http://twitter.com/fstegmai
>> _____________________________
>>

Received on Monday, 7 March 2011 14:36:28 UTC