The <linklist> element defines an author-arranged group of links. Within <linklist>, the organization of links on final output is in the same order as originally authored in the DITA topic.

There are two ways to organize related information links: add them all in no particular order, using the <linkpool> or <related-links> elements, and let the output formatting processor sort them; or pre-group them using one or more <linklist> elements. When you pre-group them using <linklist>, then the order of the links as you created them is preserved during the output formatting process.

Attributes set on <linklist> are inherited by its descendants. For example, if you've got a <linklist> that contains all external links, you can set scope="external" on that outer<linklist> element and leave it off the contained links.


Doctype Content model
ditabase, topic, task, reference, concept, glossary ( ( title) (optional) then ( desc) (optional) then ( linklist or link) (any number) then ( linkinfo) (optional) )

Contained by

Doctype Parents
ditabase, topic, task, concept, reference, glossary related-links, linklist


- topic/linklist

Return to main page.

OASIS DITA Version 1.1 Language Specification -- OASIS Standard, 1 August 2007
Copyright © OASIS Open 2005, 2007. All Rights Reserved.