Supported, unsupported, and disallowed
$
publican print_known
to print a list of tags that Publican supports, and the command publican print_banned
to print a list of tags that are banned in Publican.
<caution>
, <tip>
<tip>
, <note>
, <important>
, <caution>
, and <warning>
. Taken together, these represent a very fine-grained set of distinctions. It is unlikely that these fine distinctions can be applied consistently within a document, especially when more than one person writes or maintains the document. Moreover, this level of granularity is meaningless to readers. By design, Publican disallows the <tip>
and <caution>
elements, these elements being the two most redundant in the set.
<note>
instead of <tip>
, and use either <important>
or <warning>
instead of <caution>
. Some criteria by which you might select a suitable level of severity are presented in the ‘Document Conventions’ section of the preface of books produced with Publican's default brand.
<entrytbl>
<glossdiv>
, <glosslist>
<glossdiv>
s that looks like this in English:
Apple
— an apple is…
Grapes
— grapes are…
Orange
— an orange is…
Peach
— a peach is…
Manzana
— la manzana es…
Uva
— la uva es…
Naranja
— la naranja es…
Melocotonero
— el melocotonero es…
<inlinegraphic>
<inlinegraphic>
is not valid in DocBook version 5.
<link>
<link>
tag provides a general-purpose hyperlink and therefore offers nothing that the <xref>
and <ulink>
tags do not, for internal and external hyperlinks respectively. The <link>
tag is disallowed due to its redundancy.
<olink>
<olink>
tag provides cross-references between XML documents. For <olink>
s to work outside of documents that are all hosted within the same library of XML files, you must provide a URL for the document to which you are linking. In environments that use <olink>
s, these URLs can be supplied either as an XML entity or with a server-side script. Publican produces documents intended for wide dissemination in which URLs are always necessary for cross-references. Therefore, the <olink>
tag offers no advantage over the <ulink>
tag, and is disallowed due to its redundancy.