#summary 周蟒安裝指南
#labels Featured,Traditional

= 1. 安裝 Python 程式語言 =

  1. 前往[http://www.python.org/download/ python 程式語言官方網站]下載最新的安裝檔案 (.exe)。
     下載好的安裝檔，其安裝方式就跟其他的 Windows 程式的安裝方式一樣。

如果你想透過 Windows 命令列來使用 Python 語言，那麼你需要先設定好 Windows 環境變數。

在 Windows 2000， XP， 2003 這些作業系統裡，點選 "控制台" -> "系統" -> "進階" -> "環境變數"。

在"系統變數(S)"欄中，選取 'PATH' 變數名稱後，再點選 '編輯(I)' 按鈕。

請先確定你安裝 Python 語言程式的路徑是 'C:Python25'，接著在彈出的視窗中將 ';C:Python25' (注意要以分號隔開)這字串添在原本的字串之後。

在比較舊的 Windows 作業系統版本上，則是在 'C:AUTOEXEC.BAT' 這個檔案中加入

{{{
 'PATH=%PATH%;C:Python25' 
}}}

== 安裝在 Linux/BSD 作業系統上 ==

如果你正使用某個 Linux 的發行版本如 Ubuntu， Fedora， Mandriva 等等，或者某個 BSD 系統如 FreeBSD，那麼你的系統裡應該早就預先安裝好 Python 程式語言軟體了。要測試 Python 程式語言軟體是否真的已經安裝好在你的作業系統上， 你可以開啟一個命令列 (Shell) 程式 (如 konsole 或 gnome-terminal)， 輸入命令 'python -V' ('V' 最好為大寫)。

{{{
$ python -V
Python 2.5.
}}}

註釋: '$' 符號是命令列程式的提示符號。出現的符號與你的系統設定有關。本書中一律以 '$' 符號表示。

如果你看見了如上所示的一些版本訊息，那就表示系統已經預先安裝好 Python 程式語言軟體了。

如果你的作業系統上還未安裝 Python。雖然這種情況不太可能發生。

當你遇到這種情況時，可以透過這兩種方式在你的作業系統上安裝 Python 程式語言軟體。

    * 透過作業系統提供的安裝管理員程式來安裝 (比如 Ubuntu/Debian Linux 作業系統上的 apt-get ， Fedora Linux 作業系統上的 yum， Mandriva Linux 作業系統上的 urpmi， FreeBSD 作業系統上的 pkg_add...等等). 請注意你需要連在網路上才能使用上述方式安裝。
    * 或者你可以下載打包好的套件(如 .deb 或 .rpm 檔)後直接安裝。
    * 你也可以自行編譯 python 程式語言軟體的程式碼並安裝. 在 python 語言軟體的原始碼中有說明編譯的步驟. http://www.python.org/download/

== 安裝在 Mac 作業系統上 ==

在 Mac OS X 10.3 以上的版本中已經預先安裝了 Python 程式語言軟體. 如果你想安裝較新的 Python 程式語言軟體版本， 可以使用 'DarwinPorts' 程式:

    * 安裝 DarwinPorts 程式 http://www.darwinports.org/getdp/
    * 執行 'sudo port search python' 命令以取得 python 軟體列表。
      目前 DarwinPorts 中 Python 2.5.1 版本的代號為 python25。
    * 執行 'sudo port install python25' 命令

= 2. 安裝周蟒程式語言 =

現在我們假設你已經在你的作業系統上準備好了 Python 語言軟體。

接著，請使用命令行(command line) 執行命令以安裝周蟒(zhpy):

== 線上安裝周蟒 ==

1. 如果是全新安裝的話， 請下載 [http://peak.telecommunity.com/dist/ez_setup.py ez_setup.py] 檔案並執行以下指令安裝 zhpy 模組：

{{{
$ python ez_setup.py zhpy
}}}

zhpy 是周蟒的代號，此指令會透過網路自動安裝一個用來線上安裝 Python 模組的工具: "easy_install" 命令，然後線上安裝 zhpy 模組。


2. 如果已安裝過 easy_install 命令模組的話， 請直接執行以下指令安裝 zhpy 模組：

{{{
$ easy_install zhpy
}}}

此指令會透過網路自動安裝 zhpy 模組。

== 透過原始碼安裝周蟒 ==

自 [http://pypi.python.org/pypi/zhpy/ pypi] 下載 zip 格式壓縮的原始碼， 
使用 zip 解壓縮程式解開後， 使用命令列執行以下指令安裝 zhpy 模組：

{{{
$ python setup.py install
}}}

== 驗證 ==


你可以用以下方法來確認是否已安裝成功。

1. 開啟命令行以確認目前安裝的版本:

{{{
$ zhpy
zhpy 0.9.5 in darwin on top of Python 2.5.1
>>>
}}}

2. 使用 python 驗證

{{{
$ python
>>> import zhpy
>>> zhpy.__version__
0.9.5
}}}
