Ticket #16205: 16205.diff

File 16205.diff, 4.4 KB (added by Stephen Burrows, 13 years ago)

  • docs/howto/index.txt 

    diff --git a/docs/howto/index.txt b/docs/howto/index.txt
index 49d0644..6743456 100644
    a b you quickly accomplish common tasks.  
    2424   outputting-csv
    2525   outputting-pdf
    2626   static-files
     27   windows
    2728
    2829.. seealso::
    2930

  • new file docs/howto/windows.txt 

    diff --git a/docs/howto/windows.txt b/docs/howto/windows.txt
new file mode 100644
index 0000000..8d593d4
    - +  
     1================================
     2How to install Django on Windows
     3================================
     4
     5This document will guide you through installing Django and Python for
     6basic usage on Windows. This is meant as a beginners guide for users doing
     7development of Django projects and does not reflect how Django should be
     8installed for production environments.
     9
     10Install Python
     11==============
     12
     13Django is a Python web framework, thus requiring Python installed on your
     14machine.
     15
     16To install Python on your machine go to http://python.org/download/, and
     17download a Windows MSI installer for Python 2.x (eg. 2.7.1). Django does not
     18currently run on Python 3.x. lSee the :doc:`the Django FAQ </faq/install>`
     19for more information.
     20
     21Once downloaded, run the MSI installer and follow the on screen instructions.
     22
     23Install Setuptools
     24~~~~~~~~~~~~~~~~~~
     25
     26To install other python software on your computer, setuptools is needed.
     27Download the latest installer for your Python version from
     28http://pypi.python.org/pypi/setuptools#files. Run the installer and follow
     29the on screen instructions.
     30
     31Adding Python to PATH
     32~~~~~~~~~~~~~~~~~~~~~
     33
     34To be able to execute Python, and related scripts, the directory where
     35you installed Python, and the *Scripts* sub directory,
     36must be on PATH. Only the approach for Windows 7 will be explained,
     37but the other versions of Windows have similar approaches.
     38
     39* Click the Windows button.
     40
     41* Right click on *Computer* and choose *Properties*.
     42
     43* Click *Advanced System Settings* at the bottom of the list on the left side
     44  of the opened window.
     45
     46* Click *Environment Variables* at the bottom
     47
     48* Find the *Path* variable in the list of *System variables*,
     49  select it and click the *Edit...* button.
     50
     51* The *Variable value* is a semi colon separated list of directories. Make
     52  sure both the install directory and the *Scripts* directory is in this list.
     53  If not, add them to the end of the list (*C:\\Python27;
     54  C:\\Python27\\Scripts*)
     55
     56* Click *OK* to save the changes.
     57
     58Install PIP
     59===========
     60
     61`PIP <http://www.pip-installer.org/>`_ is a package manager for Python that
     62uses the `Python Package Index <http://pypi.python.org>`_ to install Python
     63packages. PIP will later be used to install Django from PYPI.
     64
     65* Open a command prompt. If you installed Python to a directory where only
     66  administrators have write access, the command prompt need to be run as an
     67  administrator user.
     68
     69* Execute the following command ``easy_install pip``
     70
     71PIP should now be installed.
     72
     73Database
     74========
     75
     76From Python version 2.5 SQLite is included in the package. This means that, for
     77local development, it is normally not needed to install other databases. If
     78you want to use another database, like PostgreSQL, MySQL etc.,
     79you are free to install it as well.
     80
     81Install Django
     82==============
     83
     84Finally Django can be installed quite easily with PIP.
     85
     86In the same command prompt that you used to install PIP,
     87execute the following command: ``pip install django``. This will download and
     88install Django.
     89
     90After the installation has completed, you can verify your Django installation
     91by execution ``django-admin.py --version`` in the command prompt.
     92
     93Common pitfalls
     94===============
     95
     96* If ``django-admin.py`` only displays the help text, no matter what arguments
     97  it is given, there are probably a problem with the file association in
     98  Windows. See the solution on `Stackoverflow <http://stackoverflow
     99  .com/questions/2640971/windows-is-not-passing-command-line-arguments-to-
     100  python-programs-executed-from-th>`_
     101

  • docs/topics/install.txt 

    diff --git a/docs/topics/install.txt b/docs/topics/install.txt
index 46d6615..ae3c8d4 100644
    a b probably already have it installed.  
    2424
    2525.. _jython: http://jython.org/
    2626
     27.. admonition:: Django on Windows
     28
     29    If you are just starting with Django and using Windows, you may find
     30    :doc:`/howto/windows` useful.
     31
    2732Install Apache and mod_wsgi
    2833=============================
    2934
Back to Top