From 426c214733bd1907c23ad2235674b7a3d6f2e8cc Mon Sep 17 00:00:00 2001 From: "David B. Kinder" Date: Thu, 16 Apr 2020 09:52:44 -0700 Subject: [PATCH] doc: add sphinx-tabs extension The sphinx-tabs extension let's us create a document that can dynamically display alternate material based on clicking a tab, as used in the Zephyr getting started guide: https://docs.zephyrproject.org/latest/getting_started/index.html Signed-off-by: David B. Kinder --- doc/conf.py | 7 +++++-- doc/scripts/requirements.txt | 1 + 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/doc/conf.py b/doc/conf.py index d494cd8a4..c6a79e6e4 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -35,8 +35,11 @@ if "RELEASE" in os.environ: # ones. sys.path.insert(0, os.path.join(os.path.abspath('.'), 'extensions')) -extensions = ['breathe', 'sphinx.ext.graphviz', 'sphinx.ext.extlinks', - 'kerneldoc', 'eager_only', 'html_redirects'] +extensions = [ + 'breathe', 'sphinx.ext.graphviz', 'sphinx.ext.extlinks', + 'kerneldoc', 'eager_only', 'html_redirects', + 'sphinx_tabs.tabs' +] # extlinks provides a macro template diff --git a/doc/scripts/requirements.txt b/doc/scripts/requirements.txt index 3f4c0c227..9ab3abd4d 100644 --- a/doc/scripts/requirements.txt +++ b/doc/scripts/requirements.txt @@ -3,3 +3,4 @@ sphinx==1.7.7 docutils==0.14 sphinx_rtd_theme==0.4.0 kconfiglib>=10.2 +sphinx-tabs