← Back to branch summary

~ubuntu-branches/ubuntu/quantal/python-django/quantal-security

« back to all changes in this revision

Viewing changes to docs/topics/install.txt

  • Committer: Bazaar Package Importer
  • Author(s): Jamie Strandboge
  • Date: 2010-10-12 11:34:35 UTC
  • mfrom: (4.4.9 sid)
  • mto: This revision was merged to the branch mainline in revision 30.
  • Revision ID: james.westby@ubuntu.com-20101012113435-5rk3p18nyanuhj6g
* SECURITY UPDATE: XSS in CSRF protections. New upstream release
  - CVE-2010-3082
* debian/patches/01_disable_url_verify_regression_tests.diff:
  - updated to disable another test that fails without internet connection
  - patch based on work by Kai Kasurinen and Krzysztof Klimonda
* debian/control: don't Build-Depends on locales-all, which doesn't exist
  in maverick

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/topics/install.txt
1
 
.. _topics-install:
2
 
 
3
1
=====================
4
2
How to install Django
5
3
=====================
11
9
 
12
10
Being a Python Web framework, Django requires Python.
13
11
 
14
 
It works with any Python version from 2.4 to 2.6 (due to backwards
 
12
It works with any Python version from 2.4 to 2.7 (due to backwards
15
13
incompatibilities in Python 3.0, Django does not currently work with
16
 
Python 3.0; see :ref:`the Django FAQ <faq-install>` for more
 
14
Python 3.0; see :doc:`the Django FAQ </faq/install>` for more
17
15
information on supported Python versions and the 3.0 transition).
18
16
 
19
17
Get Python at http://www.python.org. If you're running Linux or Mac OS X, you
22
20
.. admonition:: Django on Jython
23
21
 
24
22
    If you use Jython_ (a Python implementation for the Java platform), you'll
25
 
    need to follow a few additional steps. See :ref:`howto-jython` for details.
 
23
    need to follow a few additional steps. See :doc:`/howto/jython` for details.
26
24
 
27
25
.. _jython: http://jython.org/
28
26
 
41
39
mod_wsgi module activated. Django will work with any version of Apache that
42
40
supports mod_wsgi.
43
41
 
44
 
See :ref:`How to use Django with mod_wsgi <howto-deployment-modwsgi>` for
 
42
See :doc:`How to use Django with mod_wsgi </howto/deployment/modwsgi>` for
45
43
information on how to configure mod_wsgi once you have it installed.
46
44
 
47
45
If you can't use mod_wsgi for some reason, fear not: Django supports many other
48
 
deployment options. A great second choice is :ref:`mod_python
49
 
<howto-deployment-modpython>`, the predecessor to mod_wsgi. Additionally, Django
 
46
deployment options. A great second choice is :doc:`mod_python
 
47
</howto/deployment/modpython>`, the predecessor to mod_wsgi. Additionally, Django
50
48
follows the WSGI_ spec, which allows it to run on a variety of server platforms.
51
49
See the `server-arrangements wiki page`_ for specific installation instructions
52
50
for each platform.
90
88
  If you're on Windows, check out the unofficial `compiled Windows version`_.
91
89
 
92
90
* If you're using MySQL, you'll need MySQLdb_, version 1.2.1p2 or higher. You
93
 
  will also want to read the database-specific notes for the :ref:`MySQL
94
 
  backend <ref-databases>`.
 
91
  will also want to read the database-specific notes for the :doc:`MySQL
 
92
  backend </ref/databases>`.
95
93
 
96
94
* If you're using SQLite and Python 2.4, you'll need pysqlite_. Use version
97
95
  2.0.3 or higher. Python 2.5 ships with an SQLite wrapper in the standard
115
113
``ALTER TABLE`` privileges during ``syncdb`` but won't issue
116
114
``ALTER TABLE`` statements on a table once ``syncdb`` has created it.
117
115
 
118
 
If you're using Django's :ref:`testing framework<topics-testing>` to test database queries,
 
116
If you're using Django's :doc:`testing framework</topics/testing>` to test database queries,
119
117
Django will need permission to create a test database.
120
118
 
121
119
.. _PostgreSQL: http://www.postgresql.org/
177
175
Installing a distribution-specific package
178
176
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
179
177
 
180
 
Check the :ref:`distribution specific notes <misc-distributions>` to see if your
 
178
Check the :doc:`distribution specific notes </misc/distributions>` to see if your
181
179
platform/distribution provides official Django packages/installers.
182
180
Distribution-provided packages will typically allow for automatic installation
183
181
of dependencies and easy upgrade paths.
265
263
      Apache configuration file.
266
264
 
267
265
      More information about deployment is available, of course, in our
268
 
      :ref:`How to use Django with mod_python <howto-deployment-modpython>`
 
266
      :doc:`How to use Django with mod_python </howto/deployment/modpython>`
269
267
      documentation.
270
268
 
271
269
4. On Unix-like systems, create a symbolic link to the file