web - 如何翻译一些Python开源项目的文档？

Question

1. Pyhton项目的文档有好多种风格，例如Scrapy这种，比较干净简洁；也比如Flask这种更加素雅、简单；当然还有Python的官方文档

2. 最近想翻译的一个项目文档dota2api,他们的项目开源在Github

3. 我的想法是fork一下，增加相应的中文文档，然后提个pull request。问题是不知道这种文档的组织结构，这种类似Scrapy的文档风格是否用了一些框架。

请教各位，该如何下手？

Answer 1

After looking at their code, the document uses the Sphinx engine. I don’t know if the poster has used it. If not, you can

pip install sphinx

sphinx-quickstart xxx

Try it.

The translation order is:

1. Translate first

2. After completion, open an issue to communicate with the author and agree on document specifications

3. If the author wants to merge into the main project, fork, modify, and submit a PR

4. The author hopes to open a new document repo, fork, rename, replace the document content, and deploy it to RTD

5. The author doesn’t want you to translate, well, there shouldn’t be such an arrogant author...