How to add local HTML anchors for sections with Doxia?

Question

In a Maven site doc I use code like this for sections:

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

How do I tell Doxia I want the section name/title to be an HTML local anchor? http://maven.apache.org/doxia/references/doxia-apt.html#Anchors does talk about this but I've been unable to apply it to <section>s.

I have the same question for the apt style. – jan Apr 03 '14 at 10:12 — jan, Apr 03 '14 at 10:12

score 0 · Accepted Answer · answered Apr 03 '14 at 14:01

I still don't know how to do it "properly". However, there's a pretty simple and painless workaround; use the id attribute:

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

id ends up in the HTML markup as-is. Most browsers nowadays support using ids as anchors: http://server/page.html#hibernate-statistics

1 Answers1