Add new Sphinx documentation

Initial work thanks to @aanand.

Signed-off-by: Ben Firshman <[email protected]>

Author: bfirsh

.gitignore

@@ -10,7 +10,7 @@ dist
 html/*
 
 # Compiled Documentation
-site/
+_build/
 README.rst
 
 env/

Dockerfile-docs

@@ -1,8 +1,11 @@
-FROM python:2.7
+FROM python:3.5
 
 RUN mkdir /home/docker-py
 WORKDIR /home/docker-py
 
+COPY requirements.txt /home/docker-py/requirements.txt
+RUN pip install -r requirements.txt
+
 COPY docs-requirements.txt /home/docker-py/docs-requirements.txt
 RUN pip install -r docs-requirements.txt
 

Makefile

@@ -74,7 +74,7 @@ flake8: build
 
 .PHONY: docs
 docs: build-docs
-	docker run -v `pwd`/docs:/home/docker-py/docs/ -p 8000:8000 docker-py-docs mkdocs serve -a 0.0.0.0:8000
+	docker run --rm -it -v `pwd`:/home/docker-py docker-py-docs sphinx-build docs ./_build
 
 .PHONY: shell
 shell: build

docs-requirements.txt

@@ -1 +1,2 @@
-mkdocs==0.15.3
+recommonmark==0.4.0
+Sphinx==1.4.6

docs/_static/custom.css

@@ -0,0 +1,3 @@
+dl.hide-signature > dt {
+  display: none;
+}

docs/_templates/page.html

@@ -0,0 +1,2 @@
+{% extends "!page.html" %}
+{% set css_files = css_files + ["_static/custom.css"] %}