Add reportlab as a dependency in setup.py.

Author: tshead2

docs/anaconda-installation.rst

@@ -0,0 +1,25 @@
+.. image:: ../artwork/toyplot.png
+  :width: 200px
+  :align: right
+
+.. _anaconda-installation:
+
+Anaconda Installation
+=====================
+
+Whether you’re new to Python or an old hand, we highly recommend installing
+`Anaconda <https://www.continuum.io/downloads>`_. Anaconda includes and
+conveniently installs Python and other commonly used packages for scientific
+computing and data science, including most of Toyplot's dependencies.
+
+With Anaconda installed, do the following to install Toyplot::
+
+    $ conda install pip numpy multipledispatch reportlab
+    $ pip install toyplot
+
+Note that there is a Conda package for Toyplot, but (as of this writing) it's fairly
+out of date ... see the package information at
+
+https://binstar.org/melund/toyplot
+
+and (in the nicest way possible) let the Anaconda maintainers know you're using Toyplot!

docs/conda-installation.rst

@@ -10,7 +10,9 @@ Dependencies
 Required
 --------
 
-To use Toyplot you'll need the following:
+To use Toyplot you'll need the following (if you install Toyplot using pip,
+these are automatically installed for you):
+
 
 * Python 2.7 / Python 3 - http://python.org
 * colormath - https://github.com/gtaylor/python-colormath
@@ -20,8 +22,9 @@ To use Toyplot you'll need the following:
 PDF Export
 ----------
 
-If you intend to generate static PDF versions of your Toyplot figures, you'll need
-the following:
+To generate static PDF versions of your Toyplot figures, the following is
+required (if you install Toyplot using pip, it's automatically installed for
+you):
 
 * ReportLab - open source PDF toolkit - http://www.reportlab.com/opensource/
 

docs/dependencies.rst

@@ -27,8 +27,8 @@ Documentation
    ethos.rst
    features.rst
    compatibility.rst
-   dependencies.rst
    installation.rst
+   dependencies.rst
    tutorial.rst
    user-guide.rst
    contributing.rst

docs/index.rst

@@ -7,19 +7,23 @@
 Installation
 ============
 
-Using Your OS Package Manager
+Using a Package Manager
 -----------------------------
 
-Your operating system package manage manager (apt, yum, MacPorts, etc) should
-be your first stop for installing Toyplot - using your package manager will
-make it easy to install Toyplot and its dependencies, keep them up-to-date, and
-even (gasp!) uninstall them cleanly.  If your package manager doesn't support
-Toyplot yet, drop them a line and let them know you'd like them to add it!
+A package manager (conda, apt, yum, MacPorts, etc) should generally be your
+first stop for installing Toyplot - it will make it easy to install Toyplot and
+its dependencies, keep them up-to-date, and even (gasp!) uninstall them
+cleanly.  If your package manager doesn't support Toyplot yet, drop them a line
+and let them know you'd like them to add it!
+
+If you're new to Python or unsure where to start, we strongly recommend taking
+a look at :ref:`Anaconda <anaconda-installation>`, which the Toyplot developers
+use during their day-to-day work.
 
 .. toctree::
   :maxdepth: 2
 
-  conda-installation.rst
+  anaconda-installation.rst
   freebsd-installation.rst
   macports-installation.rst
 
@@ -28,13 +32,16 @@ Using Pip / Easy Install
 
 If your package manager doesn't support Toyplot, or doesn't have the latest
 version, your next option should be Python setup tools like `pip`.  You can
-always install the latest stable version of toyplot and its **required**
-:ref:`dependencies` with::
+always install the latest stable version of toyplot and its required
+dependencies using::
 
     $ pip install toyplot
 
-To install Toyplot's **optional** :ref:`dependencies`, you'll need to use a combination
-of pip and your system package manager.
+... following that, you'll be able to use all of Toyplot's features, and export
+figures to all of Toyplot's preferred file formats, including HTML, SVG, and PDF.
+
+For export to other formats like PNG or MP4, you'll have to install additional resources
+listed in the :ref:`dependencies` section of the manual.
 
 .. _From Source:
 
@@ -48,5 +55,9 @@ you can install it using the source code::
     $ cd toyplot
     $ sudo python setup.py install
 
-The setup script copies Toyplot into your Python site-packages directory, and
-it's ready to go.
+The setup script installs Toyplot's required dependencies and copies Toyplot into
+your Python site-packages directory, ready to go.
+
+Once again, export to other formats like PNG or MP4, wil require additional resources
+listed in :ref:`dependencies`.
+

docs/installation.rst

@@ -16,15 +16,16 @@ Toyplot using pip::
     $ sudo port install py27-colormath
     $ sudo port install py27-multipledispatch
     $ sudo port install py27-numpy
+    $ sudo port install py27-reportlab
     $ sudo port install py27-pip
     $ sudo port select --set pip pip27
     $ sudo pip install toyplot
 
-If you want to generate PDF / PNG files using PyQt5::
+If you want to generate PNG files using PyQt5::
 
     $ sudo port install py27-pyqt5
 
-If you want to generate PDF / PNG files using cairo::
+If you want to generate PNG files using cairo::
 
     $ sudo port install py27-pygtk
 

docs/macports-installation.rst

@@ -25,6 +25,7 @@
         "colormath",
         "multipledispatch",
         "numpy>=1.7",
+        "reportlab",
     ],
     long_description="""Toyplot is the kid-sized plotting toolkit for Python with grownup-sized goals:
   * Develop beautiful interactive, animated plots that embrace the unique capabilities of electronic publishing and support repoducibility.