Add installation docs for Windows users

[yary h <not.com@…>]

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

[Simon G. <dev@…>]

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

[PenguinMan98 at usa dot net]

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!

[Malcolm Tredinnick]

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).

[nick@…]

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.

[nick@…]

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

[Chris Beaven]

Good stab, Nick.

[Malcolm Tredinnick]

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