专栏首页小詹同学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 使用指南。

本文分享自微信公众号 - 小詹学Python(xiaoxiaozhantongxue)

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

原始发表时间:2019-04-04

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

我来说两句

0 条评论
登录 后参与评论

相关文章

  • Python | 开发者必备的 6 个库

    链接:https://www.oschina.net/translate/6-essential-libraries-for-every-python-deve...

    小小詹同学
  • Python 官网宣布,正式发布 Python 3.8.0!

    那么,这次新发布的 Python 3.8.0 有哪些重要的改进呢?以下是是 Python 3.8 相比 3.7 的新增特性。

    小小詹同学
  • Python官方最后通牒:Python 2传奇20年将落幕,Python 3接力!

    Python官方非常正式的在官网上发表一封公开信,再次强调Python 2将于2020年元旦停止维护!之后,官方将不会再对任何bug、安全漏洞进行任何更新或者修...

    小小詹同学
  • Python用不好英语水平不够?官方中文文档你看不看

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

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

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

    机器之心
  • 我从编程教室毕业

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

    Crossin先生
  • 布客·ApacheCN 编程/后端/大数据/人工智能学习资源 2020.11

    ApacheCN_飞龙
  • 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 带来了一些好处,尤其是对象属性时。 但是,它们能为我们做些字符串不能做的事情呢?

    前端小智@大迁世界

扫码关注云+社区

领取腾讯云代金券