Hi, The intersphinx basically works transparently. It automatically converts cross-references to remote references if the reference target not found locally. A reference :py:class:`zipfile.ZipFile` will be converted to a) a local reference if local document has an entry for zipfile.ZipFile, or b) a remote reference via intersphinx feature. So you don't need to pass the mapping name to references. Of course, you can pass the intersphinx-mapping name to the reference explicitly as you said.
I've never tried to use the Dylan domain, but I believe intersphinx also supports it. Thanks, Takeshi KOMIYA 2021年5月2日(日) 0:03 Carl Gay <carl...@gmail.com>: > > Just noticed this was never answered, so to close the loop... > > It turns out I just had the wrong syntax for the references. This works: > :func:`http:add-resource`, where "http" is one of the keys in the > intersphinx_mapping config and "add-resource" is the name of a function in > that document. > > On Monday, September 14, 2020 at 2:21:54 PM UTC-4 Carl Gay wrote: >> >> Hi, we us Sphinx to document the Dylan language. I would like to use >> intersphinx to make it so that any Dylan library documentation can easily >> link to any other via :dylan:func:`foo` and similar markup. Someone wrote a >> Sphinx domain for Dylan but I'm not super familiar with it (or Sphinx) yet. >> >> In this commit I added an intersphinx mapping to our Library Reference docs' >> conf.py and then added a test link to index.rst, but Sphinx doesn't find the >> xref. To verify that the intersphinx_mapping config is working I also added >> the Python mapping and a :py: test link, which works fine. >> >> My question is, obviously, why doesn't this work? But more specifically, >> how does Sphinx make the connection from the intersphinx mapping, which uses >> the string 'python' to the domain name 'py' in :py:class:`zipfile.ZipFile`? >> >> Thanks. > > -- > You received this message because you are subscribed to the Google Groups > "sphinx-users" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to sphinx-users+unsubscr...@googlegroups.com. > To view this discussion on the web visit > https://groups.google.com/d/msgid/sphinx-users/d6520d32-97ea-4a4c-9b0e-bb74eb4f75efn%40googlegroups.com. -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to sphinx-users+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/sphinx-users/CAFmkQAM2_c-FEq6KaFZy5wxT9bCc_nsoQ5WXLkaFhUO2VcxZvw%40mail.gmail.com.
