# Paths ------------------------------------------------------------------------
NRF_BASE = Path(__file__).absolute().parents[2]
sys.path.insert(0, str(NRF_BASE / "doc" / "_utils"))
import utils
NRFX_BASE = utils.get_projdir("nrfx") / "nrfx"
# pylint: disable=undefined-variable
# General ----------------------------------------------------------------------
# Import nrfx configuration, override as needed later
conf = eval_config_file(str(NRFX_BASE / "doc" / "sphinx" / "conf.py"), tags)
locals().update(conf)
sys.path.insert(0, str(NRF_BASE / "doc" / "_extensions"))
extensions.extend(["ncs_cache", "external_content", "doxyrunner"])
# Options for HTML output ------------------------------------------------------
html_static_path.append(str(NRF_BASE / "doc" / "_static"))
html_theme_options = {"docsets": utils.get_docsets("nrfx")}
# -- Options for doxyrunner ----------------------------------------------------
doxyrunner_doxygen = os.environ.get("DOXYGEN_EXECUTABLE", "doxygen")
doxyrunner_doxyfile = NRF_BASE / "doc" / "nrfx" / "nrfx.doxyfile.in"
doxyrunner_outdir = utils.get_builddir() / "nrfx" / "doxygen"
NRF_BASE = Path(__file__).absolute().parents[2]
sys.path.insert(0, str(NRF_BASE / "doc" / "_utils"))
import utils
ZEPHYR_BASE = utils.get_projdir("zephyr")
# pylint: disable=undefined-variable,used-before-assignment
# General ----------------------------------------------------------------------
# Import all Zephyr configuration, override as needed later
os.environ["ZEPHYR_BASE"] = str(ZEPHYR_BASE)
os.environ["ZEPHYR_BUILD"] = str(utils.get_builddir() / "zephyr")
conf = eval_config_file(str(ZEPHYR_BASE / "doc" / "conf.py"), tags)
locals().update(conf)
sys.path.insert(0, str(NRF_BASE / "doc" / "_extensions"))
extensions = [
"sphinx.ext.intersphinx",
"ncs_cache",
] + extensions
# Options for HTML output ------------------------------------------------------
html_theme = "sphinx_ncs_theme"
html_theme_path = []
html_favicon = None
html_static_path.append(str(NRF_BASE / "doc" / "_static"))
sys.path.insert(0, os.path.join(BRIDLE_BASE, 'doc', '_utils'))
import utils
ZEPHYR_BASE = utils.get_projdir('zephyr')
BRIDLE_ZEPHYR_BUILD = os.path.join(utils.get_builddir(), 'zephyr')
# Add the '_extensions' directory to sys.path, to enable finding Bridle's
# Sphinx extensions within.
sys.path.insert(0, os.path.join(BRIDLE_BASE, 'doc', '_extensions'))
# pylint: disable=undefined-variable
# General ----------------------------------------------------------------------
# Import all Zephyr configuration, override as needed later
conf = eval_config_file(os.path.join(ZEPHYR_BASE, 'doc', 'conf.py'), tags)
locals().update(conf)
# If your documentation needs a minimal Sphinx version, state it here.
needs_sphinx = '3.3'
# Add any Sphinx extension module names here, as strings. They can be
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
# ones.
extensions.extend(['sphinx.ext.intersphinx'])
extensions.extend(['bridle.inventory_builder'])
# The suffix(es) of source filenames.
# You can specify multiple suffix as a list of string:
# source_suffix = ['.rst', '.md']
source_suffix = '.rst'
