V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
7sDream
V2EX  ›  Django

来来来,大家一起来翻译 Django 文档咋样?

  •  
  •   7sDream ·
    7sDream · 2015-08-27 00:07:52 +08:00 · 5943 次点击
    这是一个创建于 3411 天前的主题,其中的信息可能已经有所发展或是发生改变。

    毫无存在感的本科僧一枚,最近在稍微学一下 Django ,看完 Django Book 之后觉得还是官方文档好,搜了一遍好像没有翻译,也没有项目在翻译……就自己开了一个。

    目前就我和几个朋友在翻,马上开学了事也多,速度就降了下来……

    欢迎大家有时间的有能力的一起来翻译吧,顺便可以加深一下对 Django 的理解啥的……

    项目在 GitHub ,文档托管在 ReadTheDocs ,用 mkdocs 构建,因为小伙伴觉得 md 比 rst 好编辑。

    已翻译的一篇: http://django-intro-zh.readthedocs.org/zh_CN/latest/part1/

    GitHub : https://github.com/7sDream/django-intro-zh

    RTD 首页: http://django-intro-zh.readthedocs.org/zh_CN/latest/


    顺便广告一下我的另一个项目, Zhihu-py3 : https://github.com/7sDream/zhihu-py3 欢迎试用……

    第 1 条附言  ·  2015-08-28 18:14:14 +08:00

    2015.08.28 17:55

    kdwycz 同学完成了 《快速安装指南》 的翻译, Thanks 。

    第 2 条附言  ·  2015-08-29 14:28:45 +08:00

    2015.08.29 13:08

    lishubing 同学完成了《初识 Django 》 部分。

    28 条回复    2015-11-13 21:27:19 +08:00
    phx13ye
        1
    phx13ye  
       2015-08-27 00:58:22 +08:00
    赞, django 的文档最好了
    mornlight
        2
    mornlight  
       2015-08-27 01:00:44 +08:00   ❤️ 3
    ericls
        3
    ericls  
       2015-08-27 01:10:01 +08:00 via Android
    不如一起学英文
    kslr
        4
    kslr  
       2015-08-27 01:21:20 +08:00 via Android
    为何不学英文+1
    看文档是无可避免的,而大部分都是英文的
    zmj1316
        5
    zmj1316  
       2015-08-27 08:35:47 +08:00
    @ericls 翻译文档不就是在学英文吗?不会英语怎么翻译?
    7sDream
        6
    7sDream  
    OP
       2015-08-27 08:55:36 +08:00
    @mornlight
    QAQ 竟然已经有这么完整的翻译惹~~看了一下, 1.8.2 ,恩 估计和最新版区别也不大……
    正在和小伙伴商量是换个东西翻还是继续……
    Thx
    ljdawn
        7
    ljdawn  
       2015-08-27 09:34:54 +08:00
    翻译文档是跟不住节奏的 // 可以先看一遍 django book 。 那个有中文版的。。 只是版本比较老 看了一编 再去看 1.8 的文档就好了
    plqws
        8
    plqws  
       2015-08-27 09:46:14 +08:00
    @7sDream 自己再翻译一遍吧,昨天翻译了 Airbnb ES6 编码指南,结果发现早就有人翻译好了,不过对比了一下,发现自己翻译的质量高多了……
    MrEggNoodle
        9
    MrEggNoodle  
       2015-08-27 10:50:12 +08:00
    不如一起学英文吧。 Django 的翻译文档好像很多夭折了。
    7sDream
        10
    7sDream  
    OP
       2015-08-27 11:03:41 +08:00 via iPhone
    @ljdawn Django Book 看完了 感觉好多地方都不一样了 比如默认设置 数据库模型层 通用视图那几章……所以才想翻译文档的说。
    MrEggNoodle
        11
    MrEggNoodle  
       2015-08-27 11:09:55 +08:00
    @7sDream 楼主干脆加入二楼的那个团队,把一个 Django 的文档众人合力完成,那个是我目前看到最完整的翻译版本了。
    est
        12
    est  
       2015-08-27 11:22:07 +08:00
    貌似有 n 多这样的尝试了。
    stargazer
        13
    stargazer  
       2015-08-27 11:54:32 +08:00
    django 版本变化太快了,而且版本之间差异也挺大,贵在坚持
    ljdawn
        14
    ljdawn  
       2015-08-27 12:35:59 +08:00
    @7sDream 那些内容体就不多了。
    chengzhoukun
        15
    chengzhoukun  
       2015-08-27 12:46:44 +08:00
    有人开坑 tornado 的吗, tornado 的中文资料更少了,虽然我自己看官方文档无压力,但是想锻炼下英文
    symons
        16
    symons  
       2015-08-27 14:24:48 +08:00
    我感觉这种看英文就好,单词一般都不难,偶尔遇到不认识的,查一查就好啦
    julyclyde
        17
    julyclyde  
       2015-08-27 15:00:27 +08:00   ❤️ 1
    django 的问题其实不是英文
    而是它太庞大了
    mianju
        18
    mianju  
       2015-08-27 15:21:57 +08:00
    @chengzhoukun 有中文文档的呀
    janxin
        19
    janxin  
       2015-08-27 16:40:00 +08:00
    @chengzhoukun 顶开一个

    django 我是觉得太大了...很多人开过都弃了
    7sDream
        20
    7sDream  
    OP
       2015-08-27 19:58:57 +08:00 via iPhone   ❤️ 1
    @MrEggNoodle 这个想法挺好的⊙ω⊙ 嗯 由于我们计划是只把 intro 部分翻译一下 文档因为我们人少本来是不准备翻的…… 这样吧 我们先在自己的项目里翻译着 翻译完了(一共就 10 章估计也快)在用 pandoc 转成 rst 和那个项目想办法合并一下。
    inframe
        21
    inframe  
       2015-08-28 00:12:10 +08:00
    2 楼的不错的呢。如果大家的翻译可以都合起来的话,速度会快很多
    kancloud
        22
    kancloud  
       2015-08-28 08:18:17 +08:00
    readthedocs 的速度还是不行,试下国内的看云吧 kancloud.cn 也是 markdown 格式的
    WalkingEraser
        23
    WalkingEraser  
       2015-08-28 12:51:06 +08:00
    Django 文档还需要翻译么。。
    secondwtq
        24
    secondwtq  
       2015-08-28 15:48:01 +08:00
    @chengzhoukun Tornado 有一本书貌似翻译放在网上了,我一直在看那玩意。

    Tornado 的英文文档感觉阅读体验还可以。
    7sDream
        25
    7sDream  
    OP
       2015-08-28 15:48:44 +08:00
    @kancloud 我研究下 Thx

    @WalkingEraser 恩,毕竟大多数国人看英文文档还是没有中文文档快和舒服的嘛……一边助人一遍利己(深入一遍文档),也是不错的啦。
    qq12365411
        26
    qq12365411  
       2015-08-28 19:56:21 +08:00
    支持 求你们弄个 django 中文版网页, 并增加捐赠入口, like http://www.hcharts.cn/ http://www.bootcss.com/
    7sDream
        27
    7sDream  
    OP
       2015-08-28 23:45:06 +08:00
    @qq12365411 谢谢,现在翻译的文档还很少,慢慢的翻译的量多了,质量上去了会考虑弄一个~~感谢。
    wizardforcel
        28
    wizardforcel  
       2015-11-13 21:27:19 +08:00 via Android
    @stargazer 估计 2.0 不会在今年出来 而他的文档 1.8 适用于所有的 1.8.x

    其实 django book 只是 pro django 的一小部分 那本书也是没人翻译 可见 django 社区有多低沉
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   938 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 24ms · UTC 21:54 · PVG 05:54 · LAX 13:54 · JFK 16:54
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.