Opened 9 months ago

Closed 9 months ago

#23037 closed Uncategorized (wontfix)

clarification on windows install and setup detail

Reported by: jomtung@… Owned by: nobody
Component: Documentation Version: master
Severity: Normal Keywords: windows
Cc: Triage Stage: Unreviewed
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: yes UI/UX: no

Description

I noticed that the windows install for my own machine was confusing to figure out, but takes 3 minutes once going. I wrote a five step guide starting with python and git installed for a manual installation on windows using git. I'm using windows xp, python 2.7.8, git 1.9.4.msysgit.0

  1. find the site-packages directory in your python install with the shell command - [python -c "import site; print(site.getsitepackages())"]
  1. cd to that site-packages directory
  1. in shell - [git clone https://github.com/django/django.git django-trunk]
  1. still in shell - [cd django-trunk]
  1. now in the django-trunk directory in shell - [python setup.py install]

Also, I found a typo in the development version setup doc - https://docs.djangoproject.com/en/dev/intro/tutorial01/

The command shown - [$ django-admin.py startproject mysite] should be [$ django-admin startproject mysite] for 1.7 and above. The github repo shows the typo on line 56 - https://github.com/django/django/blob/master/docs/intro/tutorial01.txt.

Would it be quicker to submit a pull request for something this minor next time?

Thanks!
Tom

Change History (3)

comment:1 Changed 9 months ago by timo

  • Needs documentation unset
  • Needs tests unset
  • Patch needs improvement unset

Regarding the "how to install" guide, have you seen https://docs.djangoproject.com/en/dev/howto/windows/?

Regarding django-admin.py vs. django-admin, I think we can make that change, but I'm not positive there aren't any cases where it won't work. If it's fine, we should make the change throughout the docs and not just in the tutorial. Of course, we will probably get a lot of tickets from people using the wrong version of the docs.

comment:2 Changed 9 months ago by jomtung@…

Agreed on the typo confusion between doc version. Maybe a solution with less tickets would be to include a note for 1.7+ similar to the install tutorial note.

For the installation, I did follow the instruction on that link closely and didn't get any error when using the pip install, but when I tried the 'import django' command from the python prompt the module wasn't recognized. This lead me to some troubleshooting. After a while I uninstalled python completely. That was when I decided to use git to clone the django-trunk folder and run the 'python setup.py install' command like the manual linux install. It was quick and straightforward from that point so I thought you might want to add a windows manual install guide with these steps.

comment:3 Changed 9 months ago by timo

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

I created #23068 for updating to django-admin.

I think we want to recommend using pip to install Django, even the development version, e.g. https://docs.djangoproject.com/en/dev/topics/install/#installing-the-development-version

Unless there is some reason that doesn't work, let's avoid adding more Windows specific instructions.

Note: See TracTickets for help on using tickets.
Back to Top