diff --git a/docs/howto/windows.txt b/docs/howto/windows.txt index d36b62a6a6..aa35a4190e 100644 --- a/docs/howto/windows.txt +++ b/docs/howto/windows.txt @@ -2,62 +2,75 @@ 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 ============== 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 `_ 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 `_ is a package manager for Python that -uses the `Python Package Index `_ 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 ``_ -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 ============== 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 by executing ``django-admin --version`` in the command prompt. @@ -75,9 +88,8 @@ Common pitfalls than one Python version installed. * 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 https_proxy=https://username:password@proxyserver:proxyport