我尝试了很多解决方案,但没有一个能满足我的需求。执行 pre + @code(或@literal)标签通常会起作用:
<pre>
{@literal
<configFiles>
<configFile>
<type>LOGICAL_INDEX_CONFIG</type>
</configFile>
</configFiles>}
</pre>
问题是,如果你的 html 中有 ${dollar_sign_variables} 怎么办?(如果您的文档使用依赖于 Maven 过滤的 xml 示例,这很常见)。假设你有 ${ITEM_INDEX_TO_LOGICAL},Eclipse 会像这样渲染它:
<configFiles>
<configFile>
ITEM_INDEX_TO_LOGICAL
}
最终,我别无选择,只能坚持使用 html-escaping 方法(你可以使用这个)来让它正确渲染:
这:
<configFiles>
<configFile>
<type>${ITEM_INDEX_TO_LOGICAL}</type>
</configFile>
</configFiles>
像这样渲染:
</configFiles>
<configFile>
<type>${ITEM_INDEX_TO_LOGICAL}</type>
</configFile>
</configFiles>
不幸的是,这将使您无法真正理解正在记录的“示例 xml”,除非您呈现 Javadoc。幸运的是,eclipse 可以即时为您执行此操作...