aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorWaylan Limberg <waylan@gmail.com>2012-03-07 07:04:23 -0500
committerWaylan Limberg <waylan@gmail.com>2012-03-07 07:14:23 -0500
commit7060a42a9f9e4941c30a12c019db830bc754da63 (patch)
tree2e14fe6f6972daef1de1ecaa90415251d733ef0b /docs
parentbbdbde59f7edde5df5630308fbffd657b3c26f60 (diff)
downloadmarkdown-7060a42a9f9e4941c30a12c019db830bc754da63.tar.gz
markdown-7060a42a9f9e4941c30a12c019db830bc754da63.tar.bz2
markdown-7060a42a9f9e4941c30a12c019db830bc754da63.zip
Rewrote parts of install docs for clarity.
Diffstat (limited to 'docs')
-rw-r--r--docs/install.md52
1 files changed, 27 insertions, 25 deletions
diff --git a/docs/install.md b/docs/install.md
index a7e7ff0..cb20a73 100644
--- a/docs/install.md
+++ b/docs/install.md
@@ -7,28 +7,11 @@ next_url: reference.html
Installing Python-Markdown
==========================
-Checking Dependencies
----------------------
-
-Python-Markdown requires the ElementTree module to be installed. In Python2.5+
-ElementTree is included as part of the standard library. For earlier versions
-of Python, open a Python shell and type the following:
-
- >>> import cElementTree
- >>> import ElementTree
-
-If at least one of those does not generate any errors, then you have a working
-copy of ElementTree installed on your system. As cElementTree is faster, you
-may want to install that if you don't already have it and it's available for
-your system.
-
-See <http://effbot.org/zone/element-index.htm> for more information or to
-download the latest version of ElementTree.
-
The Easy Way
------------
-As an Admin/Root user on your system do:
+The easiest way to install Python-Markdown is simply to type one of the
+following commands from the command line as an Admin/Root user:
pip install markdown
@@ -36,23 +19,27 @@ or
easy_install markdown
+That's it! Your ready to [use](reference.html) Python-Markdown. Enjoy!
+
Installing on Windows
---------------------
-Download the Windows installer (.exe) from PyPI:
-<http://pypi.python.org/pypi/Markdown>
+Download the Windows installer (.exe) from
+[PyPI](http://pypi.python.org/pypi/Markdown)
Double-click the file and follow the instructions.
If you prefer to manually install Python-Markdown in Windows, download the
-Zip file, unzip it, and on the command line in the directory you unzipped to:
+Zip file, unzip it, and on the command line in the directory you unzipped to,
+run the following command:
- python setup.py install
+ C://path/to/python.exe setup.py install
If you plan to use the provided command line script, you need to make sure your
script directory is on your system path. On a typical Python install of Windows
-the Scripts directory is `C:\Python25\Scripts\`. Adjust according to your
-system and add that to your system path.
+the Scripts directory is `C:\PythonXX\Scripts\` (were "XX" is the Python version
+number, i.e., "27"). Adjust the path according to your system and add to your
+system path.
Installing on *nix Systems
--------------------------
@@ -79,3 +66,18 @@ command line:
cd python-markdown
python setup.py install
+Dependencies
+------------
+
+Python-Markdown requires the ElementTree module to be installed. In Python 2.5+
+ElementTree is included as part of the standard library at
+`xml.etree.ElementTree` and/or `xml.etree.cElementTree`. For earlier versions
+of Python, the library needs to be installed. However, Python-Markdown's
+install script will automaticaly detect the missing library and download and
+install the "ElementTree" library for you if your system has internet access.
+If you would like to use the "cElementTree" library (which is faster), you can
+install it manually. Markdown will check for the faster "c" library first and
+fall back to the slower python implementation when it is not available.
+
+See <http://effbot.org/zone/element-index.htm> for more information or to
+download the latest version of ElementTree.