与DITA的关系

Question

我试图在概念文档的选择之间建立一种关系。因此，鉴于三个文件"A“、"B”和"C“，我希望它们各自显示如下所示：

一个..。 相关概念

• B
• C

由于某些原因，以下内容无法工作：

<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>

以下工作，但这肯定是不正确的：

<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>

我正在使用XMLMind提供的开源XMLMind。

Answer 1

实际上，这似乎是XML Mind对DITA转换器工具的一个不幸的限制：

生成链路 属性集合类型，无论其值如何，都会在reltable元素中被忽略。

参考文献：武装部队/医生/手册/限制区

Answer 2

您可以阅读有关reltables的DITA 1.2规范：

http://docs.oasis-open.org/dita/v1.2/os/spec/langref/reltable.html#reltable

规范还包含一个示例。说明书上写着：

在输出时，应将链接添加到同一行但不在同一单元格中的主题。

因此，您的主题需要位于不同的单元格和同一行中。

Answer 3

请注意，DITA Open没有规定的限制，您的第一个代码可以正常工作。

但是，您可以在关系表的上下文之外使用@collection-type属性。即使在DITA转换器工具支持DITA规范的范围内，这也应该有效。

您没有说明您的可交付产品是联机帮助主题还是PDF。如果要生成帮助主题，可以将此代码包括在导航地图中：

<topicgroup collection-type="family" toc="no">
    <topicref href="topics/a.dita" type="concept"/>
    <topicref href="topics/b.dita" type="concept"/>
    <topicref href="topics/c.dita" type="concept"/>
</topicgroup>

结果将创建主题之间的链接，但导航中不会列出主题的新实例。

当然，如果这三个主题已经是导航中父节点的唯一子主题，那么只需将@collection-type属性添加到父节点。