Opened 10 years ago
Closed 10 years ago
#23037 closed Uncategorized (wontfix)
clarification on windows install and setup detail
Reported by: | Owned by: | nobody | |
---|---|---|---|
Component: | Documentation | Version: | dev |
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
- find the site-packages directory in your python install with the shell command - [python -c "import site; print(site.getsitepackages())"]
- cd to that site-packages directory
- in shell - [git clone https://github.com/django/django.git django-trunk]
- still in shell - [cd django-trunk]
- 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 by , 10 years ago
comment:2 by , 10 years ago
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 by , 10 years ago
Resolution: | → wontfix |
---|---|
Status: | new → 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.
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.