IntenseWebs/sphinx
3
0
Fork 0
mirror of https://github.com/sphinx-doc/sphinx.git synced 2025-02-25 18:55:22 -06:00
Code Issues Packages Projects Releases Wiki Activity

Separate extensions and themes more clearly

Browse Source
This commit is contained in:
Juan Luis Cano Rodríguez
2021-06-22 15:37:30 +02:00
parent c9d2a73d93
commit 15fe52dce6
1 changed files with 8 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
doc/tutorial/index.rst
View File

@@ -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 <builtin-themes>`, and there are also `third-party
ones <https://sphinx-themes.org/>`_.
Themes, on the other hand, are a way to customize the appearance of your
documentation. Sphinx has several :ref:`built-in themes <builtin-themes>`, and
there are also `third-party ones <https://sphinx-themes.org/>`_.
For example, to use the `Furo <https://pradyunsg.me/furo/>`_ third-party theme
in your HTML documentation, first you will need to install it with ``pip`` in