> On Feb 7, 2020, at 3:50 PM, David Blevins <[email protected]> wrote:
>
>> 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 :)
Indeed!
>
>> 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)?
Perhaps there are better tools now…. I ran kramdown-asciidoc on the .md files
in tomee-site-generator, moved them into antora structure, came up with a nav
file that just lists them alphabetically, and now they are another component in
the preview. They still need a little sed-based TLC and perhaps even human
editing, but they mostly look OK (with a few problems).
Several pages look like someone had a great idea and stopped after writing the
title… e.g. azure.adoc. I’m not sure what to do with those.
I haven’t identified the existing navigation to these pages, and I don’t
understand yet how it relates to the already-adoc content.
I think my next steps are to clean up the adoc and start to understand the
desired organization.
In terms of organization, the existing docs look like there are versions for
each 7+ tomee version but I’ve only found the git master branch with I presume
the latest.
Anyway, the preview now shows a little bit how Antora can show different
versions, although in this case I’m abusing the feature because the content is
completely different.
Hints welcome!
David Jencks
>
> 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
>
