install landing page

Author: Kenneth Reitz

docs/starting/install/linux.rst

@@ -1,3 +1,5 @@
+.. _install-linux:
+
 Installing Python on Linux
 ==========================
 

docs/starting/install/osx.rst

@@ -1,3 +1,5 @@
+.. _install-osx:
+
 Installing Python on Mac OS X
 =============================
 

docs/starting/install/win.rst

@@ -1,3 +1,5 @@
+.. _install-windows:
+
 Installing Python on Windows
 ============================
 

docs/starting/installation.rst

@@ -1,86 +1,7 @@
 Properly Installing Python
 ==========================
 
-
-Windows
-:::::::
-
-
-
-Prerequisites:
---------------
-
-* Python2.7 (x86) from Python.org
-* Microsoft Visual Studio
-
-
-Step 1: Set PATH variables
---------------------------
-If you haven't set your PATH variables as part of the Python2.7 install, now is the time to do that. Right click on My Computer and select properties.
-
-* Click Advanced System Settings from left hand list (Advanced Tab on Windows XP)
-* Click Advanced System Settings from left hand list (On Windows XP click the Advanced Tab)
-* Click the Environment Variables button at the bottom
-* In the System variables section double click on the variable line named Path
-* Scroll to the end of the variable value field
-* add semicolon (;) if one doesn't exist and then type ``C:\Python27\;C:\Python27\Scripts\``
-
-Step 2: Install Distribute & Pip
---------------------------------
-
-**Distribute** is a fantastic drop-in replacement for **easy_install** and **setuptools**. It allows you to install and manage python packages from PyPi, amongst a few other sources.
-
-To install it, run the python script available here:
- <http://python-distribute.org/distribute_setup.py>
-
-**easy_install** is considered by many to be a deprecated system, so we will install it's replacement: **pip**. Pip allows for uninstallation of packages, and is actively maintained, unlike setuptool's easy_install.
-
-To install pip, simply open a command prompt and run: ::
-
- > easy_install pip
-
-
-Linux (Ubuntu)
-::::::::::::::
-
-Oneiric Ocelot, the latest version of Ubuntu, **comes with Python 2.7 out of the box**. Python 3.2 can be installed and run with the following commands::
-
- $ sudo apt-get install python3-minimal
- $ python3
-
-Older versions of Python aren't available from the official repository. However, if it's needed (for example to support legacy code), we can add an unsupported repository and install an older version of Python (2.5 in the example below)::
-
- $ sudo apt-get install python-software-properties
- $ sudo add-apt-repository ppa:fkrull/deadsnakes
- $ sudo apt-get update
- $ sudo apt-get install python2.5
-
-Installing setuptools and pip
------------------------------
-
-While Python has an extensive standard library, the set of packages available from the Internet is even more extensive. In order to install them easily, we'll install the ``distribute`` package and then ``pip``::
-
- $ wget http://python-distribute.org/distribute_setup.py
- $ sudo python distribute_setup.py
- $ sudo easy_install pip
-
-Now, most Python packages can be installed using the ``pip`` command. For example, if we wanted to install Django::
-
- $ sudo pip install django
-
-A full list of ``pip``'s capabilities is available by typing ``pip --help``.
-
-Linux (Manual)
---------------
-
-While your system will quite likely already have Python installation, you might wish to install a different version. This is done in the typical Linux software source install procedure::
-
- $ wget http://www.python.org/ftp/python/2.7.2/Python-2.7.2.tgz
- $ tar -xvf Python-2.7.2.tgz
- $ cd Python-2.7.2
- $ ./configure
- $ make
- $ make install
-
-
+- :ref:`Mac OS X <install-osx>`.
+- :ref:`Microsoft Windows<install-windows>`.
+- :ref:`Ubuntu Linux <install-linux>`.