From 15fe52dce6439d0e4c81d1a2d8fadc6401cae1e6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Juan=20Luis=20Cano=20Rodr=C3=ADguez?= Date: Tue, 22 Jun 2021 15:37:30 +0200 Subject: [PATCH] Separate extensions and themes more clearly --- doc/tutorial/index.rst | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/doc/tutorial/index.rst b/doc/tutorial/index.rst index 8ab1fc287..936bfa549 100644 --- a/doc/tutorial/index.rst +++ b/doc/tutorial/index.rst @@ -242,8 +242,11 @@ Sweet! and in general LaTeX requires careful configuration in some cases, so PDF generation is out of scope for this tutorial. -More Sphinx customization using extensions ------------------------------------------- +More Sphinx customization +------------------------- + +There are two main ways to customize your documentation beyond what is possible +with core Sphinx: extensions and themes. Enabling a built-in extension ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -282,10 +285,9 @@ durations report at the end of the console output, like this one: Using a third-party HTML theme ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Themes, on the other hand, are a particular class of extensions that allow you -to customize the appearance of your documentation. Sphinx has several -:ref:`built-in themes `, and there are also `third-party -ones `_. +Themes, on the other hand, are a way to customize the appearance of your +documentation. Sphinx has several :ref:`built-in themes `, and +there are also `third-party ones `_. For example, to use the `Furo `_ third-party theme in your HTML documentation, first you will need to install it with ``pip`` in