docs icon indicating copy to clipboard operation
docs copied to clipboard

Creating Multilingual Documents

Open kyoya0819 opened this issue 3 years ago • 3 comments

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.

kyoya0819 avatar Jan 16 '22 13:01 kyoya0819

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.

rishabhpoddar avatar Jan 16 '22 13:01 rishabhpoddar

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.

kyoya0819 avatar Jan 27 '22 14:01 kyoya0819

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

rishabhpoddar avatar Jan 30 '22 06:01 rishabhpoddar