docs: preparing the Translation Files for Japanese

[tkoyama010]

resolve #352
ref Preparing the Translation Files

[tkoyama010]

pre-commit.ci autofix

[tkoyama010]

Once this PR is merged, proceed to the next step of Translation Guide for the Python Packaging Guide.

[flpm]

Thanks for excluding the changes on the "es" files! The only comment is that we should use the iso code for Japanese (jp) instead of ja for the folder.

[tkoyama010]

Thanks for excluding the changes on the "es" files! The only comment is that we should use the iso code for Japanese (jp) instead of ja for the folder.

Good catch. Thanks!

[tkoyama010]

Thanks for excluding the changes on the "es" files! The only comment is that we should use the iso code for Japanese (jp) instead of ja for the folder.

The code language option for Japanese is ja in Sphinx Options for internationalization. Could you explain the reason we use iso code?

[tkoyama010]

The Wikipedia description is most likely incorrect 😢 : jp is the Japan code and ja is the Japanese code.

[flpm]

Interesting, good catch! I wonder why they deviated from the standard. Keeping to the standard helps with language detection, so tools can recognize that a locale exists for a certain language automatically.

In our case, the important part is matching the theme locale code, because part of the text that appears comes from the Sphinx theme (pydata) and for it to work well they have to match.

I just checked and the theme does not have a Japanese locale yet, so no answer there.

I think it's probably better then to stick to the Sphinx code (ja), assuming that is what themes would also choose for their locales.

[tkoyama010]

Thanks, it seems that Wikipedia was not wrong but the part I was referring to. The codes are different for country codes and language codes, and for language codes it is correct to look at IETF language tag. I will send a separate Pull Request for this!

[flpm]

The Wikipedia description is most likely incorrect 😢 : jp is the Japan code and ja is the Japanese code.

Ah, I guess it makes more sense then. We should then refer to the language, ja would be the correct code to use.

[tkoyama010]

pre-commit.ci autofix

[tkoyama010]

I have no idea about CI error🙇

[willingc]

Hi @tkoyama010. #356 should fix the htmlproofer error. Thanks for this PR 🎉

[lwasser]

@all-contributors please add @tkoyama010 for code, review

[allcontributors]

@lwasser

I've put up a pull request to add @tkoyama010! 🎉

[lwasser]

hey @flpm i'm happy for you to merge these translation related pr's as you see fit if you are ok with doing so!

[flpm]

Looks good to me. It's exciting to start a new language translation!