The Jupyter Telemetry Sphinx Extension
A Sphinx extension for auto-generating Jupyter Telemetry schema documentation
To install this extension, run:
pip install jupyter_telemetry_sphinxext
Activate the extension by adding jupyter_telemetry_sphinxext
to your conf.py
file.
# config.py file.
extensions = [
'jupyter_telemetry_sphinxext',
...
]
# Jupyter telemetry configuration values.
jupyter_telemetry_schema_source = "path/to/schemas/source/directory" # Path is relative to conf.py
jupyter_telemetry_schema_output = "path/to/output/directory" # Path is relative to conf.py
jupyter_telemetry_index_title = "Example Event Schemas" # Title of the index page that lists all found schemas.
This will walk the files and directories in jupyter_telemetry_schema_source
and generate restructured text pages for
any Jupyter Telemetry Event Schemas.
Example Event Schemas
My Base Event
All events must have a name property |
type |
object |
properties |
|
Name |
Name of event |
type |
string |
My Nested Event 1 (v1)
All events must have a name property |
type |
object |
properties |
|
Name |
Name of event |
type |
string |
My Nested Event 1 (v2)
All events must have a name property |
type |
object |
properties |
|
Name |
Name of event |
type |
string |
My Nested Event 2 (v1)
All events must have a name property |
type |
object |
properties |
|
Name |
Name of event |
type |
string |
My Nested Event 2 (v2)
All events must have a name property |
type |
object |
properties |
|
Name |
Name of event |
type |
string |
\ Sort by:\ best rated\ newest\ oldest\
\\
Add a comment\ (markup):
\``code``
, \ code blocks:::
and an indented block after blank line