mirror of
https://github.com/pybricks/pybricks-api.git
synced 2026-09-12 01:24:17 +00:00
Laurens Valk
bd7806d2d4
Also activate auto formatting. Bump flake8 and mark black disagreements in setup.cfg.
54 lines
1.7 KiB
Python
54 lines
1.7 KiB
Python
#!/usr/bin/env python3
|
|
# -*- coding: utf-8 -*-
|
|
#
|
|
# Pybricks documentation build configuration file
|
|
#
|
|
import os
|
|
|
|
# General information about the project.
|
|
project = "pybricks"
|
|
copyright = "2018-2021 The Pybricks Authors"
|
|
author = ""
|
|
|
|
_TITLE = "Pybricks Modules and Examples"
|
|
_DISCLAIMER = "LEGO, the LEGO logo, MINDSTORMS and the MINDSTORMS EV3 logo are\
|
|
trademarks and/or copyrights of the LEGO Group of companies \
|
|
which does not sponsor, authorize or endorse this site."
|
|
|
|
html_favicon = "../common/images/favicon.ico"
|
|
html_logo = "../common/images/pybricks-logo-rtd.png"
|
|
latex_logo = "../common/images/pybricks-logo-large.png"
|
|
|
|
# Build main docs for RTD by default.
|
|
# Since tags cannot be passed via the TAG make variable on read the docs,
|
|
# add it manually.
|
|
if os.environ.get("READTHEDOCS", None) == "True":
|
|
tags.add("main") # noqa F821
|
|
|
|
# On https://docs.pybricks.com/en/latest/, show features tagged as beta.
|
|
if os.environ.get("READTHEDOCS_VERSION_NAME", None) == "latest":
|
|
tags.add("beta") # noqa F821
|
|
|
|
# Addtional configuration of the IDE docs
|
|
if "ide" in tags.tags: # noqa F821
|
|
_DISCLAIMER = ""
|
|
html_show_copyright = False
|
|
html_show_sphinx = False
|
|
html_css_files = ["css/ide.css"]
|
|
html_js_files = ["js/ide.js"]
|
|
|
|
imgmath_image_format = "svg"
|
|
imgmath_use_preview = True # requires Sphinx v3
|
|
imgmath_latex_preamble = r"""
|
|
\usepackage{newtxsf}
|
|
"""
|
|
|
|
exec(open(os.path.abspath("../common/conf.py")).read())
|
|
|
|
# Addtional configuration of the IDE docs
|
|
if "ide" in tags.tags: # noqa F821
|
|
|
|
extensions.remove("sphinx.ext.mathjax") # noqa F821
|
|
extensions.append("sphinx.ext.imgmath") # noqa F821
|
|
html_theme_options["prev_next_buttons_location"] = None # noqa F821
|