如何在DITA front-matter中添加parts-catalog地图链接而非嵌入子分类？

1. 实现仅添加parts-catalog链接而非展开子项 #

DITA-OT默认会解析引用的子地图并展开其所有内容，要实现仅生成指向该地图的链接，可通过以下配置实现：

• 使用<topicref>的processing-role="resource-only"属性，配合format="ditamap"声明引用类型：

  <topicref href="parts-catalog.ditamap" format="ditamap" processing-role="resource-only"/>
  

  该属性会告知DITA-OT将目标地图作为静态资源引用，不展开其内部的子分类内容，仅输出跳转链接。
• 若需要自定义链接显示名称，可添加navtitle属性：

  <topicref href="parts-catalog.ditamap" format="ditamap" processing-role="resource-only" navtitle="零件目录"/>
  

2. 最佳实践：采用单地图构建策略 #

你提到的双地图合并并非最佳实践是正确的。标准DITA文档构建推荐使用单一根地图统一组织所有内容，这样能更好地控制导航结构、内容上下文关联及输出一致性。调整后的典型结构如下：

<map>
  <title>产品文档根地图</title>
  <!-- 前置内容 -->
  <topicref href="front-matter/about.dita" navtitle="关于我们"/>
  <topicref href="front-matter/contact-us.dita" navtitle="联系我们"/>
  <!-- 零件目录模块 -->
  <topicref href="parts-catalog/parts-index.dita" navtitle="零件目录">
    <topicref href="parts-catalog/cat-1.dita" navtitle="分类1"/>
    <topicref href="parts-catalog/cat-2.dita" navtitle="分类2"/>
    <topicref href="parts-catalog/cat-3.dita" navtitle="分类3"/>
  </topicref>
</map>

也可保留子地图的独立文件，通过根地图直接引用，避免内容重复维护：

<map>
  <title>产品文档根地图</title>
  <topicref href="front-matter/about.dita" navtitle="关于我们"/>
  <topicref href="front-matter/contact-us.dita" navtitle="联系我们"/>
  <topicref href="parts-catalog.ditamap" format="ditamap"/>
</map>

内容的提问来源于stack exchange，提问作者ianmayo