[
https://issues.apache.org/jira/browse/METRON-697?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15854536#comment-15854536
]
Matt Foley commented on METRON-697:
-----------------------------------
Correct solution was to add a preceding blank line and the anchor line just
*before* all H1 headers *except* the first one.
For the first one (the title header), it is necessary to put the anchor line
and a following blank line just *after* the title header, otherwise the titling
(at the html document metadata level) gets broken.
> [site-book] doxia-markdown plugin doesn't generate named anchors for H1
> headings
> --------------------------------------------------------------------------------
>
> Key: METRON-697
> URL: https://issues.apache.org/jira/browse/METRON-697
> Project: Metron
> Issue Type: Sub-task
> Affects Versions: 0.3.1
> Reporter: Matt Foley
> Assignee: Matt Foley
> Fix For: 0.3.1
>
>
> It may be possible to work around this deficiency in the doxia-markdown
> plugin by writing-in an explicit anchor just before the header line, during
> the re-write phase.
> Otherwise we should edit the source .md files to remove usages where (a) H1
> headers are used in the *body* of the document, not just at the top, AND (b)
> there are TOC or other internal links to those headers. The logical way to
> remove these usages is to reduce the headers to H2 (which do get properly
> anchored).
--
This message was sent by Atlassian JIRA
(v6.3.15#6346)
