[Scilab-Dev] xml help and links

[Vincent COUVERT]

Hello Yann,

ycollet at freesurf.fr a écrit :
> Hello,
>
> I tried to add links in some help pages I made and I found this rather
> difficults.
> - you need to fill the xml:id at the top of the help page (here,
> sp_basis_abs)
>
> <refentry version="5.0-subset Scilab" xml:id="sp_basis_abs" xml:lang="en"
>           xmlns="http://docbook.org/ns/docbook"
>           xmlns:xlink="http://www.w3.org/1999/xlink"
>           xmlns:svg="http://www.w3.org/2000/svg"
>           xmlns:ns5="http://www.w3.org/1999/xhtml"
>           xmlns:mml="http://www.w3.org/1998/Math/MathML"
>           xmlns:db="http://docbook.org/ns/docbook">
>
> - and now, in a special refsection, I can add my links:
>
>   <refsection>
>     <title>See Also</title>
>
>     <simplelist type="inline">
>       <member><link linkend="sp_def">sp_def</link></member>
>       <member><link linkend="sp_basis_abs3">sp_basis_abs3</link></member>
>       <member><link linkend="sp_basis_hat">sp_basis_hat</link></member>
>       <member><link linkend="sp_fit">sp_fit</link></member>
>       <member><link linkend="spline1d_e">%spline1d</link></member>
>     </simplelist>
>   </refsection>
>
> And the links work.
>
> But if I use XXE to verify the validity of the xml file, it complains about
> missing xml:id. So, to be correct, I must have
>
>   <refsection>
>     <title>See Also</title>
>
>     <simplelist type="inline">
>       <member><link linkend="sp_def" xml:id="sp_def">sp_def</link></member>
>       <member><link linkend="sp_basis_abs3"
> xml:id="sp_basis_abs3">sp_basis_abs3</link></member>
>       <member><link linkend="sp_basis_hat"
> xml:id="sp_basis_hat">sp_basis_hat</link></member>
>       <member><link linkend="sp_fit" xml:id="sp_fit">sp_fit</link></member>
>       <member><link linkend="spline1d_e"
> xml:id="spline1d_e">%spline1d</link></member>
>     </simplelist>
>   </refsection>
>   
XXE does not know all xml:id of Scilab help when you write a file that's 
why you get an error about missing xml:id.
> But, now, the links doesn't work anymore ...
>
> Did I do something wrong ??
>   

If you add this xml:id to remove the error inside XXE, then when you 
compile Scilab help, you will have two similar xml:id (one in refsection 
and one in link) that's why the link does not work anymore.

Vincent
> YC
>
>   


-- 
==============================================
Vincent COUVERT
Responsable du développement
                    ------                    
Fondation DIGITEO - Consortium Scilab
Domaine de Voluceau - B.P. 105
78153 Le Chesnay Cedex
Bâtiment 23 - Bureau 22
                    ------                    
Email : vincent.couvert at scilab.org
Tél : +33 (0)1 39 63 54 46
Fax : +33 (0)1 39 63 55 94
==============================================