=====================
如何安装 Django
=====================

:作者: Django 团队
:译者: weizhong2004@gmail.com
:翻译开始日期: 2006-04-24
:修订日期: 2006-04-24
:原文版本: 2575

本文帮助你安装和运行 Django.

安装 Python
==============

作为一个 Python Web 框架, Django 需要 Python.

Django 要求 Python 版本为 2.3 或更高.

在 www.python.org 可以下载到 Python. 如果你使用的是 Linux 或 Mac OS X, Python 很可能已经安装到了系统中.

安装 Apache 和 mod_python
=============================

如果你只想体验一下 Django, 可以跳过这一步. Django 自带了一个用于开发目的的 WEB 服务器.

如果你计划在商业站点使用 Django , 建议使用安装有 `mod_python`_ 的 Apache.
mod_python 类似 mod_perl -- 它在 Apache 中嵌入了 Python 解释器, 当服务器启动时, 会将 Python 代码一并载入到内存中.
只要Apache进程存在, Python代码就一直保留在内存中, 这种方式带来了极大的性能提升.要确保你已经安装了Apache, 并激活了
mod_python 模块. Django 要求 Apache 2.x 及 mod_python 3.x.

参阅 `如何搭配 mod_python 运行 Django`_ 学习 mod_python 在安装之后如何配置.

如果因为某种原因你无法使用 mod_python, 也无须担心: Django 遵循 WSGI_ 标准, 这使得它可以运行在多种服务器平台上.
参阅 `server-arrangements wiki page`_ 了解每个平台的特定安装指令.

.. _Apache: http://httpd.apache.org/
.. _mod_python: http://www.modpython.org/
.. _WSGI: http://www.python.org/peps/pep-0333.html
.. _如何搭配 mod_python 运行 Django: http://www.djangoproject.com/documentation/modpython/
.. _server-arrangements wiki page: http://code.djangoproject.com/wiki/ServerArrangements

让数据库运行起来
=========================

如果计划使用 Django 的数据库 API , 你需要一台运行中的数据库服务器. Django 支持 PostgreSQL_
(建议), MySQL_ 及 SQLite_.

另外, 你还需要保证你的 Python 数据库绑定(模块)已经安装.

* 如果你使用 PostgreSQL, 你需要安装 psycopg_ package (版本 1.1 --不能是1.0或2.0). 如果你是 Windows 平台, 下载非官方的 `已编译的 Windows 版本`_.
* 如果你使用 MySQL, 你需要 MySQLdb_.
* 如果你使用 SQLite, 你需要 pysqlite_. 要求版本 2.0.3 或更高.

.. _PostgreSQL: http://www.postgresql.org/
.. _MySQL: http://www.mysql.com/
.. _Django's ticket system: http://code.djangoproject.com/report/1
.. _psycopg: http://initd.org/projects/psycopg1
.. _已编译的 Windows 版本: http://stickpeople.com/projects/python/win-psycopg/
.. _MySQLdb: http://sourceforge.net/projects/mysql-python
.. _SQLite: http://www.sqlite.org/
.. _pysqlite: http://initd.org/tracker/pysqlite

安装 Django 代码
==================

正式发行的版本与开发版本的安装指令稍有不同.

不过不论哪一种都是相当简单的.

安装正式发布版本
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1. 从 `download page`_ 下载 Django-0.91.tar.gz .
2. ``tar xzvf Django-0.91.tar.gz``
3. ``cd Django-0.91``
4. ``sudo python setup.py install``

注意,最后一条命令会自动下载并安装 setuptools_ (如果你的系统中没有安装它的话). 这要求你在安装时必须有可用的 Internet 连接.

这样就会将 Django 安装到你的 Python 安装的 ``site-packages`` 目录中.

.. _setuptools: http://peak.telecommunity.com/DevCenter/setuptools

安装开发版本
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1. 安装 Subversion_ .
2. ``svn co http://code.djangoproject.com/svn/django/trunk/ django_src``
3. 符号连接 ``django_src/django`` 以便使 ``django`` 位于你的 Python 安装的 ``site-packages`` 目录:

   ``ln -s `pwd`/django_src/django /usr/lib/python2.3/site-packages/django``

   (注意: 不要照抄代码, 根据你的 Python 版本修改上行中的 ``python2.3`` .)

你不需要执行 ``python setup.py install``.

当你需要升级你的代码时, 在你的 ``django_src`` 目录下运行命令 ``svn update`` 即可.

.. _`download page`: http://www.djangoproject.com/download/
.. _Subversion: http://subversion.tigris.org/