Page 1 of 1

Sphinx-Dokumentation mit Doppelpunkt in Feldern

Posted: 14 Jan 2025, 13:58
by Guest
Ich entwickle Dokumentation für ein Paket und wenn ich die Sphinx-Dokumente erstelle, erhalte ich Doppelpunkte
[img]https://i .sstatic.net/8EmeK.png[/img]

für alle Felder für jede Funktionsdefinition.
Ich verwende den Numpydoc-Stil für meine Dokumentzeichenfolgen und es gibt keine Doppelpunkte in diesen Dokumenten, um anzugeben, woher sie kommen könnten:

Code: Select all

    """

Function description

Parameters
-----------
param1: str or list
A description for the parameter

Returns
-----------
Dictionary
Some info about what is returned

Examples
-----------
>>> output = somefunction(param1)

"""
Ist das schon einmal jemandem passiert? Es ist erwähnenswert, dass dies beim Feld Beispiele nicht der Fall ist. Nur Parameter, Rückgaben und Rückgabetyp.