kopia lustrzana https://github.com/deathbeds/ipydrawio
166 wiersze
4.2 KiB
Python
166 wiersze
4.2 KiB
Python
"""ReadTheDocs-compatible sphinx configuration."""
|
|
# Copyright 2023 ipydrawio contributors
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
|
|
import datetime
|
|
import json
|
|
import os
|
|
import re
|
|
from pathlib import Path
|
|
|
|
from sphinx.application import Sphinx
|
|
|
|
HERE = Path(__file__).parent
|
|
RTD = json.loads(os.environ.get("READTHEDOCS", "False").lower())
|
|
NOW = datetime.datetime.now(tz=datetime.timezone.utc).date()
|
|
|
|
|
|
ROOT = HERE.parent
|
|
APP_PKG = ROOT / "packages/ipydrawio/package.json"
|
|
APP_DATA = json.loads(APP_PKG.read_text(encoding="utf-8"))
|
|
RTD = json.loads(os.environ.get("READTHEDOCS", "False").lower())
|
|
|
|
# metadata
|
|
author = APP_DATA["author"]
|
|
project = author.replace("Contributors", "").strip()
|
|
copyright = f"{NOW.year}, {author}"
|
|
|
|
# The full version, including alpha/beta/rc tags
|
|
release = APP_DATA["version"]
|
|
|
|
# The short X.Y version
|
|
version = ".".join(release.rsplit(".", 1))
|
|
|
|
# sphinx config
|
|
extensions = [
|
|
"myst_nb",
|
|
"sphinx.ext.intersphinx",
|
|
"sphinx.ext.autodoc",
|
|
"sphinx_copybutton",
|
|
# for routing
|
|
"sphinxext.rediraffe",
|
|
"sphinx-jsonschema",
|
|
"autodoc_traits",
|
|
]
|
|
|
|
|
|
# content
|
|
autosummary_generate = True
|
|
autosectionlabel_prefix_document = True
|
|
myst_heading_anchors = 3
|
|
nb_execution_show_tb = True
|
|
suppress_warnings = ["autosectionlabel.*"]
|
|
|
|
rediraffe_redirects = {
|
|
"demo/index": "_static/lab/index",
|
|
"demo/retro/index": "_static/retro/tree/index",
|
|
}
|
|
|
|
autodoc_typehints = "none"
|
|
autodoc_default_options = {
|
|
"members": True,
|
|
"show-inheritance": True,
|
|
"undoc-members": True,
|
|
}
|
|
inheritance_alias = {}
|
|
|
|
# files
|
|
templates_path = ["_templates"]
|
|
html_favicon = "_static/favicon.ico"
|
|
html_static_path = ["_static", "../build/demo"]
|
|
exclude_patterns = [
|
|
".ipynb_checkpoints",
|
|
"**/.ipynb_checkpoints",
|
|
"**/~.*",
|
|
"**/node_modules",
|
|
"babel.config.*",
|
|
"jest-setup.js",
|
|
"jest.config.js",
|
|
"test/",
|
|
"tsconfig.*",
|
|
"webpack.config.*",
|
|
]
|
|
html_css_files = [
|
|
"theme.css",
|
|
]
|
|
|
|
# theme
|
|
html_theme = "pydata_sphinx_theme"
|
|
html_logo = "_static/logo.svg"
|
|
html_theme_options = {
|
|
"use_edit_page_button": True,
|
|
"icon_links": [
|
|
{
|
|
"name": "PyPI",
|
|
"url": "https://pypi.org/project/ipydrawio",
|
|
"icon": "fa-brands fa-python",
|
|
},
|
|
{
|
|
"name": "Conda Forge",
|
|
"url": "https://github.com/conda-forge/ipydrawio-feedstock",
|
|
"icon": "./_static/anvil.svg",
|
|
"type": "local",
|
|
},
|
|
{
|
|
"name": "GitHub",
|
|
"url": APP_DATA["repository"]["url"],
|
|
"icon": "fa-brands fa-github",
|
|
},
|
|
],
|
|
"pygment_light_style": "gotthard-light",
|
|
"pygment_dark_style": "gotthard-dark",
|
|
}
|
|
|
|
html_sidebars = {
|
|
"**": [
|
|
"demo.html",
|
|
"search-field.html",
|
|
"sidebar-nav-bs.html",
|
|
"sidebar-ethical-ads.html",
|
|
],
|
|
}
|
|
|
|
html_context = {
|
|
"github_user": "deathbeds",
|
|
"github_repo": "ipydrawio",
|
|
"github_version": "main",
|
|
"doc_path": "docs",
|
|
"demo_tarball": f"_static/ipydrawio-lite-{release}.tgz",
|
|
}
|
|
|
|
|
|
intersphinx_mapping = {
|
|
"python": ("https://docs.python.org/3", None),
|
|
"traitlets": ("https://traitlets.readthedocs.io/en/stable/", None),
|
|
"ipywidgets": ("https://ipywidgets.readthedocs.io/en/stable/", None),
|
|
}
|
|
|
|
suppress_warnings = [
|
|
"mystnb.unknown_mime_type",
|
|
]
|
|
|
|
|
|
def clean_schema(app: Sphinx, error):
|
|
if error:
|
|
return
|
|
for schema_html in Path(app.builder.outdir).glob("api/schema.html"):
|
|
text = schema_html.read_text(encoding="utf-8")
|
|
new_text = re.sub(r'<span id="([^"]*)"></span>', "", text)
|
|
if text != new_text:
|
|
schema_html.write_text(new_text, encoding="utf-8")
|
|
|
|
|
|
def setup(app):
|
|
app.connect("build-finished", clean_schema)
|