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

Creating Multilingual Documents #197

Open
kyoya0819 opened this issue Jan 16, 2022 · 3 comments
Open

Creating Multilingual Documents #197

kyoya0819 opened this issue Jan 16, 2022 · 3 comments
Labels
good first issue Good for newcomers

Comments

@kyoya0819
Copy link

Hello from Japan.
I would like to translate this document into Japanese.

Are there any plans to make this document available in multiple languages (e.g. German, French, etc.)?

If you don't plan to do this, I would like to publish it outside as unofficial and license-compliant.

If you do plan to do this, I think you will have to fundamentally change the structure of the directory. I would like to ask what kind of milestone you have in mind in this case.

@rishabhpoddar
Copy link
Member

rishabhpoddar commented Jan 16, 2022

Hi,

Thanks for this issue. I think this is a fantastic idea and is very important, so we definitely want to move towards supporting different languages.

Would you mind sharing info about how the directory structure needs to change? Keep in mind that the docs you see on the site now is mainly in the v2 folder of this repo.

@kyoya0819
Copy link
Author

I'm sorry for the late reply.

I think there are several ways to do this.

The first is to embed the language information in the URL.
It is probably the least expensive to modify.
v2/en/..., v2/ja/..., v2/de/...

The second is to load the English version, and then use JavaScript to get the appropriate translation afterwards and replace it.
However, I think this will require a lot more effort than translating it.

These are the only two methods I could think of, but I would personally recommend the former.

@rishabhpoddar
Copy link
Member

I like the v2/en/.. approach more as well.

@gitcommitshow gitcommitshow added the good first issue Good for newcomers label Jun 9, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
good first issue Good for newcomers
Projects
None yet
Development

No branches or pull requests

3 participants