我想翻译个 python 文档,写在哪里合适呢? - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
推荐学习书目
Learn Python the Hard Way
Python Sites
PyPI - Python Package Index
http://diveintopython.org/toc/index.html
Pocoo
值得关注的项目
PyPy
Celery
Jinja2
Read the Docs
gevent
pyenv
virtualenv
Stackless Python
Beautiful Soup
结巴中文分词
Green Unicorn
Sentry
Shovel
Pyflakes
pytest
Python 编程
pep8 Checker
Styles
PEP 8
Google Python Style Guide
Code Style from The Hitchhiker's Guide
whx20202
V2EX    Python

我想翻译个 python 文档,写在哪里合适呢?

  •  1
     
  •   whx20202 2016-09-24 08:22:56 +08:00 4605 次点击
    这是一个创建于 3304 天前的主题,其中的信息可能已经有所发展或是发生改变。

    https://pexpect.readthedocs.io/en/stable/overview.html python 英文文档大多这样的

    我不想自己建个站,我想找个中文网站,能让我直接写在他的网站上。

    可是这样问题就来了: 我当然可以写在 csdn 或者博客园上,但是感觉有点丑还没有原来左边的导航栏

    有没有更好看一点的办法?

    20 条回复    2016-09-25 13:33:57 +08:00
    Delbert
        1
    Delbert  
       2016-09-24 08:30:23 +08:00 via Android   1
    gitbook
    kindjeff
        2
    kindjeff  
       2016-09-24 08:34:09 +08:00 via iPhone
    我想翻译 asyncio 这一章。
    wizardforcel
        3
    wizardforcel  
       2016-09-24 08:39:42 +08:00 via Android
    gitbook
    xFrank
        4
    xFrank  
       2016-09-24 08:44:54 +08:00
    这个库好赞啊!
    解决了我不少问题,多谢楼主!
    aljun
        5
    aljun  
       2016-09-24 09:17:42 +08:00
    当年试图翻译 sqlalchemy 的文档。。。写到一半放弃了。。。。。楼主加油!
    zhouzm
        6
    zhouzm  
       2016-09-24 09:18:14 +08:00   1
    楼主,你都到门口了,却不进去……

    https://docs.readthedocs.io/en/latest/getting_started.html
    psklf
        7
    psklf  
       2016-09-24 09:18:50 +08:00
    @aljun 那个内容太多了 我当时下了英文文档 看了一点点
    WangYanjie
        8
    WangYanjie  
       2016-09-24 10:25:22 +08:00
    readthedocs, 翻译后的文档建议还是用 sphinx ,别用 gitbook
    iFlicker
        9
    iFlicker  
       2016-09-24 11:00:38 +08:00
    看云
    wizardforcel
        10
    wizardforcel  
       2016-09-24 11:20:26 +08:00
    readthedocs 是需要关联 Github 的,所以先找到其代码库的地址: https://gihub.com/pexpect/pexpect.git

    然后 Fork ,翻译,之后自己在 readthedocs 新建项目部署上去。
    Adven
        11
    Adven  
       2016-09-24 11:36:10 +08:00
    国内 OSC 、 Coding 都可以的!
    diefishfish
        12
    diefishfish  
       2016-09-24 11:53:05 +08:00 via Android
    (`)楼主翻译好了记得艾特我,我要去学习!
    TheCure
        13
    TheCure  
       2016-09-24 12:08:32 +08:00
    expect 是个神器
    可惜很多工作多年的人也不知道
    pouta
        14
    pouta  
       2016-09-24 12:19:51 +08:00 via Android
    支持一下
    kxxoling
        15
    kxxoling  
       2016-09-24 12:47:09 +08:00
    Markdown 太弱,还是用 Rst 吧,翻译完直接在 ReadTheDocs 上设置一个 GitHub hook 就行了。源文档如果就是 Rst ,可以用 sphinx 里的 locale 新增中文翻译,这样还能给原作者提 PR 。
    aljun
        16
    aljun  
       2016-09-24 12:57:26 +08:00
    @psklf 其实主要是他英文文档就写得很绕。。。不过。。。自己当年大一。。毅力也不够。。
    nolotus
        17
    nolotus  
       2016-09-24 14:56:18 +08:00
    我这提供基于 mdwiki 的,你可以用自己的静态站点 hexo 一类的,支持绑定域名,技术翻译,免费哟~
    7sDream
        18
    7sDream  
       2016-09-24 15:40:10 +08:00
    也可以用 mkdocs , rtds 支持,也支持发布到 github pages ,配置可以参考我这个翻译项目:

    https://github.com/7sDream/django-intro-zh
    Undefined001
        19
    Undefined001  
       2016-09-24 21:51:29 +08:00
    sphinx-doc 自己保存在网盘 目前自己是这样
    kancloud
        20
    kancloud  
       2016-09-25 13:33:57 +08:00
    在国内写技术文档,看云是首选 https://kancloud.cn/explore 广场有很多的推荐的技术文档
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     1118 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 25ms UTC 18:01 PVG 02:01 LAX 11:01 JFK 14:01
    Do have faith in what you're doing.
    ubao snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86