You are viewing a plain text version of this content. The canonical link for it is here.

Posted to oak-issues@jackrabbit.apache.org by "Marcel Reutegger (JIRA)" <ji...@apache.org> on 2018/07/09 07:51:00 UTC

[jira] [Commented] (OAK-7615) Speed up site generation

    [ https://issues.apache.org/jira/browse/OAK-7615?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16536630#comment-16536630 ] 

Marcel Reutegger commented on OAK-7615:
---------------------------------------

The maven site plugin moved to flexmark-java, which is also mentioned as a replacement on the pegdown github page. The site-plugin version configured in oak-parent uses flexmark-java by default, but oak-parent downgrades the doxia-module-markdown to 1.7, which still uses pegdown.

> Speed up site generation
> ------------------------
>
>                 Key: OAK-7615
>                 URL: https://issues.apache.org/jira/browse/OAK-7615
>             Project: Jackrabbit Oak
>          Issue Type: Improvement
>          Components: doc
>            Reporter: Marcel Reutegger
>            Assignee: Marcel Reutegger
>            Priority: Minor
>             Fix For: 1.10
>
>
> Generating the documentation site is rather slow because oak-doc currently uses a parser that is not maintained anymore. See: https://github.com/sirthias/pegdown/
> The deprecation note also mentions performance issues. My experience shows, the parser has difficulties with underscores in words. E.g. {{DOCUMENT_NS_BGW_NUM_WRITE_RATE}} is a name for a metric I wanted to document. Parsing time seems to increase exponentially the more such names appear in a markdown file.



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)