Add html files for Sphinx docs

.gitignore

@@ -8,7 +8,6 @@ __pycache__/
 # Distribution / packaging
 .Python
 env/
-build/
 develop-eggs/
 dist/
 downloads/

README.md

@@ -31,6 +31,16 @@ To run the jupiter examples,
 2. `pip install jupyter`
 2. `jupyter notebook`
 
+## Documentation
+
+Documentation is created using Sphix.  View the docs [here]().
+
+To update docs prior to a release:
+
+`cd docs`
+`sphinx-apidoc -f -o source/ ../mapboxgl/`
+`make html`
+
 ## Usage
 
 Import the mapboxgl library and helper functions to start:

docs/Makefile

@@ -0,0 +1,29 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+SPHINXPROJ    = MapboxGLJupyter
+SOURCEDIR     = source
+BUILDDIR    = ../docs
+PDFBUILDDIR = /tmp
+PDF     = ../manual.pdf
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+latexpdf: 
+    $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(PDFBUILDDIR)/latex 
+    @echo "Running LaTeX files through pdflatex..." 
+    make -C $(PDFBUILDDIR)/latex all-pdf 
+    cp $(PDFBUILDDIR)/latex/*.pdf $(PDF) 
+    @echo "pdflatex finished; see $(PDF)"
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/build/html/.buildinfo

@@ -0,0 +1,4 @@
+# Sphinx build info version 1
+# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
+config: d28cc8663b8412d811f01097294fc956
+tags: 645f666f9bcd5a90fca523b33c5a78b7

docs/build/html/_sources/index.rst.txt

@@ -0,0 +1,20 @@
+.. MapboxGL Jupyter documentation master file, created by
+   sphinx-quickstart on Sat Feb  3 20:01:28 2018.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+Welcome to MapboxGL Jupyter's documentation!
+============================================
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`

docs/build/html/_sources/mapboxgl.rst.txt

@@ -0,0 +1,54 @@
+mapboxgl package
+================
+
+Submodules
+----------
+
+mapboxgl\.colors module
+-----------------------
+
+.. automodule:: mapboxgl.colors
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+mapboxgl\.errors module
+-----------------------
+
+.. automodule:: mapboxgl.errors
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+mapboxgl\.templates module
+--------------------------
+
+.. automodule:: mapboxgl.templates
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+mapboxgl\.utils module
+----------------------
+
+.. automodule:: mapboxgl.utils
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+mapboxgl\.viz module
+--------------------
+
+.. automodule:: mapboxgl.viz
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+Module contents
+---------------
+
+.. automodule:: mapboxgl
+    :members:
+    :undoc-members:
+    :show-inheritance:

docs/build/html/_sources/modules.rst.txt

@@ -0,0 +1,7 @@
+mapboxgl
+========
+
+.. toctree::
+   :maxdepth: 4
+
+   mapboxgl