Fixed #25584 -- Documented a pip error when installing Django 1.9.

This commit is contained in:
Tim Graham 2015-10-21 14:59:03 -04:00
parent 8b5acda821
commit ee66d8dd7d
2 changed files with 25 additions and 1 deletions

View File

@ -1012,6 +1012,29 @@ a Django application with this structure::
jquery.js jquery.js
jquery.min.js jquery.min.js
.. _syntax-error-old-pip-django-19:
``SyntaxError`` when installing Django with pip ≤ 1.5.6
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
When installing Django 1.9+ with pip ≤ 1.5.6, you'll see::
Compiling django/conf/app_template/apps.py ...
File "django/conf/app_template/apps.py", line 4
class {{ camel_case_app_name }}Config(AppConfig):
^
SyntaxError: invalid syntax
Compiling django/conf/app_template/models.py ...
File "django/conf/app_template/models.py", line 1
{{ unicode_literals }}from django.db import models
^
SyntaxError: invalid syntax
It's safe to ignore these errors (Django will still install just fine), and you
can avoid them by upgrading pip to a more recent version using
``pip install -U pip``.
Miscellaneous Miscellaneous
~~~~~~~~~~~~~ ~~~~~~~~~~~~~

View File

@ -165,7 +165,8 @@ This is the recommended way to install Django.
1. Install pip_. The easiest is to use the `standalone pip installer`_. If your 1. Install pip_. The easiest is to use the `standalone pip installer`_. If your
distribution already has ``pip`` installed, you might need to update it if distribution already has ``pip`` installed, you might need to update it if
it's outdated. (If it's outdated, you'll know because installation won't it's outdated. (If it's outdated, you'll know because installation won't
work.) work. You might see some :ref:`harmless SyntaxErrors
<syntax-error-old-pip-django-19>` also.)
2. Take a look at virtualenv_ and virtualenvwrapper_. These tools provide 2. Take a look at virtualenv_ and virtualenvwrapper_. These tools provide
isolated Python environments, which are more practical than installing isolated Python environments, which are more practical than installing