DocBook: refer to a subfolder with <xref linkend>
Posted: Tue Mar 12, 2019 10:41 am
Hello,
I have a question which might be quite easy to answer for someone who has already worked with DocBook for a while. However, I was unable to find the correct answer in official DocBook documents.
I'd like to refer to a subfolder using <xref linkend>. At the end of a topic, there is a "next steps" section leading the user to other relevant topics. In the XML code below, the user is led to the XML file tools.xml in the same subfolder as the current XML file, when clicking on the link. That doesn't help in this case, because I have quite a huge substructure and would like to refer to "tools" in a parent folder or subfolder called "utilities". When I write <para><xref linkend="/utilities/tools"/>.</para, Oxgygen indicates "linkend is invalid; must be an XML Name without colons."
Is there any other link element in DocBook that allows to refer to a parent folder or subfolder?
Thanks a lot in advance.
[…]
<itemizedlist>
<title>Next steps</title>
<listitem>
<para><xref linkend="tools"/>.</para>
</listitem>
[…]
I have a question which might be quite easy to answer for someone who has already worked with DocBook for a while. However, I was unable to find the correct answer in official DocBook documents.
I'd like to refer to a subfolder using <xref linkend>. At the end of a topic, there is a "next steps" section leading the user to other relevant topics. In the XML code below, the user is led to the XML file tools.xml in the same subfolder as the current XML file, when clicking on the link. That doesn't help in this case, because I have quite a huge substructure and would like to refer to "tools" in a parent folder or subfolder called "utilities". When I write <para><xref linkend="/utilities/tools"/>.</para, Oxgygen indicates "linkend is invalid; must be an XML Name without colons."
Is there any other link element in DocBook that allows to refer to a parent folder or subfolder?
Thanks a lot in advance.
[…]
<itemizedlist>
<title>Next steps</title>
<listitem>
<para><xref linkend="tools"/>.</para>
</listitem>
[…]