diff --git a/docs/conf.py b/docs/conf.py index 741bd61..ea0bd03 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -138,13 +138,16 @@ def read_config_h() -> tuple[str, str, str]: # Add intersphinx mappings # e.g. intersphinx_mapping["semantic_version"] = ("https://python-semanticversion.readthedocs.io/en/latest/", None) intersphinx_mapping = { - 'asdf': ('https://www.asdf-format.org/projects/asdf/en/stable', None), 'asdf-standard': ('https://www.asdf-format.org/projects/asdf-standard/en/latest/', None), 'numpy': ('https://numpy.org/doc/stable/', None) } + +extlinks = {'asdf': ('https://www.asdf-format.org/projects/asdf/en/stable/%s', None)} + extensions = [ 'sphinx.ext.intersphinx', + 'sphinx.ext.extlinks', 'sphinx.ext.todo', 'hawkmoth', # Local; see docs/_ext/ diff --git a/docs/usage/overview.rst b/docs/usage/overview.rst index f0f318b..c9b71bb 100644 --- a/docs/usage/overview.rst +++ b/docs/usage/overview.rst @@ -78,9 +78,8 @@ ndarrays (N-dimension typed arrays) One of the most important and widely used types in ASDF is the **ndarray**. The concept originates from `NumPy`_, the Python library for efficient -numerical computing with *n*-dimensional arrays. In the -:external:doc:`Python ASDF implementation `, NumPy arrays are -serialized under the tag +numerical computing with *n*-dimensional arrays. In the :asdf:`Python ASDF implementation `, +NumPy arrays are serialized under the tag :ref:`core/ndarray `. Although the tag name and conventions come from Python, the underlying idea is language-independent: an ``ndarray`` represents a typed, multi-dimensional