прошу совета, поплясав со связкой "shpinx-doc & rst и локализация через po/mo файлы", мы упёрлись в ограничения сфинкса:

- нет нативной поддержки версионности при подключении локализации с вышеуказанной схемой, т.е. на одном языке работает, на двух одновременно - нет;
- встроенный поиск ищет не по html-страничкам, а по rst исходникам, и выдаёт всё, включая закомментированные строки, причём, если поиск на английском, то превью отображается на русском, что не гуд;
- проблемы с кастомизацией pdf-файлов как на англ языке, так и в целом с любым документом, который билдится сфинксом

есть ещё пара некритичных мелочей.

По сему решили подыскать другую площадку для управления контентом и вёрстки сайта, хотелось бы иметь версионирование, локализацию, нормальный поиск и выгрузку в пдф из коробки в нормальном виде. Такие решения/платформы вообще существуют?

Antora

Например, "Не надо расписывать все-все задачи, постарайтесь уложиться в пару предложений. Если будет слишком длинно — мы сократим по своему усмотрению", ну и поле вилка обязательное

Подымим техрайтошную с колен

прошу совета, поплясав со связкой "shpinx-doc & rst и локализация через po/mo файлы", мы упёрлись в ограничения сфинкса:

- нет нативной поддержки версионности при подключении локализации с вышеуказанной схемой, т.е. на одном языке работает, на двух одновременно - нет;
- встроенный поиск ищет не по html-страничкам, а по rst исходникам, и выдаёт всё, включая закомментированные строки, причём, если поиск на английском, то превью отображается на русском, что не гуд;
- проблемы с кастомизацией pdf-файлов как на англ языке, так и в целом с любым документом, который билдится сфинксом

есть ещё пара некритичных мелочей.

По сему решили подыскать другую площадку для управления контентом и вёрстки сайта, хотелось бы иметь версионирование, локализацию, нормальный поиск и выгрузку в пдф из коробки в нормальном виде. Такие решения/платформы вообще существуют?

Это хороший сценарий. Для локализации тогда можно использовать Trados с нормальным управлением проектом, терминологией и версиями локализации. Плюс возможность работать над локализацией не одному человеку. Есть трейдофф: этот шаг назад от CI/CD обратно к кровавому энтерпрайзу. Потому что при изменении исходной языковой версии придется заново перелопачивать проект. С другой стороны, 99% текстовых единиц уже будут в памяти перевода, так что работы минимум.

А что если развязать локализацию и Sphinx? Т.е. вместо попытки собирать многоязычную доку средствами самого Sphinx (как я понял вышеописанное), пойти другим путем: делать локализацию rst-файлов, и из них делать независимые сборки документации под каждый язык? Если отбросить локализацию и представить, что язык всего один, Sphinx сам по себе устраивает?

да, rst не самый удобный формат для парсинга, но я бы попробовал pandoc-ом конвертить его в HTML, локализовать HTML, а потом тем же pandoc-ом конвертить обратно в rst. я попробовал — вроде даже работает

ну вот у кого-то выше не работает в мультиязычном варианте. а sphinx умеет просто из .po собирать локализованные rst?

Там третья и, возможно, вторая проблема были связаны с ошибкой в коде переводной локали. @exebeeche, получилось починить это?

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

Из коробки он умеет из оригинального rst  и .po собирать разные выходные форматы. Прямо в ещё один rst с переведённым текстом из коробки не умеет, но можно научить.