Merge pull request #347 from mwouts/less_warnings_in_docs_make_html

Fix all warnings (but 2) when doing make html

Author: willingc

docs/environment.yml

@@ -1,7 +1,13 @@
 name: kernel_gateway_docs
+channels:
+  - defaults
+  - conda-forge
 dependencies:
-- python=3.5
-- sphinx_rtd_theme
-- sphinx
-- pip:
-    - recommonmark
+  - python=3.7
+  - sphinx
+  - sphinx_rtd_theme
+  - recommonmark
+  - pillow
+  - pip
+  - pip:
+      - readthedocs-sphinx-ext

docs/source/conf.py

@@ -152,7 +152,7 @@
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
+# html_static_path = ['_static']
 
 # Add any extra paths that contain custom files (such as robots.txt or
 # .htaccess) here, relative to this directory. These files are copied

docs/source/devinstall.md

@@ -40,15 +40,15 @@ make test
 
 ### Run the gateway server
 
-Run an instance of the kernel gateway server in [`jupyter-websocket` mode](websocket-mode).
+Run an instance of the kernel gateway server in [`jupyter-websocket` mode](websocket-mode.md).
 
 ```bash
 make dev
 ```
 
 Then access the running server at the URL printed in the console.
 
-Run an instance of the kernel gateway server in [`notebook-http` mode](http-mode.html) using the `api_intro.ipynb` notebook in the repository.
+Run an instance of the kernel gateway server in [`notebook-http` mode](http-mode.md) using the `api_intro.ipynb` notebook in the repository.
 
 ```bash
 make dev-http

docs/source/features.md

@@ -2,10 +2,10 @@
 
 The Jupyter Kernel Gateway has the following features:
 
-* [`jupyter-websocket` mode](websocket-mode.html) which provides a 
+* [`jupyter-websocket` mode](websocket-mode.md) which provides a 
   Jupyter Notebook server-compatible API for requesting kernels and
   communicating with them using Websockets
-* [`notebook-http` mode](http-mode.html) which maps HTTP requests to
+* [`notebook-http` mode](http-mode.md) which maps HTTP requests to
   cells in annotated notebooks
 * Option to enable other kernel communication mechanisms by plugging in third party personalities
 * Option to set a shared authentication token and require it from clients
@@ -18,7 +18,7 @@ The Jupyter Kernel Gateway has the following features:
   in the request
 * Option to pre-populate kernel memory from a notebook
 * Option to serve annotated notebooks as HTTP endpoints, see
-  [notebook-http](http-mode.html)
+  [notebook-http](http-mode.md)
 * Option to allow downloading of the notebook source when running
   in `notebook-http` mode
 * Generation of [Swagger specs](http://swagger.io/introducing-the-open-api-initiative/)

docs/source/uses.md

@@ -11,7 +11,7 @@ The Jupyter Kernel Gateway makes possible the following novel uses of kernels:
   [tmpnb](https://github.com/jupyter/tmpnb), [Binder](http://mybinder.org/),
   or your favorite cluster manager)
 * Create microservices from notebooks via 
-  [`notebook-http` mode](http-mode.html)
+  [`notebook-http` mode](http-mode.md)
 
 The following diagram shows how you might use `tmpnb` to deploy a pool of kernel gateway instances in Docker containers to support on-demand interactive compute: