correct code-block highlighting and link formatting

diff --git a/docs/starting/install/linux.rst b/docs/starting/install/linux.rst
index a3d88bf..06aeb9e 100644 (file)
--- a/docs/starting/install/linux.rst
+++ b/docs/starting/install/linux.rst
@@ -22,14 +22,15 @@ command. It also enables you to add this network installation capability to
 your own Python software with very little work.
 
 To obtain the latest version of Distribute for Linux, run the python script
-available here:
-    http://python-distribute.org/distribute_setup.py
+available here: `python-distribute <http://python-distribute.org/distribute_setup.py>`_
 
 The new``easy_install`` command you have available is considered by many to be
 deprecated, so we will install its replacement: **pip**. Pip allows for
 uninstallation of packages, and is actively maintained, unlike easy_install.
 
-To install pip, simply open a command prompt and run::
+To install pip, simply open a command prompt and run
+
+.. code-block:: console
 
     $ easy_install pip
 
@@ -38,7 +39,9 @@ Virtualenv
 ----------
 
 After Distribute & Pip, the next development tool that you should install is
-`virtualenv <http://pypi.python.org/pypi/virtualenv/>`_. Use pip::
+`virtualenv <http://pypi.python.org/pypi/virtualenv/>`_. Use pip
+
+.. code-block:: console
 
     $ pip install virtualenv
 
@@ -51,7 +54,9 @@ framework and application will have many dependencies.
 
 To set up a new Python environment, change the working directory to where ever
 you want to store the environment, and run the virtualenv utility in your
-project's directory::
+project's directory
+
+.. code-block:: console
 
     $ virtualenv --distribute venv
 

diff --git a/docs/starting/install/osx.rst b/docs/starting/install/osx.rst
index 006f2e0..ec8c9a8 100644 (file)
--- a/docs/starting/install/osx.rst
+++ b/docs/starting/install/osx.rst
@@ -29,13 +29,17 @@ Linux systems will notice one key component missing: a decent package manager.
 `Homebrew <http://mxcl.github.com/homebrew/>`_ fills this void.
 
 To `install Homebrew <https://github.com/mxcl/homebrew/wiki/installation>`_,
-simply run::
+simply run
+
+.. code-block:: console
 
     $ ruby -e "$(curl -fsS https://raw.github.com/mxcl/homebrew/master/Library/Contributions/install_homebrew.rb)"
 
 Then, insert the hombrew directory at the top of your ``PATH`` enviornment
 variable. You can do this by adding the following line at the bottom of your
-``~/.bashrc`` file::
+``~/.bashrc`` file
+
+.. code-block:: console
 
     export PATH=/usr/local/bin:$PATH
 
@@ -44,7 +48,9 @@ Now, we can install Python 2.7: ::
     $ brew install python --framework
 
 This will take a minute or two. Once that's complete, you'll have to add the
-new Python scripts directory to your ``PATH``::
+new Python scripts directory to your ``PATH``
+
+.. code-block:: console
 
     export PATH=/usr/local/share/python:$PATH
 
@@ -69,7 +75,9 @@ considered by many to be deprecated, so we will install its replacement:
 **pip**. Pip allows for uninstallation of packages, and is actively maintained,
 unlike easy_install.
 
-To install pip, simply open a command prompt and run::
+To install pip, simply open a command prompt and run
+
+.. code-block:: console
 
     $ easy_install pip
 
@@ -78,7 +86,9 @@ Virtualenv
 ----------
 
 After Distribute & Pip, the next development tool that you should install is
-`virtualenv <http://pypi.python.org/pypi/virtualenv/>`_. Use pip::
+`virtualenv <http://pypi.python.org/pypi/virtualenv/>`_. Use pip
+
+.. code-block:: console
 
     $ pip install virtualenv
 
@@ -91,7 +101,9 @@ framework and application will have many dependencies.
 
 To set up a new Python environment, change the working directory to where ever
 you want to store the environment, and run the virtualenv utility in your
-project's directory::
+project's directory
+
+.. code-block:: console
 
     $ virtualenv --distribute venv
 

diff --git a/docs/starting/install/win.rst b/docs/starting/install/win.rst
index c6ec8b9..5ce42f7 100644 (file)
--- a/docs/starting/install/win.rst
+++ b/docs/starting/install/win.rst
@@ -45,8 +45,7 @@ command. It also enables you to add this network installation capability to
 your own Python software with very little work.
 
 To obtain the latest version of Distribute for Windows, run the python script
-available here:
-  http://python-distribute.org/distribute_setup.py
+available here: `python-distribute <http://python-distribute.org/distribute_setup.py>`_
 
 
 You'll now have a new command available to you: **easy_install**. It is
@@ -54,7 +53,9 @@ considered by many to be deprecated, so we will install its replacement:
 **pip**. Pip allows for uninstallation of packages, and is actively maintained,
 unlike easy_install.
 
-To install pip, simply open a command prompt and run::
+To install pip, simply open a command prompt and run
+
+.. code-block:: console
 
     > easy_install pip
 
@@ -63,7 +64,9 @@ Virtualenv
 ----------
 
 After Distribute & Pip, the next development tool that you should install is
-`virtualenv <http://pypi.python.org/pypi/virtualenv/>`_. Use pip::
+`virtualenv <http://pypi.python.org/pypi/virtualenv/>`_. Use pip
+
+.. code-block:: console
 
     > pip install virtualenv
 
@@ -77,7 +80,9 @@ framework and application will have many dependencies.
 
 To set up a new Python environment, change the working directory to where ever
 you want to store the environment, and run the virtualenv utility in your
-project's directory::
+project's directory
+
+.. code-block:: console
 
     > virtualenv --distribute venv