[
https://issues.apache.org/jira/browse/LUCENE-9321?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17089360#comment-17089360
]
Uwe Schindler edited comment on LUCENE-9321 at 4/22/20, 7:06 AM:
-----------------------------------------------------------------
bq. the stuff that confused me here were the ant magics to extract the
parameters that are passed to <xslt> from the codebase,
I'd echo the variables before they are passed to {{<xslt>}}.
bq. and <markdown> macro.
The gist of that is in the goovy file and can be mostly copy-pasted
({{install-markdown-filter.groovy}}). It's just wrapped with some Ant-like
Filter reader, so it can be hooked into the Ant {{<copy>}} task. If you take
the inner part, you can read the TXT file to a UTF-8 string, apply the flexmark
transformation. All you need is the {{String filter(String)}} method from that
file. And of course the build depenedencies for flexmark.
The converter also does a regex replace of the input text file to create
markdown links of issue references, after that its passed to the filter
described before:
{code:xml}
<replaceregex pattern="\b(LUCENE|SOLR)\-\d+\b"
replace="[\0](https://issues.apache.org/jira/browse/\0)" flags="gs"/>
{code}
was (Author: thetaphi):
bq. the stuff that confused me here were the ant magics to extract the
parameters that are passed to <xslt> from the codebase,
I'd echo the variables before they are passed to {{<xslt>}}.
bq. and <markdown> macro.
The gist of that is in the goovy file and can be mostly copy-pasted
({{install-markdown-filter.groovy}}). It's just wrapped with some Ant-like
Filter reader, so it can be hooked into the Ant {{<copy>}} task. If you take
the inner part, you can read the TXT file to a UTF-8 string, apply the flexmark
transformation. All you need is the {{String filter(String)}} method from that
file. And of course the build depenedencies for flexmark.
The converter also does a regex replace of the input text file to create
markdown links of issue references, after that its passed to the filter
described before:
{code:xml}
<replaceregex pattern="\b(LUCENE|SOLR)\-\d+\b"
replace="[\0](https://issues.apache.org/jira/browse/\0)" flags="gs"/>
{code}
{code:groovy}
{code}
> Port documentation task to gradle
> ---------------------------------
>
> Key: LUCENE-9321
> URL: https://issues.apache.org/jira/browse/LUCENE-9321
> Project: Lucene - Core
> Issue Type: Sub-task
> Components: general/build
> Reporter: Tomoko Uchida
> Assignee: Tomoko Uchida
> Priority: Major
>
> This is a placeholder issue for porting ant "documentation" task to gradle.
> The generated documents should be able to be published on lucene.apache.org
> web site on "as-is" basis.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@lucene.apache.org
For additional commands, e-mail: issues-h...@lucene.apache.org
