Thanks for the pointers! David
> On Feb 7, 2020, at 1:26 AM, Daniel Dias Dos Santos > <daniel.dias.analist...@gmail.com> wrote: > > Hello David, > > fantastic your experiment. : ) > > the translation are in the examples folder: > > https://github.com/apache/tomee/tree/master/examples > > and about the site of documentation is in address : > > https://tomee.apache.org/docs.html > > : ) > -- > > *Daniel Dias dos Santos* > Java Developer > SouJava & JCP Member > GitHub: https://github.com/Daniel-Dos > Linkedin: www.linkedin.com/in/danieldiasjava > Twitter: http://twitter.com/danieldiasjava > > > Em sex., 7 de fev. de 2020 às 01:14, David Jencks <david.a.jen...@gmail.com> > escreveu: > >> After building myself a couple of tiny websites using Antora ( >> https://antora.org) I’ve become somewhat interested in site generation >> from asciidoc. >> >> I looked at the current TomEE documentation site and am not entirely >> thrilled with the appearance. >> >> I spent a couple of hours finding things, arranging the docs into an >> antora structure, and setting up some configuration. >> >> You can see the results here: >> >> https://tomee-preview.s3-us-west-2.amazonaws.com/index.html < >> https://tomee-preview.s3-us-west-2.amazonaws.com/index.html> >> >> The source for this is at https://github.com/djencks/tomee, antora branch. >> >> This makes no attempt to be a reasonable structure: I just found >> documentation.adoc, converted it to an Antora nav file, and picked >> docs.adoc for the home page. >> >> Does this seem like a direction worth pursuing? I’m willing to spend a >> few days organizing stuff better, fixing the warnings and errors, and >> sprucing up the UI (I can change colors and remove the irrelevant stuff >> from the header, but advanced css is beyond me at this point). >> >> There are also a couple of directions of experimentation I might like to >> pursue: >> >> — Antora doesn’t have a good strategy for multi-language sites. Since >> there’s at least some translation going on here, this seems like a good >> place to try out solutions. I haven’t found the translations yet :-) >> Provisionally my first idea would be to represent languages as versions: >> 8.0 is english, 8.0-sp, 8.0-pt, 8.0-ru etc are the other languages. You >> could pick your language in the lower left component-version selector (on >> the preview only tomee/8.0 is present) >> >> - I think there might be some javadoc somewhere :-) Antora also doesn’t >> have a good strategy for including externally generated content. I have an >> idea around this that just might work :-) >> >> On my GitHub clone I only see a master branch, which I assume is the tomee >> 8 line. Where are the earlier versions? Where is their documentation? >> Antora is really good at building sites with many versions of the docs (as >> long as the source is in asciidoc). >> >> thanks >> David Jencks >> >> ps. My google search for the docs brought up this: >> >> https://tomee.apache.org/latest/docs/documentation.html >> >> which doesn’t look good. >> >> >>
