Improve docs render - Merge #159 from isogeo/docs

isogeo · Apr 7, 2020 · 0857cbc · 0857cbc
2 parents 245d634 + 8bca892
commit 0857cbc
Show file tree

Hide file tree

Showing 2 changed files with 14 additions and 11 deletions.
diff --git a/docs/conf.py b/docs/conf.py
@@ -90,6 +90,10 @@
 # Output file base name for HTML help builder.
 htmlhelp_basename = "IsogeoPySDK_Doc"
 
+# Ensure sidebar is the same along the pages
+html_sidebars = {
+    "**": ["globaltoc.html", "relations.html", "sourcelink.html", "searchbox.html"]
+}
 
 # -- Options for Texinfo output ----------------------------------------------
 

diff --git a/docs/index.rst b/docs/index.rst
@@ -1,10 +1,6 @@
 Isogeo Python SDK - Documentation
 =================================
 
-.. toctree::
-   :maxdepth: 2
-   :caption: Contents:
-
 .. module:: isogeo-pysdk
 .. moduleauthor:: Julien M. (Isogeo)
 
@@ -23,20 +19,23 @@ Indices and tables
 * :ref:`modindex`
 * :ref:`search`
 
-Cookbook
-++++++++
-
 .. toctree::
    :maxdepth: 2
+   :caption: Quickstart
 
    installation
    authentication
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Cookbook
+
    usage
 
 ----
 
-Package modules and submodules
-++++++++++++++++++++++++++++++
-
 .. toctree::
-    _apidoc/modules
+   :maxdepth: 3
+   :caption: Package
+
+   _apidoc/modules