.. _cross_linking:

***************************
Referencing across Projects
***************************

Assuming you have a `conf.py` configured to download the intersphinx bindings
from XFEL's read-the-docs server (:ref:`non_karabo_projects`) use the
following syntax to link across hosted projects:
`:ref:\`Karabo<karabo:introduction>\``. This will create a link to the Karabo
project's introduction, referenced by its label *introduction*:
:ref:`Karabo<karabo:introduction>`. The project identifier, *karabo* in this
case, corresponds to the URI-slug of the respective projects, with all dashes
`-` replaced. You can deduce it from the url of the project. For
 :ref:`Karabo <karabo>` this is *exflkarabo.desy.de/karabo/en/latest/*, the slug
 is the part right after the server address, hence *karabo*.