Search code examples
xmldocumentationdita

Relationships with DITA

I am trying to create a relationship between a selection of concept documents. So given three documents "A", "B" and "C" I would like them to each display something like the following:

A ...

Related Concepts

  • B
  • C

For some reason the following fails to work:

<reltable>
    <relrow>
        <relcell>
            <topicgroup collection-type="family">
                <topicref href="topics/a.dita" type="concept"/>
                <topicref href="topics/b.dita" type="concept"/>
                <topicref href="topics/c.dita" type="concept"/>
            </topicgroup>
        </relcell>
    </relrow>
</reltable>

The following works, but this surely cannot be correct:

<reltable>
    <relrow>
        <relcell>
            <topicgroup collection-type="family">
                <topicref href="topics/a.dita" type="concept"/>
                <topicref href="topics/b.dita" type="concept"/>
                <topicref href="topics/c.dita" type="concept"/>
            </topicgroup>
        </relcell>
        <relcell>
            <topicgroup collection-type="family">
                <topicref href="topics/a.dita" type="concept"/>
                <topicref href="topics/b.dita" type="concept"/>
                <topicref href="topics/c.dita" type="concept"/>
            </topicgroup>
        </relcell>
    </relrow>
</reltable>

I am using the open-source DITA Converter by XMLMind.

Solution

  • It seems that this is in fact an unfortunate limitation of the DITA Converter tool by XML Mind:

    Generating links

    Attribute collection-type, whatever its value, is ignored inside the reltable element.

    Ref: http://www.xmlmind.com/ditac/_distrib/doc/manual/limitations.html