Moved a note about django-admin.py errors from Tutorial Part 1 to a new FAQ Troubleshooting page. This is to avoid confusion for beginners.

This commit is contained in:
Angeline Tan 2012-08-04 15:05:57 -07:00 committed by Julien Phalip
parent 197863523a
commit 5d4f993bb1
3 changed files with 20 additions and 9 deletions

View File

@ -12,3 +12,4 @@ Django FAQ
models models
admin admin
contributing contributing
troubleshooting

View File

@ -0,0 +1,16 @@
===============
Troubleshooting
===============
This page contains some advice about errors and problems commonly encountered
during the development of Django applications.
"command not found: django-admin.py"
------------------------------------
:doc:`django-admin.py </ref/django-admin>` should be on your system path if you
installed Django via ``python setup.py``. If it's not on your path, you can
find it in ``site-packages/django/bin``, where ``site-packages`` is a directory
within your Python installation. Consider symlinking to :doc:`django-admin.py
</ref/django-admin>` from some place on your path, such as
:file:`/usr/local/bin`.

View File

@ -52,7 +52,8 @@ code, then run the following command:
django-admin.py startproject mysite django-admin.py startproject mysite
This will create a ``mysite`` directory in your current directory. This will create a ``mysite`` directory in your current directory. If it didn't
work, see :doc:`Troubleshooting </faq/troubleshooting>`.
.. admonition:: Script name may differ in distribution packages .. admonition:: Script name may differ in distribution packages
@ -78,13 +79,6 @@ This will create a ``mysite`` directory in your current directory.
``django`` (which will conflict with Django itself) or ``test`` (which ``django`` (which will conflict with Django itself) or ``test`` (which
conflicts with a built-in Python package). conflicts with a built-in Python package).
:doc:`django-admin.py </ref/django-admin>` should be on your system path if you
installed Django via ``python setup.py``. If it's not on your path, you can find
it in ``site-packages/django/bin``, where ``site-packages`` is a directory
within your Python installation. Consider symlinking to :doc:`django-admin.py
</ref/django-admin>` from some place on your path, such as
:file:`/usr/local/bin`.
.. admonition:: Where should this code live? .. admonition:: Where should this code live?
If your background is in PHP, you're probably used to putting code under the If your background is in PHP, you're probably used to putting code under the