教你如何使用Python的官方文件,這是Python 的文件收集,在2008/11/08釋出Python2.6版,看原文是好的,會比較新,但是若是英文不好,也可以看較舊的中文文件:
Python的官方文件
做為一個成功的程式語言,良好的文件是必不可少的,拜內建文件機制的功勞,Python的文件做得相當完備,我們在此介紹如何使用Python的官方文件。
首先要介紹的是Python官方文件的網站
各種文件的種類
在該網站的頁面中,總共有以下的文件
- What’s New in Python 2.6 (changes since previous major release)
- Tutorial (start here),繁體中文版有周譯樂的v2.0版本,簡體的有刘鑫的2.3.3版本
- Global Module Index (for quick access to all modules)
- Library Reference (keep this under your pillow),簡體的有v2.3.3版,繁體中文2.6現在翻譯中,歡迎共襄盛舉,網址在Python標準函式庫
- Language Reference (for language lawyers),簡體的有v 2.3.3版
- Extending and Embedding (tutorial for C/C++ programmers),簡體的有簡短的翻譯
- Python/C API(reference for C/C++ programmers)
- Documenting Python (information for documentation authors)
- Installing Python Modules (information for installers & sys-admins)
- Distributing Python Modules (sharing modules with others)
我們在下面一一介紹各種文件的用途
文件的用途
What’s New in Python 2.6
在此文件中說明新版的Python到底做了什麼樣的改版,如果你之前曾學過較先前版本的Python,你會對此文件有興趣,這裡有一篇滿新的文章講Python 2.6 新特性一览
Tutorial
Python官方版本的教學文件,做為學習Python的目的而言,這也是相當值得參考的一份教學
Global Module Index
瀏覽在Python中所有標準的全域Modules的索引
Library Reference
這是所有Python文件中最常被用到的一個,如同它上面所寫的”keep this under your pillow”(把這個放在你的枕頭下),幾乎每當你要使用Python標準函式庫,及內建的物件和函數時,你就會需要查詢這份文件
Language Reference
這是Python語言的參考文件,說明Python的語法和一些規則,當你想用到某些語言特性時你可能會需要參考這個,例如class的特殊方法,__init__、__cmp__、__getattr__等等的定義
Extending and Embedding
當你需要用C/C++語言擴充Python(寫給Python用的C語言module),或是將Python直譯器嵌在你的C/C++語言程式裡,你需要參考這份文件
Python/C API
Python的C語言API參考手冊
Documenting Python
說明Python文件的一些語法與格式
Installing Python Modules (information for installers & sys-admins)
安裝Python Module的相關文件
Distributing Python Modules
有關發佈Python Module的文件
本文資料來源:
- http://ez2learn.com/python-tutorial/basic-tutorial/standard-document
- http://docs.python.org/