Scrapy, a fast high-level web crawling & scraping framework for Python.
docs: installation instructions, mention conda in the beginning (closes #2475)
Elias Dornelesb6ab1ae9c3ff
diff --git a/docs/intro/install.rst b/docs/intro/install.rstindex 767749ec5..86387ef5e 100644--- a/docs/intro/install.rst+++ b/docs/intro/install.rst@@ -7,14 +7,25 @@ Installation guideInstalling Scrapy=================-Scrapy runs on Python 2.7 and Python 3.3 or above-(except on Windows where Python 3 is not supported yet).+Scrapy runs on Python 2.7 and Python 3.3 or above.-If you’re already familiar with installation of Python packages,+If you're using `Anaconda`_ or `Miniconda`_, you can install the package from+the `conda-forge`_ channel, which has up-to-date packages for Linux, Windows+and OS X.++To install Scrapy using ``conda``, run::++ conda install -c conda-forge scrapy++Alternatively, if you’re already familiar with installation of Python packages,you can install Scrapy and its dependencies from PyPI with::pip install Scrapy+Note that sometimes this may require solving compilation issues for some Scrapy+dependencies depending on your operating system, so be sure to check the+:ref:`intro-install-platform-notes`.+We strongly recommend that you install Scrapy in :ref:`a dedicated virtualenv <intro-using-virtualenv>`,to avoid conflicting with your system packages.@@ -108,42 +119,14 @@ Platform specific installation notesWindows--------* Install Python 2.7 from https://www.python.org/downloads/-- You need to adjust ``PATH`` environment variable to include paths to- the Python executable and additional scripts. The following paths need to be- added to ``PATH``::-- C:\Python27\;C:\Python27\Scripts\;-- To update the ``PATH`` open a Command prompt and run::-- c:\python27\python.exe c:\python27\tools\scripts\win_add2path.py-- Close the command prompt window and reopen it so changes take effect, run the- following command and check it shows the expected Python version::-- python --version--* Install `pywin32` from http://sourceforge.net/projects/pywin32/-- Be sure you download the architecture (win32 or amd64) that matches your system--* *(Only required for Python<2.7.9)* Install `pip`_ from- https://pip.pypa.io/en/latest/installing/-- Now open a Command prompt to check ``pip`` is installed correctly::+Though it's possible to install Scrapy on Windows using pip, we recommend you+to install `Anaconda`_ or `Miniconda`_ and use the package from the+`conda-forge`_ channel, which will avoid most installation issues.- pip --version+Once you've installed `Anaconda`_ or `Miniconda`_, install Scrapy with::-* At this point Python 2.7 and ``pip`` package manager must be working, let's- install Scrapy::-- pip install Scrapy+ conda install -c conda-forge scrapy-.. note::- Python 3 is not supported on Windows. This is because Scrapy core requirement Twisted does not support- Python 3 on Windows.Ubuntu 12.04 or above---------------------@@ -234,27 +217,8 @@ After any of these workarounds you should be able to install Scrapy::pip install Scrapy-Anaconda------------Using Anaconda is an alternative to using a virtualenv and installing with ``pip``.--.. note::-- For Windows users, or if you have issues installing through ``pip``, this is- the recommended way to install Scrapy.--If you already have `Anaconda`_ or `Miniconda`_ installed, the `conda-forge`_-community have up-to-date packages for Linux, Windows and OS X.--To install Scrapy using ``conda``, run::-- conda install -c conda-forge scrapy-.. _Python: https://www.python.org/.. _pip: https://pip.pypa.io/en/latest/installing/-.. _Control Panel: https://www.microsoft.com/resources/documentation/windows/xp/all/proddocs/en-us/sysdm_advancd_environmnt_addchange_variable.mspx.. _lxml: http://lxml.de/.. _parsel: https://pypi.python.org/pypi/parsel.. _w3lib: https://pypi.python.org/pypi/w3lib