web - 如何翻译一些Python开源项目的文档?
大家讲道理
大家讲道理 2017-04-17 17:29:34
0
1
429
  1. Pyhton项目的文档有好多种风格,例如Scrapy这种,比较干净简洁;也比如Flask这种更加素雅、简单;当然还有Python的官方文档

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

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

请教各位,该如何下手?

大家讲道理
大家讲道理

光阴似箭催人老,日月如移越少年。

membalas semua(1)
Peter_Zhu

看了下他们的代码,文档用的是Sphinx引擎,不知楼主用过木有,如果没用过,可以

pip install sphinx

sphinx-quickstart xxx

试一下。

翻译的顺序是:

  1. 先翻译

  2. 完成后开issue与作者沟通,约定文档规范

  3. 如果作者希望合并到主项目,fork,修改,提PR

  4. 作者希望新开个文档 repo, fork,重命名,替换文档内容,部署到RTD

  5. 作者不希望你翻译,额,应该不会有这么傲娇的作者吧......

Muat turun terkini
Lagi>
kesan web
Kod sumber laman web
Bahan laman web
Templat hujung hadapan