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

@ -11,4 +11,5 @@ Django FAQ
help
models
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
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
@ -78,13 +79,6 @@ This will create a ``mysite`` directory in your current directory.
``django`` (which will conflict with Django itself) or ``test`` (which
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?
If your background is in PHP, you're probably used to putting code under the