forked from 0x2620/pandora
include copy of django_extension, dont install django from git
This commit is contained in:
parent
055018f12e
commit
3f7215035a
200 changed files with 14119 additions and 4 deletions
100
contrib/django_extensions/docs/installation_instructions.rst
Normal file
100
contrib/django_extensions/docs/installation_instructions.rst
Normal file
|
|
@ -0,0 +1,100 @@
|
|||
Installation instructions
|
||||
=========================
|
||||
|
||||
:synopsis: Installing django-extensions
|
||||
|
||||
|
||||
Download and installation
|
||||
-------------------------
|
||||
|
||||
Pip and easy_install
|
||||
^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
You can use pip or easy_install to install django-extensions::
|
||||
|
||||
$ pip install django-extensions
|
||||
|
||||
or::
|
||||
|
||||
$ easy_install django-extensions
|
||||
|
||||
Download
|
||||
^^^^^^^^
|
||||
|
||||
Download the latest packaged version from
|
||||
http://pypi.python.org/pypi/django-extensions/ and unpack it. Inside is a
|
||||
script called setup.py. Enter this command::
|
||||
|
||||
python setup.py install
|
||||
|
||||
...and the package will install automatically.
|
||||
|
||||
Installation
|
||||
^^^^^^^^^^^^
|
||||
|
||||
You will need to add the *django_extensions* application to the INSTALLED_APPS
|
||||
setting of your Django project *settings.py* file.::
|
||||
|
||||
INSTALLED_APPS = (
|
||||
...
|
||||
'django_extensions',
|
||||
)
|
||||
|
||||
This will make sure that Django finds the additional management commands
|
||||
provided by *django-extensions*.
|
||||
|
||||
The next time you invoke *./manage.py help* you should be able to see all the
|
||||
newly available commands.
|
||||
|
||||
Some command's or option's require additional applications or python libraries,
|
||||
for example:
|
||||
|
||||
* 'export_emails' will require the *python vobject* module to create vcard
|
||||
files.
|
||||
* 'graph_models' requires *pygraphviz* to render directly to image file.
|
||||
|
||||
If the given application or python library is not installed on your system (or
|
||||
not in the python path) the executed command will raise an exception and inform
|
||||
you of the missing dependency.
|
||||
|
||||
Version Control
|
||||
---------------
|
||||
|
||||
Django-extensions is hosted on github::
|
||||
|
||||
https://github.com/django-extensions/django-extensions
|
||||
|
||||
Source code can be accessed by performing a Git clone.
|
||||
|
||||
Tracking the development version of *django command extensions* should be
|
||||
pretty stable and will keep you up-to-date with the latests fixes.
|
||||
|
||||
The following command will check the application's source code out to a
|
||||
directory called *django-extensions*:
|
||||
|
||||
Git::
|
||||
|
||||
git clone git://github.com/django-extensions/django-extensions.git
|
||||
|
||||
You should either install the resulting project with *python setup.py install*
|
||||
or put it the *extensions* directory into your PYTHONPATH. The most common way
|
||||
is to symlink (junction, if you're on Windows) the extensions directory inside
|
||||
a directory which is on your PYTHONPATH, such as your Python installation's
|
||||
site-packages directory.
|
||||
|
||||
::
|
||||
|
||||
ln -sf /full/path/to/django-extensions/django_extensions /usr/lib/python2.7/site-packages/django_extensions
|
||||
|
||||
You can verify that the application is available on your PYTHONPATH by opening a Python interpreter and entering the following commands:
|
||||
|
||||
::
|
||||
|
||||
>>> import django_extensions
|
||||
>>> django_extensions.VERSION
|
||||
(0, 8)
|
||||
|
||||
Keep in mind that the current code in the git repository may be different from the
|
||||
packaged release. It may contain bugs and backwards-incompatible changes but most
|
||||
likely also new goodies to play with.
|
||||
|
||||
Loading…
Add table
Add a link
Reference in a new issue