A BlockId is a single line block element containing a unique identifier enclosed in double square brackets. It is used to assign an identifier to the ensuing block element. For example:
[[chapter-titles]] Chapter titles can be ...
The preceding example identifies the ensuing paragraph so it can be
referenced from other locations, for example with
<<chapter-titles,chapter titles>>
.
BlockId elements can be applied to Title, Paragraph, List,
DelimitedBlock, Table and BlockMacro elements. The BlockId element
sets the {id}
attribute for substitution in the subsequent block’s
markup template. If a second positional argument is supplied it sets
the {reftext}
attribute which is used to set the DocBook xreflabel
attribute.
The BlockId element has the same syntax and serves the same function to the anchor inline macro.