Code

Opened 7 years ago

Closed 7 years ago

#3902 closed (fixed)

Add installation docs for Windows users

Reported by: yary h <not.com@…> Owned by: nobody
Component: Documentation Version: master
Severity: Keywords:
Cc: Triage Stage: Ready for checkin
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: UI/UX:

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 (1)

install.diff (4.9 KB) - added by nick@… 7 years ago.
Patch for install.txt to provide more detailed instructions for Windows users

Download all attachments as: .zip

Change History (7)

comment:1 Changed 7 years ago by Simon G. <dev@…>

  • Needs documentation unset
  • Needs tests unset
  • Patch needs improvement unset
  • Summary changed from Web docs for "Installing the official version" doesn't work for Windows to Add installation docs for Windows users
  • Triage Stage changed from Unreviewed to Accepted

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

comment:2 Changed 7 years ago 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!

comment:3 Changed 7 years ago 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).

comment:4 Changed 7 years ago by nick@…

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

Changed 7 years ago by nick@…

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

comment:5 Changed 7 years ago by SmileyChris

  • Has patch set
  • Triage Stage changed from Accepted to Ready for checkin

Good stab, Nick.

comment:6 Changed 7 years ago by mtredinnick

  • Resolution set to fixed
  • Status changed from new to closed

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

Add Comment

Modify Ticket

Change Properties
<Author field>
Action
as closed
as The resolution will be set. Next status will be 'closed'
The resolution will be deleted. Next status will be 'new'
Author


E-mail address and user name can be saved in the Preferences.

 
Note: See TracTickets for help on using tickets.