Как сгенерировать табличный вывод в reStructuredText без использования формата таблицы RST?

Я пытаюсь перенести наши документы API и их схему генератора проприетарной документации на reStructuredText. Сложнее всего то, что у нас есть табличное представление деталей API, закодированных непосредственно в HTML, а-ля:

--------+------------+--------+--------------------------------+
Param   |  Required  |  Type  |  Description
----------------------------------------------------------------
id      |     Yes    | int    | This is the ID of the record...
content |     No     | string | Optional string contents...

(то есть в настоящее время это кодируется как id Да ... )

Я хочу сделать это в RST, но делаю это семантически , а не просто используя формат таблицы RST. Но я не могу найти хороших примеров пользовательских директив , чтобы справиться с этим так, как я хочу, что было бы примерно так

:.. parameter-table:: My Parameter Table
    .. item::
       :param: "id"
       :required: true
       :type: "int"
       :desc: "This is the ID of the record..."

Как я могу сделать это в reStructuredText?

5
задан Mogsdad 12 February 2018 в 19:45
поделиться