Erstellen eines Knotens, der auf eine andere Domäne in Sphinx verweist

8

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.

%Vor%

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%     
deceze 06.06.2016, 04:19
quelle

0 Antworten

Tags und Links