Попробуй сделать чистую сборку (удалить папку build и собрать заново)

ошибка началась с того как сделал файл genindex.rst

make clean помогает, да )

Аллилуя!))) Ник, спасибо! Я причем html удалял, а надо полностью сносить всю сборку. Я уже не знал куда деваться)🙏

удаляет build?

В любой непонятной ситуации зачищай артефакты сборки

Да

супер, не знал, что там что-то записывается, учту. Три дня меня это нервировало) думаю ну что за тупняк то такой))

так это. В gitlab ci, в докере всё собирать и чудесно будет

У нас так и есть, что-то локально тестирую еще, привык в html смотреть как собирается.

git clean -fdx полезно делать (регулярно).  Именно так, чтобы стерлось всё то, что лежит в .gitignore

Спасибо!

Такой вопрос. Есть задача автоматизировать процесс сборки спецификации наших модулей со смэв, как это можно организовать? Вижу такое решение, в каждом из модулей лежит наша дока, в ней файл  rst  со спецификацией на этот модуль (как он контачит со смэв). В index.rst делаешь toctree, с названием "Спецификация" и подключаешь в него файлы со спецификацией из модулей.  При сборке получаешь доку Спецификация для смэв, с  вариантами подключения всех наших 5 модулей.

Что думает коллективный разум?)) Нормальное решение или может есть проще?

Жирный плюс в карму @nmpotashnikoff. Полностью получилось сгенерить доку по базе данных (описание таблиц + диаграмма PlantUML) для своего проекта по статье Автоматическая генерация технической документации

Отлично)))

Для Планта и базки ооочень хочется нарезать схему на окрестности вокруг таблиц и по запросам. Давно думаю по запросу генерить схему.

всем доброго времени суток, а ни у кого нет ли под рукой ссылки на сравнительную таблицу движков? где прям по пунктам галочками отмечено, какой движок поддерживает локализацию, какой версионирование, а какой всё вместе? вот типа такого, только прям таблицей
где то мне попадалось, но увы, не могу найти

А пример чего хотите и зачем покажите?

Всем привет! Работаю со Sphinx, сделал отдельную папку для rst файлов, которые планируем переиспользовать в документации. Подключил директивой includ один файл в два документа . Стали появляться вот такие ошибки WARNING: duplicate label fig1, other instance in. Как с этим бороться?