Transclusion 004

Table of Contents

In this document, all transcluded IDs are resolved with the ‘suffix’ fixup and ‘local’ linkscope.

In a document where the same fragment is included (for example, with XInclude) more than once, any ID values in that fragment will be duplicated in the resulting document. Duplicate IDs should be avoided.

The DocBook Transclusion specification is intended to address this problem by providing “fixup” mechanisms.

In this document, we use the following caution element as an example:

⚠
Transclusion Example Caution

This caution has the xml:id value ‘caution’. If it is simple transcluded more than once into a document, it will introduce duplicate IDs in the document.

Here it is repeated:

⚠
Transclusion Example Caution

This caution has the xml:id value ‘caution’. If it is simple transcluded more than once into a document, it will introduce duplicate IDs in the document.

1. Subsection One

Here it is repeated in a subsection:

⚠
Transclusion Example Caution

This caution has the xml:id value ‘caution’. If it is simple transcluded more than once into a document, it will introduce duplicate IDs in the document.

2. Subsection Two

Here it is repeated in another subsection:

⚠
Transclusion Example Caution

This caution has the xml:id value ‘caution’. If it is simple transcluded more than once into a document, it will introduce duplicate IDs in the document.