Как сделать строковый литерал с двоеточием в restructuredText?
Я пытаюсь задокументировать функцию Python, которая возвращает словарь, например, что-то вроде:
def function(...):
"""
...
Returns:
A dictionary mapping ``{id: {role: value}}``
"""
Но когда я компилирую с помощью Sphinx, он жалуется:
WARNING: Inline literal start-string without end-string.
Литеральная конечная строка определенно присутствует, и она, похоже, не нарушает другие правила форматирования, но я не могу заставить его правильно отображать литерал с двоеточиями (фигурные скобки не являются проблемой; one: two
также проблематично внутри встроенного литерала). Побег не помогает:
""" ``one\: two`` """ --> WARNING
""" ``one\\: two`` """ --> WARNING
r""" ``one\: two`` """ --> WARNING
Единственное, что кажется работающим, - это роль :code:
:
""" :code:`{one: {two: three}}` """ --> OK
Это ограничение Сфинкса? Или ошибка с документами? Или есть способ получить двоеточия внутри встроенных литералов?