Translate Document in Chinese

[MacHu-GWU]

I can help with writing Chinese documentation and very proficient with Sphinx Doc, just one question, where should I put the chinese .rst files? I saw there's a Japanese version, but I can't find it.

[techalchemy]

Hmmm good question, I have actually no idea how this works but most of the maintainers are less ignorant than I am as I think they all speak chinese to some degree

/cc @uranusjr @frostming @jxltom

[jxltom]

As https://docs.readthedocs.io/en/latest/localization.html, we might need to do some adjustments to our readthedocs project to support multiple languages. But mutiple languages support would be awesome!

[frostming]

Japanese and Spanish translations seem to be done in separate projects(the 1st option in https://docs.readthedocs.io/en/latest/localization.html):

Jap: https://github.com/cocoatomo/pipenv
Es: https://github.com/iKenshu/pipenv

@MacHu-GWU You can create a fork and do CN translation in that repo. We are glad to help.
If we are to include the translations in this repo, the docs settings have to be changed. @techalchemy Do you have access to the readthedocs project?

[frostming]

I found a team on transifex. Maybe it is a good place to go ahead. /cc @cocoatomo

[cocoatomo]

Hi, I am welcome your application for participation in the Transifex project.
This CircleCI configuration might helps you to build documentation with translation data.

[MacHu-GWU]

@frostming I do can fork and start. Before doing that, may I know the Localized Docs should be included in the main repo, or in a separate repo?

[MacHu-GWU]

@cocoatomo I checked your https://github.com/cocoatomo/pipenv, but I can't find your Japanese docs, would you mind to help me locate it?

[uranusjr]

@MacHu-GWU The method used is to export strings into the docs/locales directory, and translate on Transifex (link above).

[cocoatomo]

@MacHu-GWU Sorry for inconvenience, and @uranusjr is right. thanks!
Japanese documentations are published on readthedocs.

To understand the features used in my translation project, please refer following resources:

• about internationalization features of Sphinx: http://www.sphinx-doc.org/en/master/usage/advanced/intl.html
• about Transfex client: https://docs.transifex.com/client/introduction

[frostming]

@MacHu-GWU I have setup a translation project on Transifex: https://www.transifex.com/pipenv-tr/pipenv-doc. welcome to join!

[jxltom]

@frostming I think transifex supports translation of multiple languages. Could we setup a project such as https://www.transifex.com/pipenv where we can translate pipenv into different language instead of only Chinese?

[frostming]

@jxltom Yeah it is great but Japenese and Spanish translation already lie in their own repo.

I can change the org name to pipenv-tr since pipenv is occupied.

[jxltom]

Sounds good! Maybe we could start from Chinese first and then adding other languages later.

[krysal]

Excuse me @frostming do you know how to contribute to the Spanish docs? I want to translate the last paragraph of this page but I don't even know where to start.

[matteius]

Seems with the new LLMs and GPT models that translating the docs would have gotten a whole lot easier if that is still something anyone wants to take up. Also, we should probably finish rewriting/improving the documentation first before making many strides to translate.