mirror/postgresql
2
0
Fork 0
mirror of https://git.postgresql.org/git/postgresql.git synced 2024-12-21 08:29:39 +08:00
Code Issues Packages Projects Releases Wiki Activity

Add file to explain SGML linking options, for use by SGML document

Browse Source 
writers.
This commit is contained in:
Bruce Momjian 2009-01-10 04:40:08 +00:00
parent ccb51c0842
commit 908e2c7fd1
1 changed files with 34 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
doc/src/sgml/README.links Normal file
View File

@ -0,0 +1,34 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/README.links,v 1.1 2009/01/10 04:40:08 momjian Exp $ -->
Linking within SGML documents can be confusing, so here is a summary:
Intra-document Linking
----------------------
<xref>
used to link to a section without supplying text for the link;
text comes from the link target; has no close tag
http://www.oasis-open.org/docbook/documentation/reference/html/xref.html
<link>
allows link text to be supplied, requires </link>
http://www.oasis-open.org/docbook/documentation/reference/html/link.html
linkend=
controls the target of the link/xref
endterm=
allows the text of the link/xref to be taken from a different
link target; endterm in a <link> overrides the supplied text
External Linking
----------------
<ulink>
like <link>, but uses a URL (not a document target); requires
</ulink>; if no text is specified, the URL appears as the link text
http://www.oasis-open.org/docbook/documentation/reference/html/ulink.html
url=
used by <ulink> to specify the URL