hi，我翻译了`mysqldb`的官方文档，欢迎拍砖

还有一些想法，先说明：

1. 我在自己翻译不好的地方，都有了不良好的批注，还算醒目的提示。
2. 可以参照英语原文。
3. 文章持续更新。
4. 希望更多人参与，希望看到其他的python翻译文档。

一直没有注意，v2ex发帖都是花币的......
如果是新人...那就只有看的份??
这是闭源的?

MySQLdb

文档

翻译

17 replies • 2015-01-17 21:25:14 +08:00

ykshen

Dec 30, 2014

建议把美女等字眼去掉

hahastudio

Dec 30, 2014

译注如果改成吐槽，这份翻译变成非严肃的调侃文档、学习笔记，还可以；如果想变成一份严肃的翻译文章，我没看到任何有用的译注。
译注的格式：并不是所有的引用块都是译注，比如“第二个参数 (how) 决定了行的展现方式.”这段；也并不是所有的译注都使用了独立成段的引用格式，比如“( 此处翻译准确吗？)”，“(Orz, 啥j8翻译...)”，这些可以算是批注？
翻译不统一，比如“This must be a keyword parameter.”这句，你翻译了两次，“这只能当做关键字参数使用.”，“这应该是关键字参数”。
请在中文段落中正确使用中文标点，并避免不必要的空格。
不要在代码块里添加吐槽、笔记似的 comments。

你或许应该找一找译注的使用方式。
话说这让我想起了以前看翻译组的汉化工作，首先会定义专有名词翻译和译文风格，就像是先定义代码风格一样。

kurtzhong

Dec 30, 2014

翻的好坏都不说了谁都有菜的时候可是可不可以稍微严肃点

1989922yan

Dec 30, 2014

@ykshen 已去。

1989922yan

Dec 30, 2014

@kurtzhong
做了一些简单的修改。
删除了一些多余吐槽。

THX：）

1989922yan

Dec 30, 2014

@hahastudio

1. 吐槽。
我随手翻了翻，去掉了部分。

*2. 注释不给力。
我个人实力问题，我的数据库知识本身集中在优化。
mysql api部分的知识并不好。特此欢迎补充：）
我自己也会慢慢补充。

3. 注释中包含`批注`。
我不想假装自己的翻译是最好的。
我的想法是标出所有翻译不好的地方。
a. 我自己可以再做改进。
b. 不要误人。他人可以改进。
c. 为了不要误人，我选择了中英对照。
还是欢迎补充改进：）

4. 中文中嵌英文标点。
我全部翻译都保持了这个`怪癖`。
暂时当做是我没有混用tab 和 space*4吧。

5. 翻译不统一。
我需要再检查一次翻译：）

谢谢意见：）
你给我的回复是最多了，谢谢：）
会再更新：）