Documentation for Evergreen version 1.6
Copyright © 2010, Evergreen Community
There are many way to link w/ docbook but the options in the table below cover the most common documentation scenarios.
| Linking scenario | Syntax | Output | Notes |
|---|---|---|---|
| Internal link with auto-generated link text | <xref linkend="style-glossary"/> | Chapter 1, DIG DocBook reference | The linkend value (style-glossary) is the xml:id of the target element; link text is auto-generated from the target. The tag is self-closing (no </xref> closing tag required> |
| Internal link with custom link text | <link linkend="style-glossary">The DIG glossary page</link> | The DIG glossary page | linkend is the xml:id of the target element; link text is supplied by author |
| External link | <link xlink:href="http://evergreen-ils.org/" xlink:title="Link hover text goes here">http://evergreen-ils.org/</link> | http://evergreen-ils.org/ | xlink:href is the target URL. It is good practice to show full URL so users can see it in PDF or copy and paste from pages displayed in the staff client (to open in a separate browser) |
For internal links the hover tip text is generated automatically; for external links please include an xlink:title, otherwise the link hover text will be the name of the section or chapter where the link appears.
Documentation for Evergreen version 1.6
Copyright © 2010, Evergreen Community
