[jira] [Updated] (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:all-tabpanel ]

Matt Foley updated METRON-697:
------------------------------
    Description: 
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).

  was: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.


> [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: Bug
>    Affects Versions: 0.3.1
>            Reporter: Matt Foley
>
> 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)