В настоящее время я документирую API отдыха, написанный на Python. Весь проект »Документация s создается с использованием Sphinx, и для REST API я хотел бы создать несколько специальных директив. Например, пустьскажем, я определил этот ресурс:

@resource("/user/", method="GET")
def user_details (email):
    """ Returns detailed information about a user account.

    :resource GET: /user/
    :query_param a_param: Some kind of query param.
    """
    # Do stuff and return user details

Тот'В основном, как выглядит документация в настоящее время. Я хотел бы иметь возможность создать директиву для Sphinx, которая форматирует один или несколько из них:query_param ...: так же, как это происходит с обычным.:param:

Я нашел, как создавать роли, но они работают только встроенно, а не для блоков данных.

Как я должен сделать это?