[jira] [Commented] (METRON-697) [site-book] doxia-markdown plugin doesn't generate named anchors for H1 headings

["Matt Foley (JIRA)" <ji...@apache.org>]

    [ 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)