Как добавить локальные HTML-якоря для разделов с Doxia?

Question

В документации сайта Maven я использую такой код для разделов:

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

Как мне сообщить Doxia, что я хочу, чтобы имя / заголовок раздела был локальным якорем HTML? http://maven.apache.org/doxia/references/doxia-apt.html действительно говорит об этом, но я не смог применить его к <section>s.

Answer 1

Я до сих пор не знаю, как это сделать "правильно". Тем не менее, есть довольно простой и безболезненный обходной путь; использовать id атрибут:

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

id заканчивается в разметке HTML как есть. Большинство браузеров в настоящее время поддерживают использование ids как якоря: http://server/page.html#hibernate-statistics