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

Uwe Schindler commented on LUCENE-9321:
---------------------------------------

bq. In 2020 we could have some modern template engine framework instead of XSL, 
will try to look for it, but have no strong opinion about replacing it.

My idea would be to create the index.html as an intermediate markdown and then 
also pass it through the markdown macro. That's easier than XSL! Templating is 
not really needed. The main part is only iterating over all modules and create 
a link for each of those. That's much easier with a groovy multi-line-string 
and a loop over all gradle projects. The resulting markdown can be passed to 
flexmark and written as HTML to disk.

Final note: IMHO, the other text files should all be renamed to {{*.txt => 
*.md}}, because e.g. MIGRATE.txt is buggy at the moment, as not all of it is 
looking fine as markdown. When its named .md, everybody would see that it's not 
just a txt file.

> 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

Reply via email to