mirror of
https://github.com/pybricks/pybricks-api.git
synced 2026-09-12 01:24:17 +00:00
David Lechner
06e01e5ac8
MathJax uses a CDN to to distribute the package. So in order to use the docs offline, we would have to include our own copy. But it is a bit large (50-ish MB), so it is easier to use sphinx.ext.imgmath instead to generate svg images. The situation might be different with MathJax v3, but that requires Sphinx v4.
33 lines
843 B
Python
33 lines
843 B
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 = ''
|
|
|
|
html_favicon = '../common/images/favicon.ico'
|
|
html_logo = '../common/images/pybricks-logo-rtd.png'
|
|
html_show_copyright = False
|
|
html_show_sphinx = False
|
|
html_css_files = ['css/ide.css']
|
|
|
|
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())
|
|
|
|
extensions.remove('sphinx.ext.mathjax') # noqa F821
|
|
extensions.append('sphinx.ext.imgmath') # noqa F821
|
|
html_theme_options['prev_next_buttons_location'] = None # noqa F821
|