Documentation: front page, etc.

4 files changed, 23 insertions, 7 deletions

diff --git a/docs/Makefile b/docs/Makefile
index e47f80c..4c1a0fe 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -214,6 +214,3 @@ pseudoxml:
 	$(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
 	@echo
 	@echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."
-
-livehtml:
-    sphinx-autobuild -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
diff --git a/docs/conf.py b/docs/conf.py
index d3e4bc6..638e961 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -116,7 +116,7 @@ todo_include_todos = False
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'alabaster'
+html_theme = 'sphinx_rtd_theme'
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
diff --git a/docs/images/pike.jpg b/docs/images/pike.jpg
new file mode 100644
index 0000000..1596943
--- /dev/null
+++ b/docs/images/pike.jpg
diff --git a/docs/index.rst b/docs/index.rst
index 26d4ee0..90cdf74 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,10 +1,29 @@
 pikepdf Documentation
 ============================
 
+..  figure:: /images/pike.jpg
+    :align: right
+    :alt: A northern pike
+    :figwidth: 30%
+
+    A northern pike, or *esox lucius*. [#img1]_
+
+**pikepdf** is a Python library allowing creation, manipulation and repair of
+PDF files. It provides a wrapper around the C++ PDF content transformation
+library, `QPDF <https://github.com/qpdf/qpdf>`_.
+
+Python + QPDF = "py" + "qpdf" = "pyqpdf", which looks like a dyslexia test. Say it
+out loud, and it sounds like "pikepdf".
+
+
+
 Contents:
 
-.. toctree::
-   :maxdepth: 2
+..  toctree::
+    :maxdepth: 2
+
+    pikepdf
 
-   pikepdf
+..  rubric:: References
 
+..  [#img1] `Public domain image <https://en.wikipedia.org/wiki/File:Esox_lucius1.jpg>`_.
\ No newline at end of file