2
0
Эх сурвалжийг харах

Revised Windows install instructions for Python 3.5.

Added instructions for installing virtualenv and virtualenvwrapper.
Tim Allen 9 жил өмнө
parent
commit
1ce11f6064

+ 50 - 38
docs/howto/windows.txt

@@ -2,62 +2,75 @@
 How to install Django on Windows
 How to install Django on Windows
 ================================
 ================================
 
 
-This document will guide you through installing Python and Django for basic
-usage on Windows. This is meant as a beginner's guide for users working on
-Django projects and does not reflect how Django should be installed when
-developing patches for Django itself.
+This document will guide you through installing Python 3.5 and Django on
+Windows. It also provides instructions for installing `virtualenv`_ and
+`virtualenvwrapper`_, which make it easier to work on Python projects. This is
+meant as a beginner's guide for users working on Django projects and does not
+reflect how Django should be installed when developing patches for Django
+itself.
 
 
-The steps in this guide have been tested with Windows 7 and 8. In other
-versions, the steps would be similar.
+The steps in this guide have been tested with Windows 7, 8, and 10. In other
+versions, the steps would be similar. You will need to be familiar with using
+the Windows command prompt.
 
 
 Install Python
 Install Python
 ==============
 ==============
 
 
 Django is a Python web framework, thus requiring Python to be installed on your
 Django is a Python web framework, thus requiring Python to be installed on your
-machine.
+machine. At the time of writing, Python 3.5 is the latest version.
 
 
-To install Python on your machine go to https://python.org/download/, and
-download a Windows MSI installer for Python. Once downloaded, run the MSI
-installer and follow the on-screen instructions.
+To install Python on your machine go to https://python.org/downloads/. The Web
+site should offer you a download button for the latest Python version. Download
+the executable installer and run it. Check the box next to ``Add Python 3.5 to
+PATH`` and then click ``Install Now``.
 
 
-After installation, open the command prompt and check the Python version by
-executing ``python --version``. If you encounter a problem, make sure you
-have set the ``PATH`` variable correctly. You might need to adjust your
-``PATH`` environment variable to include paths to the Python executable and
-additional scripts. For example, if your Python is installed in
-``C:\Python34\``, the following paths need to be added to ``PATH``::
+After installation, open the command prompt and check that the Python version
+matches the version you installed by executing::
 
 
-    C:\Python34\;C:\Python34\Scripts;
+    python --version
 
 
-Install Setuptools
-==================
+About pip
+=========
 
 
-To install Python packages on your computer, Setuptools is needed. Download the
-latest version of `Setuptools <https://pypi.python.org/pypi/setuptools>`_ for
-your Python version and follow the installation instructions given there.
+`pip`_ is a package manage for Python. It makes installing and uninstalling
+Python packages (such as Django!) very easy. For the rest of the installation,
+we'll use ``pip`` to install Python packages from the command line.
 
 
-Install PIP
-===========
+.. _pip: https://pypi.python.org/pypi/pip
 
 
-`PIP <https://pip.pypa.io/>`_ is a package manager for Python that
-uses the `Python Package Index <https://pypi.python.org>`_ to install Python
-packages. PIP will later be used to install Django from PyPI. If you've
-installed Python 3.4, ``pip`` is included so you may skip this section.
+Install ``virtualenv`` and ``virtualenvwrapper``
+================================================
 
 
-Open a command prompt and execute ``easy_install pip``. This will install
-``pip`` on your system. This command will work if you have successfully
-installed Setuptools.
+`virtualenv`_ and `virtualenvwrapper`_ provide a dedicated environment for
+each Django project you create. While not mandatory, this is considered a best
+practice and will save you time in the future when you're ready to deploy your
+project. Simply type::
 
 
-Alternatively, go to `<https://pip.pypa.io/en/latest/installing.html>`_
-for installing/upgrading instructions.
+    pip install virtualenvwrapper-win
+
+Then create a virtual environment for your project::
+
+    mkvirtualenv myproject
+
+The virtual environment will be activated automatically and you'll see
+"(myproject)" next to the command prompt to designate that. If you start a new
+command prompt, you'll need to activate the environment again using::
+
+    workon myproject
+
+.. _virtualenv: https://pypi.python.org/pypi/virtualenv
+.. _virtualenvwrapper: https://pypi.python.org/pypi/virtualenvwrapper-win
 
 
 Install Django
 Install Django
 ==============
 ==============
 
 
 Django can be installed easily using ``pip``.
 Django can be installed easily using ``pip``.
 
 
-In the command prompt, execute the following command: ``pip install django``.
-This will download and install Django.
+In the command prompt, execute the following command::
+
+    pip install django
+
+This will download and install the latest Django release.
 
 
 After the installation has completed, you can verify your Django installation
 After the installation has completed, you can verify your Django installation
 by executing ``django-admin --version`` in the command prompt.
 by executing ``django-admin --version`` in the command prompt.
@@ -75,9 +88,8 @@ Common pitfalls
   than one Python version installed.
   than one Python version installed.
 
 
 * If you are connecting to the internet behind a proxy, there might be problem
 * If you are connecting to the internet behind a proxy, there might be problem
-  in running the commands ``easy_install pip`` and ``pip install django``.
-  Set the environment variables for proxy configuration in the command prompt
-  as follows::
+  in running the command ``pip install django``. Set the environment variables
+  for proxy configuration in the command prompt as follows::
 
 
     set http_proxy=http://username:password@proxyserver:proxyport
     set http_proxy=http://username:password@proxyserver:proxyport
     set https_proxy=https://username:password@proxyserver:proxyport
     set https_proxy=https://username:password@proxyserver:proxyport