jackrabbit-oak-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Marcel Reutegger (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (OAK-7615) Speed up site generation
Date Mon, 09 Jul 2018 07:51:00 GMT

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

Mime
View raw message