Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Is there a plan for multilingual? #101

Open
laliwa opened this issue Dec 22, 2023 · 2 comments
Open

Is there a plan for multilingual? #101

laliwa opened this issue Dec 22, 2023 · 2 comments

Comments

@laliwa
Copy link

laliwa commented Dec 22, 2023

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
Copy link

jhammen commented Jan 11, 2024

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
Copy link

kito99 commented Mar 18, 2024

@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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants