Is there a plan for multilingual?

[laliwa]

Since the tutorial is a great help for developers from different countries using different languages, is there a plan to make it multilingual? There are some things to do in order to fulfill this: 1\ How to contribute translated docs in https://github.com/jakartaee/jakartaee-tutorial, different directory in src/main/ or same directory but a file in translated version beside the English one, just Hugo did with .zh.md. 2\ how to build in https://github.com/jakartaee/jakartaee-documentation-ui/ , with a unified playbook or different playbook 3\ What do we need to do with https://github.com/jakartaee/jakartaee-documentation-ui/ to show, for example, a button switch language somewhere on the https://jakarta.ee/learn/docs/jakartaee-tutorial/current/index.html

[jhammen]

I'm interested in helping out with this. I understand Antora does not support multilingual support but here is a recent zulip thread talking about it:

https://antora.zulipchat.com/#narrow/stream/282400-users/topic/.E2.9C.94.20Multi-lingual.20support/near/385362356

seems like it's something they would like to support out of the box in the future, right now you have to make your own strategy to run parallel sites but there exists a demo showing one approach using po4a:

https://antora.zulipchat.com/#narrow/stream/282400-users/topic/Antora.20collector.20extension.20with.20po4a/near/304528973

here is the demo site:

https://antora-ui-custom.gitlab.io/antora-i18n/antora-i18n/en/

[kito99]

@laliwa great idea. I feel like we should improve the content more first, but maybe that's not really necessary. Any suggestions on which languages to support? I know the Chinese community has been growing, so that's a good option.

Thanks for looking into this, @jhammen