/docs/intro/install.txt
https://code.google.com/p/mango-py/ · Plain Text · 100 lines · 68 code · 32 blank · 0 comment · 0 complexity · 3721e51fd857f1972d080351b20b5087 MD5 · raw file
- Quick install guide
- ===================
- Before you can use Django, you'll need to get it installed. We have a
- :doc:`complete installation guide </topics/install>` that covers all the
- possibilities; this guide will guide you to a simple, minimal installation
- that'll work while you walk through the introduction.
- Install Python
- --------------
- Being a Python Web framework, Django requires Python. It works with any Python
- version from 2.4 to 2.7 (due to backwards
- incompatibilities in Python 3.0, Django does not currently work with
- Python 3.0; see :doc:`the Django FAQ </faq/install>` for more
- information on supported Python versions and the 3.0 transition), but we
- recommend installing Python 2.5 or later. If you do so, you won't need to set
- up a database just yet: Python 2.5 or later includes a lightweight database
- called SQLite_.
- .. _sqlite: http://sqlite.org/
- Get Python at http://www.python.org. If you're running Linux or Mac OS X, you
- probably already have it installed.
- .. admonition:: Django on Jython
- If you use Jython_ (a Python implementation for the Java platform), you'll
- need to follow a few additional steps. See :doc:`/howto/jython` for details.
- .. _jython: http://www.jython.org/
- You can verify that Python is installed by typing ``python`` from your shell;
- you should see something like::
- Python 2.5.1 (r251:54863, Jan 17 2008, 19:35:17)
- [GCC 4.0.1 (Apple Inc. build 5465)] on darwin
- Type "help", "copyright", "credits" or "license" for more information.
- >>>
- Set up a database
- -----------------
- If you installed Python 2.5 or later, you can skip this step for now.
- If not, or if you'd like to work with a "large" database engine like PostgreSQL,
- MySQL, or Oracle, consult the :ref:`database installation information
- <database-installation>`.
- Remove any old versions of Django
- ---------------------------------
- If you are upgrading your installation of Django from a previous version, you
- will need to :ref:`uninstall the old Django version before installing the new
- version <removing-old-versions-of-django>`.
- Install Django
- --------------
- You've got three easy options to install Django:
- * Install a version of Django :doc:`provided by your operating system
- distribution </misc/distributions>`. This is the quickest option for those
- who have operating systems that distribute Django.
- * :ref:`Install an official release <installing-official-release>`. This
- is the best approach for users who want a stable version number and aren't
- concerned about running a slightly older version of Django.
- * :ref:`Install the latest development version
- <installing-development-version>`. This is best for users who want the
- latest-and-greatest features and aren't afraid of running brand-new code.
- .. admonition:: Always refer to the documentation that corresponds to the
- version of Django you're using!
- If you do either of the first two steps, keep an eye out for parts of the
- documentation marked **new in development version**. That phrase flags
- features that are only available in development versions of Django, and
- they likely won't work with an official release.
- Verifying
- ---------
- To verify that Django can be seen by Python, type ``python`` from your shell.
- Then at the Python prompt, try to import Django::
- >>> import django
- >>> print django.get_version()
- 1.3
- That's it!
- ----------
- That's it -- you can now :doc:`move onto the tutorial </intro/tutorial01>`.