Include IPython notebooks in Sphinx docs

Note: The first cell in each .ipynb file contains code to suppress
tracebacks in output cells. Thus cells that generate exceptions will
only output the error, without the traceback, which makes the
documentation easier to read.

docs/conf.py

@@ -1,5 +1,6 @@
 extensions = [
     'sphinx-prompt',
+    'nbsphinx',
 ]
 templates_path = ['_templates']
 source_suffix = '.rst'

docs/creating.ipynb

@@ -4,7 +4,8 @@
    "cell_type": "code",
    "execution_count": 7,
    "metadata": {
-    "collapsed": true
+    "collapsed": true,
+    "nbsphinx": "hidden"
    },
    "outputs": [],
    "source": [

docs/index.rst

@@ -11,8 +11,13 @@ Welcome to stix2's documentation!
    :caption: Contents:
 
    overview
-   roadmap
+   creating
+   serializing
+   parsing
+   versioning
+   markings
    datastore_api
+   roadmap
    contributing
 
 

docs/markings.ipynb

@@ -4,7 +4,8 @@
    "cell_type": "code",
    "execution_count": 1,
    "metadata": {
-    "collapsed": true
+    "collapsed": true,
+    "nbsphinx": "hidden"
    },
    "outputs": [],
    "source": [

docs/overview.rst

@@ -66,7 +66,7 @@ The **Environment Layer** adds several components that make it easier to handle
 STIX 2 data as part of a larger application and as part of a larger cyber threat
 intelligence ecosystem.
 
-- ``Data Source``s represent locations from which STIX data can be retrieved,
+- ``Data Source``\s represent locations from which STIX data can be retrieved,
   such as a TAXII server, database, or local filesystem. The Data Source API
   abstracts differences between these storage location, giving a common API to
   get objects by ID or query by various properties, as well as allowing

docs/parsing.ipynb

@@ -4,7 +4,8 @@
    "cell_type": "code",
    "execution_count": 2,
    "metadata": {
-    "collapsed": true
+    "collapsed": true,
+    "nbsphinx": "hidden"
    },
    "outputs": [],
    "source": [

docs/serializing.ipynb

@@ -4,7 +4,8 @@
    "cell_type": "code",
    "execution_count": 2,
    "metadata": {
-    "collapsed": true
+    "collapsed": true,
+    "nbsphinx": "hidden"
    },
    "outputs": [],
    "source": [

docs/versioning.ipynb

@@ -4,7 +4,8 @@
    "cell_type": "code",
    "execution_count": 5,
    "metadata": {
-    "collapsed": true
+    "collapsed": true,
+    "nbsphinx": "hidden"
    },
    "outputs": [],
    "source": [

requirements.txt

@@ -1,4 +1,5 @@
 bumpversion
+nbsphinx
 pre-commit
 pytest
 pytest-cov