p15693087
/
django
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Fixed #3902 -- Added some excellent notes about installing Django on Windows. Thanks, nick@efford.org. 

git-svn-id: http://code.djangoproject.com/svn/django/trunk@6178 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Malcolm Tredinnick 2007-09-14 08:04:07 +00:00
parent 99d12c5d70
commit 518bc15b21
1 changed files with 43 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

61
docs/install.txt
View File

@ -127,16 +127,24 @@ Installing an official release
1. Download the latest release from our `download page`_. 1. Download the latest release from our `download page`_.
2. Untar the downloaded file (e.g. ``tar xzvf Django-NNN.tar.gz``). 2. Untar the downloaded file (e.g. ``tar xzvf Django-NNN.tar.gz``,
where ``NNN`` is the version number of the latest release).
If you are a Windows user, you can download the command-line tool
bsdtar_ to do this, or you can use a GUI-based tool such as 7-zip_.
3. Change into the downloaded directory (e.g. ``cd Django-NNN``). 3. Change into the directory created in step 2 (e.g. ``cd Django-NNN``).
4. Run ``sudo python setup.py install``. 4. If you are using Linux, Mac OSX or some other flavour of Unix, enter
the command``sudo python setup.py install`` at the shell prompt.
If you are using Windows, start up a command shell with administrator
privileges and run the command ``setup.py install``.
The command will install Django in your Python installation's ``site-packages`` These commands will install Django in your Python installation's
directory. ``site-packages`` directory.
.. _distribution specific notes: ../distributions/ .. _distribution specific notes: ../distributions/
.. _bsdtar: http://gnuwin32.sourceforge.net/packages/bsdtar.htm
.. _7-zip: http://www.7-zip.org/
Installing the development version Installing the development version
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -144,34 +152,51 @@ Installing the development version
If you'd like to be able to update your Django code occasionally with the If you'd like to be able to update your Django code occasionally with the
latest bug fixes and improvements, follow these instructions: latest bug fixes and improvements, follow these instructions:
1. Make sure you have Subversion_ installed. 1. Make sure that you have Subversion_ installed, and that you can run its
2. Check out the Django code into your Python ``site-packages`` directory. commands from a shell. (Enter ``svn help`` at a shell prompt to test
this.)
On Linux / Mac OSX / Unix, do this:: 2. Check out Django's main development branch (the 'trunk') like so::
svn co http://code.djangoproject.com/svn/django/trunk/ django_src svn co http://code.djangoproject.com/svn/django/trunk/ django-trunk
ln -s `pwd`/django_src/django SITE-PACKAGES-DIR/django
3. Next, you need to make sure that the Python interpreter can load Django's
code. There are various ways of accomplishing this. One of the most
convenient, on Linux, Mac OSX or other Unix-like systems, is to use a
symbolic link::
ln -s `pwd`/django-trunk/django SITE-PACKAGES-DIR/django
(In the above line, change ``SITE-PACKAGES-DIR`` to match the location of (In the above line, change ``SITE-PACKAGES-DIR`` to match the location of
your system's ``site-packages`` directory, as explained in the your system's ``site-packages`` directory, as explained in the
"Where are my ``site-packages`` stored?" section above.) "Where are my ``site-packages`` stored?" section above.)
On Windows, do this:: Alternatively, you can define your ``PYTHONPATH`` environment variable
so that it includes the ``django`` subdirectory of ``django-trunk``.
This is perhaps the most convenient solution on Windows systems, which
don't support symbolic links. (Environment variables can be defined on
Windows systems `from the Control Panel`_.)
svn co http://code.djangoproject.com/svn/django/trunk/django c:\Python24\lib\site-packages\django .. admonition:: What about Apache and mod_python?
3. Copy the file ``django_src/django/bin/django-admin.py`` to somewhere on your If you are using Apache and mod_python rather than Django's
system path, such as ``/usr/local/bin`` (Unix) or ``C:\Python24\Scripts`` development server, then instead of defining the ``PYTHONPATH``
shell environment variable, you will need to specify the
``PythonPath`` directive in your Apache configuration file.
4. Copy the file ``django-trunk/django/bin/django-admin.py`` to somewhere on
your system path, such as ``/usr/local/bin`` (Unix) or ``C:\Python24\Scripts``
(Windows). This step simply lets you type ``django-admin.py`` from within (Windows). This step simply lets you type ``django-admin.py`` from within
any directory, rather than having to qualify the command with the full path any directory, rather than having to qualify the command with the full path
to the file. to the file.
You *don't* have to run ``python setup.py install``, because that command You *don't* have to run ``python setup.py install``, because you've already
takes care of steps 2 and 3 for you. carried out the equivalent actions in steps 3 and 4.
When you want to update your copy of the Django source code, just run the When you want to update your copy of the Django source code, just run the
command ``svn update`` from within the ``django`` directory. When you do this, command ``svn update`` from within the ``django-trunk`` directory. When you do
Subversion will automatically download any changes. this, Subversion will automatically download any changes.
.. _`download page`: http://www.djangoproject.com/download/ .. _`download page`: http://www.djangoproject.com/download/
.. _Subversion: http://subversion.tigris.org/ .. _Subversion: http://subversion.tigris.org/
.. _from the Control Panel: http://www.microsoft.com/resources/documentation/windows/xp/all/proddocs/en-us/sysdm_advancd_environmnt_addchange_variable.mspx