Skip to content

Commit

Permalink
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Miscelaneous docs update.
Browse files Browse the repository at this point in the history
- remove sphinxcontrib_github_alt as it is unused since 5c51ceb
- bump used python in a few places.
- and start using intersphinx_registry to simplify managing intersphinx.
Carreau committed May 30, 2024
1 parent 9a3595e commit 5237041
Showing 3 changed files with 8 additions and 9 deletions.
2 changes: 1 addition & 1 deletion .readthedocs.yaml
Original file line number Diff line number Diff line change
@@ -9,4 +9,4 @@ python:
build:
os: ubuntu-22.04
tools:
python: "3.11"
python: "3.12"
9 changes: 4 additions & 5 deletions docs/conf.py
Original file line number Diff line number Diff line change
@@ -14,6 +14,8 @@
import shutil
from pathlib import Path

from intersphinx_registry import get_intersphinx_mapping

from jupyter_core.version import __version__, version_info

# If extensions (or modules to document with autodoc) are in another directory,
@@ -33,15 +35,14 @@
"myst_parser",
"sphinx.ext.autodoc",
"sphinx.ext.intersphinx",
"sphinxcontrib_github_alt",
"sphinx_autodoc_typehints",
]

try:
import enchant # noqa: F401

extensions += ["sphinxcontrib.spelling"]
except ImportError:
except ModuleNotFoundError:
pass

github_project_url = "https://github.com/jupyter/jupyter_core"
@@ -294,9 +295,7 @@
# If true, do not generate a @detailmenu in the "Top" node's menu.
# texinfo_no_detailmenu = False


# Example configuration for intersphinx: refer to the Python standard library.
intersphinx_mapping = {"https://docs.python.org/3/": None}
intersphinx_mapping = get_intersphinx_mapping(packages=["python"])


def setup(_):
6 changes: 3 additions & 3 deletions pyproject.toml
Original file line number Diff line number Diff line change
@@ -47,12 +47,12 @@ test = [
"pytest-timeout"
]
docs = [
"intersphinx_registry",
"myst-parser",
"sphinxcontrib_github_alt",
"sphinxcontrib_spelling",
"pydata_sphinx_theme",
"sphinx-autodoc-typehints",
"sphinxcontrib_spelling",
"traitlets",
"pydata_sphinx_theme",
]

[project.scripts]

0 comments on commit 5237041

Please sign in to comment.