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 · 4146 次点击
    这是一个创建于 2988 天前的主题,其中的信息可能已经有所发展或是发生改变。

    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://github.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   ·   实用小工具   ·   1203 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 26ms · UTC 18:36 · PVG 02:36 · LAX 10:36 · JFK 13:36
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.