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 <[email protected]> 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. > > >
