I now have the adoc content from master, 7.1.0.x, 7.0.0.x, the example README.adoc from master (sorted by language), and the formerly .md files from tomee-site-generator.
The preview is still at https://tomee-preview.s3-us-west-2.amazonaws.com/index.html <https://tomee-preview.s3-us-west-2.amazonaws.com/index.html>. The other urls have changed slightly (Tomee => tomee). I think there are still 133 pages on the existing website that I haven’t located source for. If anyone has an idea where they might come from please let me know: add-my-offering.html http://tomee.apache.org/add-my-offering.html apache-openejb-3.1.3.html http://tomee.apache.org/download/apache-openejb-3.1.3.html apache-openejb-3.1.4.html http://tomee.apache.org/download/apache-openejb-3.1.4.html blogs.html http://tomee.apache.org/blogs.html buildbot.html http://tomee.apache.org/examples/buildbot.html contact.html http://tomee.apache.org/misc/contact.html ejb-+-jpa-+-jsf-+-jax-rs.html http://tomee.apache.org/ejb-+-jpa-+-jsf-+-jax-rs.html ejb-2.1-compatibility-example.html http://tomee.apache.org/ejb-2.1-compatibility-example.html ejb-3-annotation-example.html http://tomee.apache.org/ejb-3-annotation-example.html ejb-3-annotation-examples.html http://tomee.apache.org/ejb-3-annotation-examples.html ejb-3-example.html http://tomee.apache.org/ejb-3-example.html ejb-3-examples.html http://tomee.apache.org/ejb-3-examples.html ejb-3-howto.html http://tomee.apache.org/ejb-3-howto.html ejb-3-sample-applications.html http://tomee.apache.org/ejb-3-sample-applications.html ejb-3-sample.html http://tomee.apache.org/ejb-3-sample.html ejb-3-samples.html http://tomee.apache.org/ejb-3-samples.html ejb-3-tutorial.html http://tomee.apache.org/ejb-3-tutorial.html ejb-3-tutorials.html http://tomee.apache.org/ejb-3-tutorials.html ejb-3.0-specification.html http://tomee.apache.org/ejb-3.0-specification.html ejb-31-annotation-example.html http://tomee.apache.org/ejb-31-annotation-example.html ejb-31-annotation-examples.html http://tomee.apache.org/ejb-31-annotation-examples.html ejb-31-example.html http://tomee.apache.org/ejb-31-example.html ejb-31-examples.html http://tomee.apache.org/ejb-31-examples.html ejb-31-howto.html http://tomee.apache.org/ejb-31-howto.html ejb-31-sample-applications.html http://tomee.apache.org/ejb-31-sample-applications.html ejb-31-sample.html http://tomee.apache.org/ejb-31-sample.html ejb-31-samples.html http://tomee.apache.org/ejb-31-samples.html ejb-31-tutorial.html http://tomee.apache.org/ejb-31-tutorial.html ejb-31-tutorials.html http://tomee.apache.org/ejb-31-tutorials.html ejb-annotation-example.html http://tomee.apache.org/ejb-annotation-example.html ejb-annotation-examples.html http://tomee.apache.org/ejb-annotation-examples.html ejb-example.html http://tomee.apache.org/ejb-example.html ejb-glossary.html http://tomee.apache.org/ejb-glossary.html ejb-howto.html http://tomee.apache.org/ejb-howto.html ejb-sample-applications.html http://tomee.apache.org/ejb-sample-applications.html ejb-sample.html http://tomee.apache.org/ejb-sample.html ejb-samples.html http://tomee.apache.org/ejb-samples.html ejb-servlet.html http://tomee.apache.org/ejb-servlet.html ejb-tutorial.html http://tomee.apache.org/ejb-tutorial.html ejb-tutorials.html http://tomee.apache.org/ejb-tutorials.html ejb3-annotation-example.html http://tomee.apache.org/ejb3-annotation-example.html ejb3-annotation-examples.html http://tomee.apache.org/ejb3-annotation-examples.html ejb3-example.html http://tomee.apache.org/ejb3-example.html ejb3-examples.html http://tomee.apache.org/ejb3-examples.html ejb3-howto.html http://tomee.apache.org/ejb3-howto.html ejb3-sample-applications.html http://tomee.apache.org/ejb3-sample-applications.html ejb3-sample.html http://tomee.apache.org/ejb3-sample.html ejb3-samples.html http://tomee.apache.org/ejb3-samples.html ejb3-tutorial.html http://tomee.apache.org/ejb3-tutorial.html ejb3-tutorials.html http://tomee.apache.org/ejb3-tutorials.html example.html http://tomee.apache.org/example.html examples-table.html http://tomee.apache.org/examples-table.html faq_openejb-jar.html.html http://tomee.apache.org/faq_openejb-jar.html.html getting-started-with-eclipse-and-webby.html http://tomee.apache.org/getting-started-with-eclipse-and-webby.html heritage.html http://tomee.apache.org/misc/heritage.html index-old.html http://tomee.apache.org/examples/index-old.html injection-of-datasource-example.html http://tomee.apache.org/injection-of-datasource-example.html injection-of-entitymanager-example.html http://tomee.apache.org/injection-of-entitymanager-example.html injection-of-env-entry-example.html http://tomee.apache.org/injection-of-env-entry-example.html injection-of-other-ejbs-example.html http://tomee.apache.org/injection-of-other-ejbs-example.html java-ee-6-annotation-example.html http://tomee.apache.org/java-ee-6-annotation-example.html java-ee-6-annotation-examples.html http://tomee.apache.org/java-ee-6-annotation-examples.html java-ee-6-example.html http://tomee.apache.org/java-ee-6-example.html java-ee-6-examples.html http://tomee.apache.org/java-ee-6-examples.html java-ee-6-howto.html http://tomee.apache.org/java-ee-6-howto.html java-ee-6-sample-applications.html http://tomee.apache.org/java-ee-6-sample-applications.html java-ee-6-sample.html http://tomee.apache.org/java-ee-6-sample.html java-ee-6-samples.html http://tomee.apache.org/java-ee-6-samples.html java-ee-6-tutorial.html http://tomee.apache.org/java-ee-6-tutorial.html java-ee-6-tutorials.html http://tomee.apache.org/java-ee-6-tutorials.html java-ee-annotation-example.html http://tomee.apache.org/java-ee-annotation-example.html java-ee-annotation-examples.html http://tomee.apache.org/java-ee-annotation-examples.html java-ee-example.html http://tomee.apache.org/java-ee-example.html java-ee-examples.html http://tomee.apache.org/java-ee-examples.html java-ee-howto.html http://tomee.apache.org/java-ee-howto.html java-ee-sample-applications.html http://tomee.apache.org/java-ee-sample-applications.html java-ee-sample.html http://tomee.apache.org/java-ee-sample.html java-ee-samples.html http://tomee.apache.org/java-ee-samples.html java-ee-tutorial.html http://tomee.apache.org/java-ee-tutorial.html java-ee-tutorials.html http://tomee.apache.org/java-ee-tutorials.html javaee-6-annotation-example.html http://tomee.apache.org/javaee-6-annotation-example.html javaee-6-annotation-examples.html http://tomee.apache.org/javaee-6-annotation-examples.html javaee-6-example.html http://tomee.apache.org/javaee-6-example.html javaee-6-examples.html http://tomee.apache.org/javaee-6-examples.html javaee-6-howto.html http://tomee.apache.org/javaee-6-howto.html javaee-6-sample-applications.html http://tomee.apache.org/javaee-6-sample-applications.html javaee-6-sample.html http://tomee.apache.org/javaee-6-sample.html javaee-6-samples.html http://tomee.apache.org/javaee-6-samples.html javaee-6-tutorial.html http://tomee.apache.org/javaee-6-tutorial.html javaee-6-tutorials.html http://tomee.apache.org/javaee-6-tutorials.html javaee-annotation-example.html http://tomee.apache.org/javaee-annotation-example.html javaee-annotation-examples.html http://tomee.apache.org/javaee-annotation-examples.html javaee-example.html http://tomee.apache.org/javaee-example.html javaee-examples.html http://tomee.apache.org/javaee-examples.html javaee-howto.html http://tomee.apache.org/javaee-howto.html javaee-sample-applications.html http://tomee.apache.org/javaee-sample-applications.html javaee-sample.html http://tomee.apache.org/javaee-sample.html javaee-samples.html http://tomee.apache.org/javaee-samples.html javaee-tutorial.html http://tomee.apache.org/javaee-tutorial.html javaee-tutorials.html http://tomee.apache.org/javaee-tutorials.html javaee6-annotation-example.html http://tomee.apache.org/javaee6-annotation-example.html javaee6-annotation-examples.html http://tomee.apache.org/javaee6-annotation-examples.html javaee6-example.html http://tomee.apache.org/javaee6-example.html javaee6-examples.html http://tomee.apache.org/javaee6-examples.html javaee6-howto.html http://tomee.apache.org/javaee6-howto.html javaee6-sample-applications.html http://tomee.apache.org/javaee6-sample-applications.html javaee6-sample.html http://tomee.apache.org/javaee6-sample.html javaee6-samples.html http://tomee.apache.org/javaee6-samples.html javaee6-tutorial.html http://tomee.apache.org/javaee6-tutorial.html javaee6-tutorials.html http://tomee.apache.org/javaee6-tutorials.html legal.html http://tomee.apache.org/misc/legal.html openejb-0.9.2.html http://tomee.apache.org/download/openejb-0.9.2.html openejb-1.0-beta-1.html http://tomee.apache.org/download/openejb-1.0-beta-1.html openejb-1.0-test-matrix.html http://tomee.apache.org/download/openejb-1.0-test-matrix.html openejb-1.0.html http://tomee.apache.org/download/openejb-1.0.html openejb-3.0-beta-1.html http://tomee.apache.org/download/openejb-3.0-beta-1.html openejb-3.0-beta-2.html http://tomee.apache.org/download/openejb-3.0-beta-2.html openejb-3.0.html http://tomee.apache.org/download/openejb-3.0.html openejb-3.1.1.html http://tomee.apache.org/download/openejb-3.1.1.html openejb-3.1.2.html http://tomee.apache.org/download/openejb-3.1.2.html openejb-3.1.html http://tomee.apache.org/download/openejb-3.1.html project_info.html http://tomee.apache.org/index.page/project_info.html simple-stateful-example.html http://tomee.apache.org/simple-stateful-example.html simple-stateless-example.html http://tomee.apache.org/simple-stateless-example.html singleton-example.html http://tomee.apache.org/singleton-example.html testcase-with-testbean-inner-class.html http://tomee.apache.org/testcase-with-testbean-inner-class.html testing-security-example.html http://tomee.apache.org/testing-security-example.html testing-transactions-example.html http://tomee.apache.org/testing-transactions-example.html tomee-1.5.3-snapshot.html http://tomee.apache.org/download/tomee-1.5.3-snapshot.html tomee-1.6.0-snapshot.html http://tomee.apache.org/download/tomee-1.6.0-snapshot.html tomee-1.7.x-snapshot.html http://tomee.apache.org/download/tomee-1.7.x-snapshot.html tomee-7.0.0-snapshot.html http://tomee.apache.org/download/tomee-7.0.0-snapshot.html whoweare.html http://tomee.apache.org/misc/whoweare.html I looked in tomee-site-generator master, tomee-master, tomee-7.1.0.x, tomee-7.0.0.x, tomee-1.7.x, and something that might be tomee-1.6.0 although it says it’s a detached head (see other email tonight). I looked for any file with the stem of the html files. Thanks, David Jencks > On Feb 7, 2020, at 11:39 PM, David Jencks <david.a.jen...@gmail.com> wrote: > > > >> On Feb 7, 2020, at 3:50 PM, David Blevins <dblev...@tomitribe.com> wrote: >> >>> On Feb 7, 2020, at 2:47 PM, David Jencks <david.a.jen...@gmail.com> 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 >> >
