www-infrastructure-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Joe Schaefer (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (INFRA-9705) Remove elementid Markdown extension
Date Wed, 01 Jul 2015 13:43:05 GMT

    [ https://issues.apache.org/jira/browse/INFRA-9705?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14610257#comment-14610257

Joe Schaefer commented on INFRA-9705:

You will also need to fix the sitemap generation code in ASF/View.pm and all the anchor tags
in subject headings throughout the site because the regexp View.pm uses to process anchors
is tied to the mdx_elementid.py syntax.

This change should also be communicated to all projects as well as on the /dev/cmsref webpage
for obvious reasons.

> Remove elementid Markdown extension
> -----------------------------------
>                 Key: INFRA-9705
>                 URL: https://issues.apache.org/jira/browse/INFRA-9705
>             Project: Infrastructure
>          Issue Type: Bug
>          Components: CMS, Website
>         Environment: https://svn.apache.org/repos/infra/websites/cms/build/mdx_elementid.py
> https://svn.apache.org/repos/infra/websites/cms/build/markdownd.py
>            Reporter: Sebb
>         Attachments: INFRA-9705.patch
> The elementid Markdown extension appears to have been originally intended to handle Special
Attributes as per PHP Markdown Extras [1]. However it was not a complete implementation.
> The elementid extension code was later extended to try to handle permalinks as per Subversion
[2]. However it turned out that this code interfered with TOC processing.
> It would of course be possible to fix both of these issues, however there seems little
point as the Python Markdown module includes atttribute lists [3] as well as permalinks [4].
> I think it therefore makes sense to disable elementid by removing it from markdownd.py:EXTENSIONS.
> Attribute lists and permalinks can then be enabled separately; see related JIRAs.
> [1] https://michelf.ca/projects/php-markdown/extra/#spe-attr
> [2] http://subversion.apache.org/style/site.css
> [3] https://pythonhosted.org/Markdown/extensions/attr_list.html
> [4] https://pythonhosted.org/Markdown/extensions/toc.html#usage

This message was sent by Atlassian JIRA

View raw message