如何为 Doxia 的部分添加本地 HTML 锚？

【问题标题】：How to add local HTML anchors for sections with Doxia?如何为 Doxia 的部分添加本地 HTML 锚？
【发布时间】：2013-01-07 12:18:30
【问题描述】：

在一个 Maven 站点文档中，我将这样的代码用于部分：

<section name="Hibernate statistics">
  Foo
</section>

如何告诉 Doxia 我希望部分名称/标题成为 HTML 本地锚点？ http://maven.apache.org/doxia/references/doxia-apt.html#Anchors 确实谈到了这一点，但我无法将其应用于 <section>s。

【问题讨论】：

【解决方案1】：

我仍然不知道如何“正确”地做到这一点。但是，有一个非常简单且无痛的解决方法；使用id 属性：

<section name="Hibernate statistics" id="hibernate-statistics">
  Foo
</section>

id 按原样在 HTML 标记中结束。现在大多数浏览器都支持使用ids 作为锚点：http://server/page.html#hibernate-statistics

【讨论】：