V2EX = way to explore
V2EX 是一个关于分享和探索的地方
Sign Up Now
For Existing Member  Sign In
推荐学习书目
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 · Sep 24, 2016 · 4967 views
    This topic created in 3505 days ago, the information mentioned may be changed or developed.

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

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

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

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

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

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

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

    https://github.com/7sDream/django-intro-zh
    Undefined001
        19
    Undefined001  
       Sep 24, 2016
    sphinx-doc 自己保存在网盘 目前自己是这样
    kancloud
        20
    kancloud  
       Sep 25, 2016
    在国内写技术文档,看云是首选 https://kancloud.cn/explore 广场有很多的推荐的技术文档
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   5075 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 58ms · UTC 05:57 · PVG 13:57 · LAX 22:57 · JFK 01:57
    ♥ Do have faith in what you're doing.