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 08:38:00 GMT

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

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

Removed the 1.7 dependency to doxia-module-markdown in the site plugin in oak-parent/pom.xml.
This means the site plugin now uses flexmark-java for markdown parsing. I had to slightly
change one markdown file because the parser does not like malformed inline html. Otherwise
the generated site looks fine AFAICS.

Generating the site in oak-doc dropped from 28 to 5.5 seconds on my machine.

Done in trunk: http://svn.apache.org/r1835385

> 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, 1.9.6
>
>
> 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