Документирование более одного репозитория с помощью MkDocs
У меня есть особая ситуация, когда у меня есть несколько пакетов Django, которые тесно взаимодействуют друг с другом, и я хочу документировать их вместе в одном месте.
- medux-common: общие используемые модели, представления и т.д.
- medux: основное приложение
- medux-online: веб-интерфейс для определенных функций .
- medux-docs: пакет документации
Оба medux-online и medux используют модуль common, и я не хочу иметь 3 домашних страницы документации, а только одну, где все документировано в одном месте.
Есть ли в MkDocs возможность "загружать" внешние пакеты? Я использую плагин mkdocstrings для загрузки документаций из моего кода. В его документации сказано, что путь должен быть установлен так, чтобы модуль, который нужно документировать, был импортируемым
В моем пакете medux-docs я импортирую все другие пакеты с помощью pip install -e ../medux и т.д., что работает нормально. Но MkDocs не находит их:
$ mkdocs serve
[...]
ERROR - mkdocstrings: medux.core.middleware could not be found
ERROR - Could not collect 'medux.core.middleware'
Как мне это сделать? Я не хочу объединять все репозитории в один, так как medux и medux-online тоже должны быть двумя пакетами pypi. Я просто хочу, чтобы MkDocs находил импортированные medux, medux-online и medux-common. Может быть, я совершенно неправильно мыслю?