Django

Code

Ticket #3902 (closed: fixed)

Opened 2 years ago

Last modified 1 year ago

Add installation docs for Windows users

Reported by: yary h <not.com@gmail.com> Assigned to: nobody
Milestone: Component: Documentation
Version: SVN Keywords:
Cc: Triage Stage: Ready for checkin
Has patch: 1 Needs documentation: 0
Needs tests: 0 Patch needs improvement: 0

Description

The web page http://www.djangoproject.com/documentation/install has instructions for installing the official version which does not work for Windows- windows has no "sudo" and furthermore, "setup.py install" complains about \django\ having no init.py

Attachments

install.diff (4.9 kB) - added by nick@efford.org on 08/21/07 15:26:49.
Patch for install.txt to provide more detailed instructions for Windows users

Change History

04/02/07 17:10:13 changed by Simon G. <dev@simon.net.nz>

  • needs_better_patch changed.
  • stage changed from Unreviewed to Accepted.
  • summary changed from Web docs for "Installing the official version" doesn't work for Windows to Add installation docs for Windows users.
  • needs_tests changed.
  • needs_docs changed.

Can someone who uses windows write up a step by step install process?

05/29/07 11:13:59 changed by PenguinMan98 at usa dot net

  • version changed from SVN to 0.96.

OK, the thing wasn't written for windows so you have to account for 2 things. First, in the setup.py on line 24 you need to change:

package = dirpath[len_root_dir:].lstrip('/').replace('/', '.')

to:

package = dirpath[len_root_dir:].lstrip('\\').replace('\\', '.')

Next, you will have no doubt noticed that windows doesn't support 'sudo'. Just type 'setup.py install' on the command line.

That should do the trick!

05/29/07 20:51:40 changed by mtredinnick

Please attach a patch to the existing install.txt that is written against the most recent code (for example, setup.py was fixed quite a while ago to work with Windows).

08/21/07 15:26:01 changed by nick@efford.org

  • version changed from 0.96 to SVN.

The attached patch is a first stab at a more Windows-friendly install.txt. It doesn't add all that much to the docs, to be honest. Key changes are:

  • Explicit mention of (and links to) Windows tools that can untar the Django distribution
  • Explanation of how to run setup.py on Windows
  • Different approach suggested to installing the development version on Windows

The last point deserves some explanation. The current version of install.txt suggests that Windows users check out the trunk's django directory directly into site-packages. This patch suggests, instead, that Windows users check out all of the trunk, as do users of other platforms, and then that they include the path to the django directory in their PYTHONPATH environment variable (or, equivalently, define the PythonPath directive if using Apache and mod_python).

I realise this new approach isn't entirely foolproof, but I think it is best if users on all platforms can check out the development version in the same way.

08/21/07 15:26:49 changed by nick@efford.org

  • attachment install.diff added.

Patch for install.txt to provide more detailed instructions for Windows users

08/21/07 16:06:04 changed by SmileyChris

  • has_patch set to 1.
  • stage changed from Accepted to Ready for checkin.

Good stab, Nick.

09/14/07 03:04:07 changed by mtredinnick

  • status changed from new to closed.
  • resolution set to fixed.

(In [6178]) Fixed #3902 -- Added some excellent notes about installing Django on Windows. Thanks, nick@efford.org.

Add/Change #3902 (Add installation docs for Windows users)




Change Properties
Action