DITA-OT 4.1：创建含概念缩略版FAQ板块的技术问题咨询
2026-7-17
DITA-OT 4.1 搭建带FAQ板块网站的方案困境
我正在用DITA-OT 4.1开发一个包含FAQ板块的网站，网站需要介绍12个核心概念：FAQ板块展示每个概念的缩略版内容，同时每个缩略版要链接到对应概念的完整内容页面。尝试了多种实现方法，但都没达到预期效果，具体方法及面临的挑战如下：
| 方法 | 说明 | 挑战 |
|---|---|---|
<abstract>元素 | 在单个DITA主题文件中为每个概念编写摘要，再创建FAQ文件通过<conref>引用这12个概念的摘要部分 | 转换输出时，这些摘要会被自动包含在对应概念的完整内容页面中，不符合仅在FAQ页面展示的需求。虽然可以通过CSS或自定义插件排除摘要，但会增加流程复杂度 |
@audience属性 | 将短版（FAQ用）和长版内容按受众分类，通过两个独立项目配置文件（YAML/XML）搭配不同ditaval过滤器生成两种内容版本 | 这种方式是项目级的全局分类，会生成两个独立网站，而非在同一个网站的FAQ板块精准展示缩略版内容。且ditamap中没有等效的局部内容过滤方式† |
| 主题/映射替代版本 | 为每个概念创建单独的短版主题文件，或在DITA映射中用<topicmeta>元素替换主题内容/摘要 | 需要维护短版和长版两份内容，容易出现更新不同步的情况，增加了内容一致性维护的风险 |
† 注：topicref有audience属性，topicmeta有audience元素，但二者都不具备局部过滤功能，仅适用于项目级配置的过滤器场景。
内容的提问来源于stack exchange，提问作者Tank
相关产品推荐
相关产品推荐
