> On Feb 7, 2020, at 2:47 PM, David Jencks <[email protected]> wrote: > > That’s great info and good points! > > To build a site with Antora you basically need to be able to write a little > yaml :-)
Famous last words :) > Lets see how far I get with a bit of effort. Is there a way to find all the > source for the live CMS (and nothing that’s been replaced)? This is now the bulk of what would have to be replaced: - https://github.com/apache/tomee-site-generator The main entry point is here: - https://github.com/apache/tomee-site-generator/blob/master/src/main/java/org/apache/tomee/website/JBake.java#L32 The main exit point and integration with the CMS is here: - https://github.com/apache/tomee-site-generator/blob/master/src/main/java/org/apache/tomee/website/SvnPub.java#L87 That will generate HTML and put it here. - https://svn.apache.org/repos/asf/tomee/site/trunk/content/ However, everything that says '.mdtext' is rendered by the CMS and shows up on the internet using our old black and white Twitter bootstrap look and feel. This happens when you go to here and click publish: - https://cms.apache.org/tomee/publish Once that is done there is html generated and sitting an an svn repository somewhere (I can't remember where). Apache will publish sites from git. Ultimately, we need to get to a place where we're doing either Jbake->HTML->Git or Antora->HTML->Git. No SVN or CMS. Almost all of the '.mdtext' files have been committed here: - https://github.com/apache/tomee-site-generator/tree/master/src/main/jbake/content - https://github.com/apache/tomee-site-generator/blob/master/src/main/jbake/content/comparison.md That page doesn't render by JBake as it's missing the appropriate JBake header, so this CMS page still lives: - https://svn.apache.org/repos/asf/tomee/site/trunk/content/comparison.mdtext Among the complexities is the fact that we're pulling documentation from a few repositories: - https://github.com/apache/tomee-site-generator/blob/master/src/main/java/org/apache/tomee/website/Configuration.java#L20 We collapse all the source code down to one directory so we can generate one big javadoc tree: - https://github.com/apache/tomee-site-generator/blob/master/src/main/java/org/apache/tomee/website/Javadocs.java#L54 - https://github.com/apache/tomee-site-generator/blob/master/src/main/java/org/apache/tomee/website/Javadocs.java#L144 There's code to attempt to get a list of contributors, including their pictures: - https://github.com/apache/tomee-site-generator/blob/master/src/main/java/org/apache/tomee/website/Contributors.java#L47 - http://tomee.apache.org/community/contributors.html That code really needs to be replaced with something that pulls that data from Github because the list of contributors is way way higher: - https://github.com/apache/tomee/graphs/contributors Anyway, at least some pointers. Not entirely sure I answered the question. -David
