2010-09-20 22:08:53 +02:00
|
|
|
<!-- doc/src/sgml/README.links -->
|
2009-01-10 05:40:08 +01:00
|
|
|
|
2019-02-15 17:29:41 +01:00
|
|
|
Linking within DocBook documents can be confusing, so here is a summary:
|
2009-01-10 05:40:08 +01:00
|
|
|
|
|
|
|
|
|
|
|
Intra-document Linking
|
|
|
|
----------------------
|
2009-01-10 17:03:15 +01:00
|
|
|
|
2009-01-10 05:40:08 +01:00
|
|
|
<xref>
|
2014-01-30 18:26:18 +01:00
|
|
|
use to get chapter/section number from the title of the target
|
|
|
|
link, or xreflabel if defined at the target, or refentrytitle if target
|
|
|
|
is a refentry; has no close tag
|
2009-01-10 05:40:08 +01:00
|
|
|
http://www.oasis-open.org/docbook/documentation/reference/html/xref.html
|
|
|
|
|
|
|
|
linkend=
|
2009-01-10 17:58:39 +01:00
|
|
|
controls the target of the link/xref, required
|
2009-01-10 05:40:08 +01:00
|
|
|
|
|
|
|
endterm=
|
2009-01-10 17:58:39 +01:00
|
|
|
for <xref>, allows the text of the link/xref to be taken from a
|
|
|
|
different link target title
|
2009-01-10 05:40:08 +01:00
|
|
|
|
2020-05-15 04:36:21 +02:00
|
|
|
<link>
|
|
|
|
use to supply text for the link, only uses linkend, requires </link>
|
|
|
|
http://www.oasis-open.org/docbook/documentation/reference/html/link.html
|
2021-04-22 22:01:17 +02:00
|
|
|
can be embedded inside of <command>, unlike <xref>
|
2020-05-15 04:36:21 +02:00
|
|
|
|
2009-01-10 17:03:15 +01:00
|
|
|
|
2009-01-10 05:40:08 +01:00
|
|
|
External Linking
|
|
|
|
----------------
|
2009-01-10 17:03:15 +01:00
|
|
|
|
2009-01-10 05:40:08 +01:00
|
|
|
<ulink>
|
|
|
|
like <link>, but uses a URL (not a document target); requires
|
2011-05-08 04:29:20 +02:00
|
|
|
</ulink>; if no text is specified, the URL appears as the link
|
|
|
|
text
|
2009-01-10 05:40:08 +01:00
|
|
|
http://www.oasis-open.org/docbook/documentation/reference/html/ulink.html
|
|
|
|
|
|
|
|
url=
|
2009-01-10 17:58:39 +01:00
|
|
|
used by <ulink> to specify the URL, required
|
2009-01-10 17:03:15 +01:00
|
|
|
|
|
|
|
|
|
|
|
Guidelines
|
|
|
|
----------
|
|
|
|
|
2019-03-29 13:36:24 +01:00
|
|
|
- For an internal link, if you want to supply text, use <link>, else
|
|
|
|
<xref>.
|
|
|
|
|
|
|
|
- Specific nouns like GUC variables, SQL commands, and contrib modules
|
|
|
|
usually have xreflabels.
|
|
|
|
|
|
|
|
- For an external link, use <ulink>, with or without link text.
|
2020-06-12 00:44:49 +02:00
|
|
|
|
|
|
|
- xreflabels added to tags prevent the chapter/section for id's from being
|
|
|
|
referenced; only the xreflabel is accessible. Therefore, use xreflabels
|
|
|
|
only when linking is common, and chapter/section information is unneeded.
|