Skip to content

Commit

Permalink
intersphinx role, update docs
Browse files Browse the repository at this point in the history
  • Loading branch information
jakobandersen committed Jan 16, 2022
1 parent c11b109 commit 3bf8bcd
Showing 1 changed file with 6 additions and 6 deletions.
12 changes: 6 additions & 6 deletions doc/usage/extensions/intersphinx.rst
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ projects, and optionally to a specific external project.
A link like ``:external:ref:`comparison manual <comparisons>``` will then link
to the label "comparisons" in whichever configured external project, if it
exists,
and a link like ``:external:python+ref:`comparison manual <comparisons>``` will
and a link like ``:external+python:ref:`comparison manual <comparisons>``` will
link to the label "comparisons" only in the doc set "python", if it exists.

Behind the scenes, this works as follows:
Expand Down Expand Up @@ -173,7 +173,7 @@ linking:

For example, with ``intersphinx_disabled_reftypes = ['std:doc']``
a cross-reference ``:doc:`installation``` will not be attempted to be
resolved by intersphinx, but ``:external:otherbook+doc:`installation``` will
resolved by intersphinx, but ``:external+otherbook:doc:`installation``` will
be attempted to be resolved in the inventory named ``otherbook`` in
:confval:`intersphinx_mapping`.
At the same time, all cross-references generated in, e.g., Python,
Expand Down Expand Up @@ -207,10 +207,10 @@ The Intersphinx extension provides the following role.
then the key of the project, as specified in :confval:`intersphinx_mapping`,
is added as well to get the two forms

- ``:external:invname+domain:reftype:`target```,
e.g., ``:external:python+py:class:`zipfile.ZipFile```, or
- ``:external:invname+reftype:`target```,
e.g., ``:external:python+doc:`installation```.
- ``:external+invname:domain:reftype:`target```,
e.g., ``:external+python:py:class:`zipfile.ZipFile```, or
- ``:external+invname:reftype:`target```,
e.g., ``:external+python:doc:`installation```.

Showing all links of an Intersphinx mapping file
------------------------------------------------
Expand Down

0 comments on commit 3bf8bcd

Please sign in to comment.