Вопрос Сложного Сфинкса: Мы создаем автоматизированную документацию кода в формате html. Мы анализируем код и многое другое и структурируем его в rST для генерации html.
Многие части находятся в структуре таблиц, и нам нужно иметь
- строку-wrapped (возможно, многострочный)
Это одна из наших таблиц:
+-------------+-------------------------------+-------------------------------------------------+---------------------------------+
|Priority |Policy Name |Expression |Target |
+=============+===============================+=================================================+=================================+
|100 |cs-pol-somedomainlikexx.at | http.REQ.HOSTNAME.EQ(\"somedomainlikexx.at\") |`l-somedomainlikexx.at-80`_ |
+-------------+-------------------------------+-------------------------------------------------+---------------------------------+
|Default | | |`l-another-domain.at-80`_ |
+-------------+-------------------------------+-------------------------------------------------+---------------------------------+
Выражения в столбце «Выражение» должны быть односторонними, и они могут содержать гораздо больше символов, и онине следует «перегружать» таблицу.
Мы также попробовали ее с ListTables и с использованием примеров многострочного кода в качестве обходного пути, подобного следующему (это должна быть строка). Но, к сожалению, это приводит к чрезмерному увеличению размера ячейки.
* - 10
- cs-pol-www.somedomain.com
- .. code-block:: bash
HTTP.REQ.HOSTNAME.CONTAINS("firstdomain.") || HTTP.REQ.HOSTNAME.CONTAINS("seconddomain.") || HTTP.REQ.HOSTNAME.CONTAINS("thirddomain.at")
- `l-www.firstdomain.com-80`_
Как начинающий в rST, я не знаю, с чего начать квест. Я задавался вопросом, можно ли дать столбцу таблицы специальный html-класс, который будет его обрабатывать, или это возможно сделать с помощью ролевых блоков, таких как кодовый блок выше, который можно настроить в теме ...
- sphinx: v2.2.0
- Тема: sphinx_rtd_theme
- python 3.7