<html>
<head>
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
</head>
<body text="#000000" bgcolor="#FFFFFF">
<div class="moz-cite-prefix">Hello,<br>
<br>
Le 20/10/2010 10:52, Calixte Denizet a écrit :<br>
</div>
<blockquote cite="mid:1287564734.766.769.camel@Calixte-Dell"
type="cite">
<pre wrap="">.../..
I fixed the bug on the forge:
<a class="moz-txt-link-freetext" href="http://forge.scilab.org/index.php/p/scidoc/source/commit/cb432547a66e60f1fd96561ac121e5e957e85c81/">http://forge.scilab.org/index.php/p/scidoc/source/commit/cb432547a66e60f1fd96561ac121e5e957e85c81/</a>
And I fixed a bug in MATEIG.xml (link instead of xref) :
<a class="moz-txt-link-freetext" href="http://codereview.scilab.org/#change,2319">http://codereview.scilab.org/#change,2319</a></pre>
</blockquote>
<br>
I fought more than 1 hour, trying to use the <xref> docbook
tag to build a <i>Table of Contents</i> with local cross-references
(in a long page), and i failed.<br>
I have finally found this message, and going to the codereview, i
discovered that <b>the Scilab implementation of the <xref>
docbook tag is not standard</b>. This is why i lost my time.<br>
<br>
Indeed, according to the <a class="moz-txt-link-freetext" href="http://docbook.org/tdg/en/html/xref.html">http://docbook.org/tdg/en/html/xref.html</a>
reference technical page, <xref> is normally an empty tag: the
visible clickable text is normally grabbed from the target, not
provided by <xref> itself. Normally, <xref ...>The text
to click</xref> is not meant to work, like
<link..>...</link> does.<br>
But Scilab's <xref> works like a <link></link>,
and does not work according to the docbook specification: Tried:<br>
<tt><xref linkend="targetted_id"></tt><tt><br>
</tt><tt>...</tt><tt><br>
</tt><tt><term id="targetted_id" xreflabel="The option
wb">Option wb</term></tt><tt><br>
</tt><br>
should build and display a link <tt><a
href="page_id.html#targetted_id"><font color="#3333ff">The
option wb</font></a></tt> where <xref> is located,
where the xreflabel attribute provides the visible text to be
clicked. But <xref> does not do that.<br>
Another standard way to use <xref> would be:<br>
<tt><xref linkend="targetted_id" endterm="targetted_id"></tt><tt><br>
</tt><tt>
...</tt><tt><br>
</tt><tt>
<term id="targetted_id">Option wb</term></tt><tt><br>
</tt><br>
building <tt><a href="page_id.html#targetted_id"><font
color="#3333ff">Option wb</font></a></tt> still where
<xref> is located, the text to click being equal to the text
embraced by the targeted tag (here
<term...>_____</term>)<br>
But the Scilab doc compiler does nor do that.<br>
<br>
So, just to remember: just use <xref> like the <link>
tag, with providing a reference that is internal to the page,
instead of the reference to an external page :<br>
<xref linkend="blabla">Option wb</xref><br>
...<br>
<term id="blabla">"wb"</term><br>
<br>
will show a link <font color="#3333ff"><i>Option wb</i></font> that
when ones click on it will go to the section of the page where the
term <term id="blabla">"wb"</term> appears.<br>
That's all.<br>
<br>
HTH<br>
Samuel Gougeon<br>
<br>
<br>
<br>
</body>
</html>