专栏首页机器之心Python用不好?看官方中文文档啦

Python用不好?看官方中文文档啦

机器之心报道

参与:思源

Python 作为世界上最好用的语言,官方支持的文档一直没有中文。小伙伴们已经习惯了原汁原味的英文文档,但如果有官方中文文档,那么查阅或理解速度都会大大提升。本文将介绍隐藏在 Python 官网的中文文档~

  • 官方中文文档地址:https://docs.python.org/zh-cn

以前也是有一些第三方维护的 Python 中文文档,不过可能因为人力等限制,并做不到同步更新与维护。目前也有很多高质量的 Python 中文资源,但大部分都是大牛写的书或教程,官方文档的翻译并得不到保证。

最近很多开发者发现 Python现在已经有官方中文文档了,但直接从 Python 文档界面并看不到。如下在 Python 文档中,只有英语、法语、日语和韩语可选,我们并看不到中文选项。

但是如果我们在地址栏中手动键入 zh-cn,即:https://docs.python.org/zh-cn,那么我们就能看到官方的中文文档了。如下,我们现在从下拉项也可以直接看到中文选项。因为 Python/C API 接口等高阶内容还是英文,所以很可能目前中文文档还在完善中,并没有完全开放。

官方中文文档有什么

目前,官方中文文档已经有 3.8.0a2、3.7.3、3.6.8、2.7.16 几个主流版本的资料,相比英文文档只缺少 3.5.7。对于每一个 Python 版本,文档都包含很多内容,其中入门教程与语言参考已经完成汉化,其它基础内容也都有中文译文,例如各版本的新变化、安装和分发 Python 模块、常见问题等等。

但是还有一些高阶主题基本都保留了英文,例如 Python/C API 接口、标准库参考、扩展和嵌入等。这些内容有的比较难懂,也许它们对译者的要求更高,完成的进度也慢一些。

对于初学者而言,入门教程和 Python 语言参考可能是大家最需要的。其中入门教程非正式地介绍了 Python 语言的基本概念和功能。读者最好在阅读时准备一个 Python 解释器进行练习,不过所有的例子都是相互独立的,所以这个教程也可以离线阅读。

Python 语言参考相比入门教程提供了更正式的语法和「核心语义」,这一份参考非常简洁,它希望保证知识点的准确和完整。除了前面这两份基本学习资料,英文版 Python 文档还为 C/C++提供了两个额外的手册,不过这些高阶内容暂时还没有中文。

最后,Python 中文文档还有个小彩蛋,它把 Python 中的术语都翻了一遍。很多时候,这些术语都有不同的译文与表达方式,例如 decorator 既可以保留原文,也可以翻成装饰器或修饰器。也许以后,这一份官方词汇表可以帮助我们找到更合适的表达方式。

中文文档怎么搜

可能对大多数开发者而言,检索 Python 的函数或用法是文档的常用方法。例如如果我们希望找到函数式编程的使用方法,那么可以在中文文档中搜索 Lambda:

其中流程控制工具有匿名函数 Lambda 的使用简介,而重要的函数式编程指引暂时只有一小部分完成翻译。如下展示的是检索到的 Lambda 使用指南。

本文分享自微信公众号 - 机器之心(almosthuman2014)

原文出处及转载信息见文内详细说明,如有侵权,请联系 yunjia_community@tencent.com 删除。

原始发表时间:2019-03-26

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • 这些Python代码技巧,你肯定还不知道

    人们还经常把 Python 笑称为「可执行伪码(executable pseudocode)」。但是,当你可以编写这样的代码时,很难去反驳这种言论:

    机器之心
  • 教程 | 一文读懂如何用LSA、PSLA、LDA和lda2vec进行主题建模

    在自然语言理解任务中,我们可以通过一系列的层次来提取含义——从单词、句子、段落,再到文档。在文档层面,理解文本最有效的方式之一就是分析其主题。在文档集合中学习、...

    机器之心
  • 真的要说再见,PyTorch宣告不再支持Python2

    Python2 是 Python 官方在 2000 年开源的 Python 新版本,但因为其自身的问题,导致 Python 官方几年内就推出了新的 Python...

    机器之心
  • Python用不好英语水平不够?官方中文文档你看不看

    Python 作为世界上最好用的语言,官方支持的文档一直没有中文。小伙伴们已经习惯了原汁原味的英文文档,但如果有官方中文文档,那么查阅或理解速度都会大大提升。本...

    一墨编程学习
  • Python用不好?看官方中文文档啦

    以前也是有一些第三方维护的 Python 中文文档,不过可能因为人力等限制,并做不到同步更新与维护。目前也有很多高质量的 Python 中文资源,但大部分都是大...

    小小詹同学
  • 我从编程教室毕业

    这篇文章在我的草稿箱里躺了有一年多,今天总算是发出来了。本文的作者是之前编程教室的实训生之一,原本在汽车制造车间里工作,后来成功转行为一名程序员,从事车载语音识...

    Crossin先生
  • 16.ajax_case07

    hankleo
  • Redis 之后,Python 的 master-slave 亦恐被无奈修改

    英文:TheRegister,翻译:开源中国社区 www.oschina.net/news/99858/python-purges-master-and-sla...

    用户6543014
  • JavaScript 为什么要有 Symbol 类型

    Symbols 是 ES6 引入了一个新的数据类型 ,它为 JS 带来了一些好处,尤其是对象属性时。 但是,它们能为我们做些字符串不能做的事情呢?

    前端小智@大迁世界
  • JavaScript 为什么要有 Symbol 类型?

    Symbols 是 ES6 引入了一个新的数据类型 ,它为 JS 带来了一些好处,尤其是对象属性时。 但是,它们能为我们做些字符串不能做的事情呢?

    Fundebug

扫码关注云+社区

领取腾讯云代金券