當前位置:
首頁 > 新聞 > Python用不好?看官方中文文檔啦

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

Python 作為世界上最好用的語言,官方支持的文檔一直沒有中文。小夥伴們已經習慣了原汁原味的英文文檔,但如果有官方中文文檔,那麼查閱或理解速度都會大大提升。本文將介紹隱藏在 Python 官網的中文文檔~

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

以前也是有一些第三方維護的 Python 中文文檔,不過可能因為人力等限制,並做不到同步更新與維護。目前也有很多高質量的 Python 中文資源,但大部分都是大牛寫的書或教程,官方文檔的翻譯並得不到保證。

最近很多開發者發現 Python現在已經有官方中文文檔了,但直接從 Python 文檔界面並看不到。如下在 Python 文檔中,只有英語、法語、日語和韓語可選,我們並看不到中文選項。

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

但是如果我們在地址欄中手動鍵入 zh-cn,即:https://docs.python.org/zh-cn,那麼我們就能看到官方的中文文檔了。如下,我們現在從下拉項也可以直接看到中文選項。因為 Python/C API 介面等高階內容還是英文,所以很可能目前中文文檔還在完善中,並沒有完全開放。

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

官方中文文檔有什麼

目前,官方中文文檔已經有 3.8.0a2、3.7.3、3.6.8、2.7.16 幾個主流版本的資料,相比英文文檔只缺少 3.5.7。對於每一個 Python 版本,文檔都包含很多內容,其中入門教程與語言參考已經完成漢化,其它基礎內容也都有中文譯文,例如各版本的新變化、安裝和分發 Python 模塊、常見問題等等。

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

但是還有一些高階主題基本都保留了英文,例如 Python/C API 介面、標準庫參考、擴展和嵌入等。這些內容有的比較難懂,也許它們對譯者的要求更高,完成的進度也慢一些。

對於初學者而言,入門教程和 Python 語言參考可能是大家最需要的。其中入門教程非正式地介紹了 Python 語言的基本概念和功能。讀者最好在閱讀時準備一個 Python 解釋器進行練習,不過所有的例子都是相互獨立的,所以這個教程也可以離線閱讀。

Python 語言參考相比入門教程提供了更正式的語法和「核心語義」,這一份參考非常簡潔,它希望保證知識點的準確和完整。除了前面這兩份基本學習資料,英文版 Python 文檔還為 C/C++提供了兩個額外的手冊,不過這些高階內容暫時還沒有中文。

最後,Python 中文文檔還有個小彩蛋,它把 Python 中的術語都翻了一遍。很多時候,這些術語都有不同的譯文與表達方式,例如 decorator 既可以保留原文,也可以翻成裝飾器或修飾器。也許以後,這一份官方辭彙表可以幫助我們找到更合適的表達方式。

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

中文文檔怎麼搜

可能對大多數開發者而言,檢索 Python 的函數或用法是文檔的常用方法。例如如果我們希望找到函數式編程的使用方法,那麼可以在中文文檔中搜索 Lambda:

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

其中流程式控制制工具有匿名函數 Lambda 的使用簡介,而重要的函數式編程指引暫時只有一小部分完成翻譯。如下展示的是檢索到的 Lambda 使用指南。

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

喜歡這篇文章嗎?立刻分享出去讓更多人知道吧!

本站內容充實豐富,博大精深,小編精選每日熱門資訊,隨時更新,點擊「搶先收到最新資訊」瀏覽吧!


請您繼續閱讀更多來自 機器之心 的精彩文章:

萬字長文概述NLP中的深度學習技術之卷積神經網路
絕佳的ASR學習方案:這是一套開源的中文語音識別系統

TAG:機器之心 |