In einer benutzerdefinierten Sphinx-Domäne möchte ich einen Verweis auf einen anderen Knoten in einer anderen Domäne erstellen. Zum Beispiel:
%Vor% Mein example:directive::
sagt, dass meine "Methode" baz
etwas vom Typ foo.bar
zurückgibt, welches eine Python-Klasse ist. Ich würde das gerne auf die andere py:class:: foo.bar
description verweisen.
Innerhalb meiner benutzerdefinierten Domäne analysiere ich meine Direktiven und erstelle die Elemente und es ist alles in Ordnung, sogar ein Querverweis innerhalb meiner example
-Domäne funktioniert gut, indem ich die Methode sphinx.domains.Domain:resolve_xref
unterklassiere. Ich bin nur unsicher, wie ich einen Knoten programmatisch in meine handle_signature
-Methode einfügen würde, die später zu einem Knoten in einer anderen Domäne aufgelöst wird. Würde ich irgendwie sphinx.domains.python.PyXRefRole
instanziieren müssen?
Das erwartete Ergebnis in HTML wäre etwa:
%Vor%Tags und Links python-sphinx docutils