能否在conref调用行添加注释用于脚注？如何为conref引用列表项加星号？

算力阿峰

2026-6-12

解决DITA中conref引用列表项无法显示星号的问题

你遇到的情况是：通过conref复用列表项时，直接在<data>标签里写的*无法被识别显示，但<note>里用字符实体*能正常显示。可以试试这几种解决方式：

把星号放到被引用的源主题中
直接在common_documentation_reuseTopics.dita里的bluetooth5.0、bluetoothNLC目标元素前添加*，这样通过conref引用过来的内容会自带星号，不用在调用端额外添加。比如源主题里写成：
```
<ph id="bluetooth5.0">* 蓝牙5.0相关内容</ph>
```

使用字符实体替代直接写星号
和<note>里的写法一致，把<data>标签里的*换成字符实体*，避免DITA解析器把*当成格式标记过滤。修改后的代码：

<body id="certificationsBody">
    <ul>
        <li><data conref="../common_topics/common_documentation_reuseTopics.dita#bluetooth5.0" outputclass="-dita-use-conref-target">&#42;</data></li>
        <li><data conref="../common_topics/common_documentation_reuseTopics.dita#bluetoothNLC" outputclass="-dita-use-conref-target">&#42;&#42;</data></li>
    </ul>
    <note>&#xA; &#42; -CB mwConnect Casambi &#xA; &#42; &#42; -SR TruBlu</note>
</body>

通过CSS样式生成星号
如果星号是装饰性的，不想修改内容，可以给<li>添加自定义outputclass，然后用CSS自动生成星号：
1. 修改列表项的outputclass：
```
<li outputclass="star-item"><data conref="..." outputclass="-dita-use-conref-target"></data></li>
```
2. 添加CSS规则：
```
li.star-item::before {
  content: "* ";
  margin-right: 4px;
}
```
  这种方式不用在内容里写星号，由样式控制显示，更灵活。
用<ph>标签包裹星号
在<data>标签里用<ph>标签包裹星号，确保字符被正确保留——有些DITA处理器对直接的文本节点处理会有差异，用<ph>标签更稳妥：
```
<li><data conref="..." outputclass="-dita-use-conref-target"><ph>*</ph></data></li>
```