Я пытаюсь перенести наши документы API и их схему генератора проприетарной документации на reStructuredText. Сложнее всего то, что у нас есть табличное представление деталей API, закодированных непосредственно в HTML, а-ля:
--------+------------+--------+--------------------------------+
Param | Required | Type | Description
----------------------------------------------------------------
id | Yes | int | This is the ID of the record...
content | No | string | Optional string contents...
(то есть в настоящее время это кодируется как Я хочу сделать это в RST, но делаю это семантически , а не просто используя формат таблицы RST. Но я не могу найти хороших примеров пользовательских директив , чтобы справиться с этим так, как я хочу, что было бы примерно так Как я могу сделать это в reStructuredText?
id Да ... )
:.. parameter-table:: My Parameter Table
.. item::
:param: "id"
:required: true
:type: "int"
:desc: "This is the ID of the record..."