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