2015-09-02 6 views
7

Ich habe ein Problem mit Sphinx-Docs Ref-Funktion, ich lege eine Beschriftung über einen Absatz und dann versuche ich auf dieses Etikett von einem anderen Dokument aber innerhalb des gleichen Projekts zu verknüpfen.Kann nicht verwendet werden Ref mit einem Label mit Sphinx doc

Das Label i in einem Dokument zu verwenden:

.. _hal_1k_1p: 

Und die Ref ich versuche, auf diesem Label zu verbinden zu verwenden:

:ref:`Link title hal_1k_1p` 

Aber ich nur diese Fehlermeldung erhalten, wenn Sie den doc Aufbau :

WARNUNG: undefined Label: Link Titel hal_1k_1p (wenn der Link nicht Beschriftung hat, muss das Etikett eine Sekte voraus ion header)

Was mache ich falsch?

Antwort

13

Okay, bei http://sphinx-doc.org/markup/inline.html#role-ref suchen Sie müssen dies haben:

:ref:`Link title <ha1_1k_1p>` 

zu diesem Label zu verbinden.

Vergewissern Sie spitzen Klammern rund um Ihr Label wie so haben: <Label>

+1

Wenn ich die offiziellen Dokumente lesen sie geben diese Antwort in Bezug auf mein Problem „Labels, die nicht platziert werden, bevor ein Abschnitt Titel noch verwiesen werden kann , aber Sie müssen dem Link einen expliziten Titel geben, indem Sie folgende Syntax verwenden:: ref: 'Link title '. " Aber das Problem ist, dass sie nicht wirklich ein Beispiel geben, wie man es implementiert, also bin ich irgendwie fest – Raiu

+0

Die Klammer war die Sache, die fehlt, vielen Dank – Raiu