Hi - I have experience with both jBake and Pelican ASF. (This is the replacement for the Apache CMS. I contributed heavily to it.)
jBaked sites are incubator.apache.org <http://incubator.apache.org/> (including several Anakia legacy parts. It’s complicated.) and openoffice.org <http://openoffice.org/> (twice baked as jBake can only handle a maximum of 16384 files.) Pelican ASF - www.apache.org <http://www.apache.org/>, httpd.apache.org <http://httpd.apache.org/>, openoffice.apache.org <http://openoffice.apache.org/>, petri.apache.org <http://petri.apache.org/>, flex.apache.org <http://flex.apache.org/>, olingo.apache.org <http://olingo.apache.org/>, openjpa.apache.org <http://openjpa.apache.org/>, …. I think for POI there are two matters to consider. (1) API Docs are what is generated by the build and many sites merely copy these apidocs into a folder. The doxia/jBake question is somewhat irrelevant. In the case of OpenJPA they are actually configured now to handle these in a different site branch and they get deployed only as they change with a release. (2) The poi website in the old xml style. As much as this is pretty straightforward xml then it can be converted to any of Markdown, Asciidoctor, or RST. Personally I would be willing to put some time into a reorganized web template based on the look in openoffice.apache.org <http://openoffice.apache.org/> and template.staged.apache.org <http://template.staged.apache.org/>. I converted openoffice.a.o to a top navigation bar from left nav just last week. See GitHub.com/apache/openoffice-project/. I would be willing to put effort into a Pelican ASF version of the POI website which could include APIDocs from releases. Meanwhile others can focus on generating apidocs with Gradle. And I guess that means the same approach for XMLBeans. All the best, Dave > On Jul 9, 2021, at 2:31 PM, Andreas Beeker <[email protected]> wrote: > > Here are two further links as Doxia might be difficult to be invoked from > gradle: > > Netbeans seemed to prefer JBake: > https://cwiki.apache.org/confluence/display/NETBEANS/Static+Site+Generator+Tools+For+New+Web+Site > > Static Site Generators (SSG): > https://jamstack.org/generators/ > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] >
