|
| 1 | +<!-- $PostgreSQL: pgsql/doc/src/sgml/README.links,v 1.1 2009/01/10 04:40:08 momjian Exp $ --> |
| 2 | + |
| 3 | +Linking within SGML documents can be confusing, so here is a summary: |
| 4 | + |
| 5 | + |
| 6 | +Intra-document Linking |
| 7 | +---------------------- |
| 8 | +<xref> |
| 9 | +used to link to a section without supplying text for the link; |
| 10 | +text comes from the link target; has no close tag |
| 11 | +http://www.oasis-open.org/docbook/documentation/reference/html/xref.html |
| 12 | + |
| 13 | +<link> |
| 14 | +allows link text to be supplied, requires </link> |
| 15 | +http://www.oasis-open.org/docbook/documentation/reference/html/link.html |
| 16 | + |
| 17 | + |
| 18 | +linkend= |
| 19 | +controls the target of the link/xref |
| 20 | + |
| 21 | +endterm= |
| 22 | + allows the text of the link/xref to be taken from a different |
| 23 | +link target; endterm in a <link> overrides the supplied text |
| 24 | + |
| 25 | + |
| 26 | +External Linking |
| 27 | +---------------- |
| 28 | +<ulink> |
| 29 | +like <link>, but uses a URL (not a document target); requires |
| 30 | +</ulink>; if no text is specified, the URL appears as the link text |
| 31 | +http://www.oasis-open.org/docbook/documentation/reference/html/ulink.html |
| 32 | + |
| 33 | +url= |
| 34 | +used by <ulink> to specify the URL |