-
Notifications
You must be signed in to change notification settings - Fork 948
/
conf.py
130 lines (96 loc) · 3.22 KB
/
conf.py
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
#
import os
import subprocess
import sys
# -- path -------------------------------------------------------
from os.path import dirname
docs = dirname(dirname(__file__))
root = dirname(docs)
sys.path.insert(0, root)
# -- bash utility function --------------------------------------
def bash(filename):
"""Runs a bash script in the local directory"""
sys.stdout.flush()
subprocess.call("bash {}".format(filename), shell=True)
# -- source files and parsers -----------------------------------
source_suffix = {
'.rst': 'restructuredtext',
'.md': 'markdown',
}
# -- Sphinx extensions and configuration ------------------------
extensions = [
'sphinx.ext.autodoc',
'sphinx.ext.autosummary',
'sphinx.ext.intersphinx',
'sphinx.ext.mathjax',
'nbsphinx',
'jupyter_sphinx.execute',
'IPython.sphinxext.ipython_console_highlighting',
'recommonmark',
]
intersphinx_mapping = {
'ipython': ('http://ipython.org/ipython-doc/dev/', None),
'nbconvert': ('https://nbconvert.readthedocs.io/en/latest/', None),
'nbformat': ('https://nbformat.readthedocs.io/en/latest/', None),
'jupyter': ('https://jupyter.readthedocs.io/en/latest/', None),
}
nbsphinx_allow_errors = True # exception ipstruct.py ipython_genutils
nbsphinx_execute = 'always'
# Disable including require.js because it is also included by jupyter_sphinx:
nbsphinx_requirejs_path = ''
# -- General information -------
_release = {}
exec(compile(open('../../ipywidgets/_version.py').read(), '../../ipywidgets/_version.py', 'exec'), _release)
version = '.'.join(map(str, _release['version_info'][:2]))
release = _release['__version__']
# Add any paths that contain templates here, relative to this directory.
# templates_path = ['_templates']
master_doc = 'index'
project = 'Jupyter Widgets'
copyright = '2017 Project Jupyter'
author = 'Jupyter Team'
language = None
exclude_patterns = [
'**.ipynb_checkpoints',
'examples.md',
'examples/Beat Frequencies.ipynb',
'examples/Controller.ipynb',
'examples/Exploring Graphs.ipynb',
'examples/Export As (nbconvert).ipynb',
'examples/Factoring.ipynb',
'examples/Imag*',
'examples/Index.ipynb',
'examples/Lorenz Differential Equations.ipynb',
'examples/Media widgets.ipynb',
'examples/Variable Inspector.ipynb',
'examples/Widget Alignment.ipynb',
]
pygments_style = 'sphinx'
todo_include_todos = False
# -- html --------------------------
html_theme = 'sphinx_rtd_theme'
# html_static_path = ['_static']
htmlhelp_basename = 'ipywidgetsdoc'
# -- latex -------------------------
latex_elements = {}
latex_documents = [
(master_doc, 'ipywidgets.tex', 'ipywidgets Documentation',
'https://jupyter.org', 'manual'),
]
# -- tex ---------------------------
texinfo_documents = [
(master_doc, 'ipywidgets', 'ipywidgets Documentation',
author, 'ipywidgets', 'One line description of project.',
'Miscellaneous'),
]
# -- epub --------------------------
# Bibliographic Dublin Core info.
epub_title = project
epub_author = author
epub_publisher = author
epub_copyright = copyright
# -- Theme options -----------------
# Options are theme-specific and customize the look and feel of the theme.
html_theme_options = {}