summaryrefslogtreecommitdiff
path: root/parts/django/docs/intro/install.txt
diff options
context:
space:
mode:
Diffstat (limited to 'parts/django/docs/intro/install.txt')
-rw-r--r--parts/django/docs/intro/install.txt84
1 files changed, 84 insertions, 0 deletions
diff --git a/parts/django/docs/intro/install.txt b/parts/django/docs/intro/install.txt
new file mode 100644
index 0000000..327686f
--- /dev/null
+++ b/parts/django/docs/intro/install.txt
@@ -0,0 +1,84 @@
+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's 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.
+
+That's it!
+----------
+
+That's it -- you can now :doc:`move onto the tutorial </intro/tutorial01>`.
+
+
+