Updated graph_reference, fixed LONG output in notebooks w/ html.

Author: theengineear

README.md

@@ -1,10 +1,32 @@
-Python-API: Scientific Graphing Library 
-======
+Plotly's Python-API:
+====================
 
-Checkout our notebook [here](http://htmlpreview.github.com/?https://github.com/plotly/python-api/blob/1.0/notebooks/Plotly%20and%20Python.html).
+Analyze and visualize data, together... (from Python).
+------------------------------------------------------
+
+Nutshell:
+---------
+
+Plotly. It's all about the graphs.
+
+What we're about:
+
+* a platform for sharing open data
+
+* interactive, publication-quality graphs in your browser
+
+* an easy-to-use online interface
+
+Checkout these guides to get you going:
+
+* [Quickstart](http://htmlpreview.github.com/?https://github.com/plotly/python-api/blob/1.0/notebooks/Quickstart.html)
+
+* [Plotly and Python](http://htmlpreview.github.com/?https://github.com/plotly/python-api/blob/1.0/notebooks/Plotly%20and%20Python.html)
+
+* [Plotly and matplotlib](http://htmlpreview.github.com/?https://github.com/plotly/python-api/blob/1.0/notebooks/Plotly%20and%20mpld3.html)
+
+* [The *in-depth* guidebook]()
 
-Plotly's scientific graphing libraries let you make and share interactive, publication-quality graphs
-in your browser. Plotly's online graphing tools can interface with your desktop environment, allowing you to import or stream data. Then, style beautiful graphs with code and Plotly's online interface. Easily share your data and graphs publicly with a URL or privately with your team.
 
 Gallery Examples
 -------------

README.rst

@@ -0,0 +1,115 @@
+=======
+plotly:
+=======
+--------------------------
+It's all about the graphs.
+--------------------------
+
+The Nutshell
+~~~~~~~~~~~~
+
+Use this package to make collaborative, interactive,
+publication-quality graphs from Python.
+
+Here's how you import::
+
+    import plotly.plotly as py              # for sending things to plotly
+    import plotly.tools as tls              # for mpl, config, etc.
+    from plotly.graph_objs import *         # __all__ is safely defined
+
+Here's how you sign in::
+
+    py.sign_in('PythonAPI', 'ubpiol2cve')   # get your own at https://plot.ly/
+
+Here's how you plot data or a figure::
+
+    py.plot(data_or_figure_here)
+
+Here's what you get:
+
+* an account on plotly
+* a unique url for your data/figures
+* an interactive web-application to edit your figure or make new figures
+* a platform on which to share your data/figures with the world
+
+You can also convert supported matplotlib figures::
+
+    py.plot_mpl(mplfig)
+
+Stop fighting with your figures; start designing them. Check out our
+Quickstart_ to get going.
+
+
+About
+~~~~~
+
+Plotly_ is an online collaborative data analysis and graphing tool. The
+Python API allows you to access all of Plotly's functionality from Python.
+Plotly figures are shared, tracked, and edited all online and the data is
+always accessible from the graph.
+
+That's it. Find out more, sign up, and start sharing by visiting us at
+https://plot.ly.
+
+Install via pip
+~~~~~~~~~~~~~~~
+
+Assuming you have already installed pip, you can simply enter the following
+in a terminal program::
+
+    $ pip install plotly
+
+Contributing!
+~~~~~~~~~~~~~
+
+If you want to contribute to making Plotly's Python API experience better,
+head to our `GitHub repo`_. Instructions for installing from here,
+updating the included submodules, and contributing are detailed there!
+
+Plotly, matplotlib, and mpld3
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The matplotlylib sub-package allows you to convert matplotlib figures to
+plotly figures, with a one-liner::
+
+    py.plot_mpl(fig)
+
+Checkout the `Plotly and mpld3`_ IPython notebook for more infomataion.
+
+Introduction to working with out API
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Checkout the `Plotly and Python`_ IPython notebook to get a more in depth
+exposition of our Python API.
+
+Plotly's *guide book*
+~~~~~~~~~~~~~~~~~~~~~
+
+Still here? Don't worry, we've got more documentation for you. Checkout a
+*highly* complete `set of notebooks`_ for walk-throughs on all the features
+we offer!
+
+Details
+~~~~~~~
+
+The plotly package depends on requests, which will be installed by pip for you.
+
+To use the matplotlylib subpackage, you'll also need to have matplotlib 1.3.1
+properly installed on your machine.
+
+The matpotlylib package is based on the mplexporter framework for crawling
+and exporting matplotlib images.
+
+Created by: Plotly_, `@plotlygraphs`_, `feedback@plot.ly`_
+
+License: MIT
+
+.. _Plotly: https://plot.ly
+.. _Quickstart: https://plot.ly
+.. _GitHub repo: https://github.com/plotly/python-api
+.. _Plotly and mpld3: http://nbviewer.ipython.org/github/plotly/python-api/blob/1.0/notebooks/Plotly%20and%20mpld3.ipynb
+.. _Plotly and Python: http://nbviewer.ipython.org/github/plotly/python-api/blob/1.0/notebooks/Plotly%20and%20Python.ipynb
+.. _set of notebooks: https://plot.ly
+.. _plotly profile: https://plot.ly/~mpld3/
+.. _@plotlygraphs: https://twitter.com/plotlygraphs
+.. _feedback@plot.ly: feedback@plot.ly

README.txt

@@ -8,3 +8,14 @@ install : sync_mplexporter
 
 pull_subs : plotly/mplexporter plotly/graph_reference
 	git submodule foreach 'git pull origin master'
+
+html_nbs : notebooks
+	cd notebooks; \
+		ipython nbconvert 'Plotly and Python.ipynb'; \
+		python add_some_css.py 'Plotly and Python.html'
+	cd notebooks; \
+		ipython nbconvert 'Plotly and mpld3.ipynb'; \
+		python add_some_css.py 'Plotly and mpld3.html'
+	cd notebooks; \
+		ipython nbconvert Quickstart.ipynb; \
+		python add_some_css.py Quickstart.html