Refactored documentation.

.gitignore

@@ -168,6 +168,10 @@ output/*/index.html
 junit-*.xml
 flake8-errors.txt
 
+# Documentation building
+_build
+doc_src/api/categories*.rst
+
 RELEASE.txt
 site-packages
 reports

Makefile

@@ -83,3 +83,10 @@ release-patch: set-release-patch-env-var release-helper  ## Release a new patch
 release-minor: set-release-minor-env-var release-helper  ## Release a new minor version: 1.1.1 -> 1.2.0
 
 release-major: set-release-major-env-var release-helper  ## release a new major version: 1.1.1 -> 2.0.0
+
+documentation:
+	mkdir -p docs
+	rm -f doc_src/api/$(SOURCE_DIR)*.rst
+	ls -A1 docs | xargs -I {} rm -rf docs/{}
+	$(MAKE) -C doc_src clean html
+	cp -a doc_src/_build/html/. docs

doc_src/Makefile

@@ -6,7 +6,7 @@ SPHINXOPTS    = -a
 SPHINXBUILD   = sphinx-build
 PAPER         =
 BUILDDIR      = _build
-DESTDIR       = ..
+DESTDIR       = _build
 
 # Internal variables.
 PAPEROPT_a4     = -D latex_paper_size=a4
@@ -32,9 +32,9 @@ clean:
 	-rm -rf $(BUILDDIR)/*
 
 html:
-	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(DESTDIR)/docs
+	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(DESTDIR)/html
 	@echo
-	@echo "Build finished. The HTML pages are in $(DESTDIR)/docs."
+	@echo "Build finished. The HTML pages are in $(DESTDIR)/html."
 
 dirhtml:
 	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml

doc_src/_static/css/custom.css

@@ -0,0 +1,32 @@
+.sig-prename.descclassname {
+  display: none;
+}
+dl.attribute {
+  margin-bottom: 30px;
+}
+dl.field-list {
+  display: block;
+}
+dl.field-list > dt {
+  padding-left: 0;
+}
+dl.field-list > dd {
+  padding-left: 1em;
+  border-left: 0;
+}
+dl.field-list > dd > ul.simple {
+  list-style-type: none;
+  padding-left: 0;
+}
+dl.field-list > dd + dt {
+  margin-top: 0.5em;
+}
+dd {
+  margin-left: 0;
+  padding-left: 30px;
+  border-left: 1px solid #c9c9c9;
+}
+.table.autosummary td {
+  border-top: 0;
+  border-bottom: 1px solid #dee2e6;
+}