diff --git a/doc/_templates/index.html b/doc/_templates/index.html index a37579c29..a688d17c1 100644 --- a/doc/_templates/index.html +++ b/doc/_templates/index.html @@ -52,23 +52,25 @@ - {%- if hasdoc('search') %}{%- endif %} + - {%- if hasdoc('genindex') %}{%- endif %} + {%- if hasdoc('search') %}{%- endif %} - + {%- if hasdoc('genindex') %}{%- endif %} + diff --git a/doc/contents.rst b/doc/contents.rst index eb6946292..21a27e233 100644 --- a/doc/contents.rst +++ b/doc/contents.rst @@ -7,6 +7,7 @@ Sphinx documentation contents :maxdepth: 2 usage/index + tutorial/index development/index man/index diff --git a/doc/tutorial/index.rst b/doc/tutorial/index.rst new file mode 100644 index 000000000..81845c559 --- /dev/null +++ b/doc/tutorial/index.rst @@ -0,0 +1,25 @@ +.. _tutorial: + +=============== +Sphinx tutorial +=============== + +In this tutorial you will build a simple documentation project using Sphinx, +and view it in your web browser as HTML. +We will include narrative, handwritten documentation, +as well as autogenerated API documentation. + +The tutorial is aimed towards people willing to learn +the fundamentals of Sphinx, +how projects are created and structured, +and how to contribute to an existing project. +To showcase Sphinx automatic documentation generation capabilities +we will use Python, which is the default :term:`domain`: +even though several other languages are supported, +they all work in a similar way. + +To follow the tutorial you will need a working Python installation for development. +We will use *Python virtual environments* to create our project, +you can read more about them in the `Python Packaging User Guide`_. + +.. _Python Packaging User Guide: https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/#creating-a-virtual-environment