Коллеги, кто нибудь стилизовывал вывод grapviz?

Дизайнер рисует красивые картинки, а я пытаюсь донести, что от картинки проку мало, потому как она меняется часто и наличие картинки приведет только к тому, что в схеме будет постоянно что-то неправильное, потому что лень менять.


Но graphviz действительно некрасив.

А именно graphviz нужен? Какой-нибудь mermaidjs не подойдёт?

мермейд очень плохо раскладывает.

Графвизом легче управлять, делая группы, структуры и предсказуемо раскладывать блоки. Мермейд очень прост на старте, но прыгает как хочет, довольно рандомно

В моей практике красивенько всё равно не получалось, но объяснить что не так не могу. Максимум до подобного доводили:

Там есть стили, цепляются к блокам, например

Approve [shape=cds, label="Approve", color=green, fontcolor=green]
Decline [shape=cds, label="Decline", color=red, fontcolor=red]
node [fontname="helvetica"];
edge [fontname="helvetica"];

у них на сайте есть отдельная дока по стилям

Всем привет!
Посоветуйте, пожалуйста, расширение Sphinx для описания API.

Установил sphinxcontrib.httpdomain, но удобство и собранный результат пока не впечатляют.

redoc же
https://github.com/sphinx-contrib/redoc

спасибо, посмотрю

это правда только для RESTового OpenAPI

Всем привет!

Для документации используем mkdocs c material темой, хостим доку на read-the-docs. Хотели себе сделать server-side поиск, по документации вроде все должно работать из коробки без доп. действий. Но по факту все равно работает client-side поиск.

Подскажите, пожалуйста, кто-нибудь уже решал такую же проблему?

Всем привет! Такая трабла по умолчанию в структуре Sphinx в индексном файле есть вот такая метка genindex (алфавитный указатель), ранее я создал файл с таким названием, оказалось так делать нельзя, это имя зарезервировано в сфинксе, файл я удалил, но теперь эта метка не работает)) Как можно починить? При этом алфавитный указатель с этим именем в html собирается, но на странице содержания -  нети вот такая ошибка при сборке \doc\index.rst:60: WARNING: undefined label: genindex

это метки. Отдельно настраиваете toctree, а метки ставите перед заголовком или подзаголовком, они абсолютные:
.. _section_name:

У них есть бонус - :ref:`любой текст <section_name>`

я понимаю что метки, а вот эта метка genindex, зарезервирована Sphinx и теперь выглядит вот так

оно?

да оно, но не работает, вот файл есть при сборке

вот делаю так и так

Получаю