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

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

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

请教各位,该如何下手?

大家讲道理
大家讲道理

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

全部回覆 (1)
Peter_Zhu

看了下他們的程式碼,文件用的是Sphinx引擎,不知樓主用過木有,如果沒用過,可以

pip install sphinx sphinx-quickstart xxx

試一下。

翻譯的順序是:

  1. 先翻譯

  2. 完成後開issue與作者溝通,約定文件規範

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

  4. 作者希望新開個文檔 repo, fork,重新命名,替換文檔內容,部署到RTD

  5. 作者不希望你翻譯,額,應該不會有這麼傲嬌的作者吧......

    最新下載
    更多>
    網站特效
    網站源碼
    網站素材
    前端模板
    關於我們 免責聲明 Sitemap
    PHP中文網:公益線上PHP培訓,幫助PHP學習者快速成長!