Chapter 13. BlockId Element

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.