Вот такая обёртка

Вроде использовал больше года назад

Из джиры выгружал описания задач

language – The code for the language the docs are written in. Any text automatically generated by Sphinx will be in that language. Also, Sphinx will try to substitute individual paragraphs from your documents with the translation sets obtained from locale_dirs. Sphinx will search language-specific figures named by figure_language_filename and substitute them for original figures. In the LaTeX builder, a suitable language will be selected as an option for the Babel package. Default is None, which means that no translation will be done.

http://www.sphinx-doc.org/en/master/usage/configuration.html

Параметр language из conf.py пробрасывется в параметры пакета babel стандартой LaTeX-преамбулы сфинкса — он отвечает за «автотексты» документа (содержание, напрмер)

команды на сборку для каждого языка есть и работают, параметр в конфиге задан как ru, пдф собирается на англ и русском языках, проблема в том, что "константный" текст, который задаётся не в переводах, лежащих в исходниках в папке locale, а в директории самого сфинкса locale->ru, остаётся привязан к параметру language = 'ru' и отображается в ангд пдф русским

Всем привет! Наверняка эту тему обсуждали, но найти не получилось. Кто-нибудь пользовался VS code для документирования? Как ее можно настроить, чтоб публиковать документы в Gitlub?

GitLens

ставь

посмотрю сейчас. Пользуетесь? удобно?

Привет! А что значит «публиковать»? GitHub или GitLab?

Очень, лучше еще не придумали

выглядит как набор фич, которые и так есть в нормальных IDE ))

Gitlab (очепяталсь) Публиковать - пушить статейки в гит, а создавать их на компе.
Еще нужно потом все это синхронизировать с UI описываемого сервиса

Ну там прям оч хорошо, если бы он платный был, я б денег дал

я использую VS code для работы с исходниками в формате rst, но пушу в гит вручную, хотя VS отслеживает изменения и позволяет запускать команды в терминале прямо там же

возникла такая проблема со sphinx-doc: после билда и деплоя на сайт по поисковым запросам выдаются странички, исключённые из билда и из файла-книжки (index.rst), как отключить поиск по неактивным страницам, но находящимся в билде? например, страницу временно исключили из вёрстки, её нет в навигации, но поиск всё равно на неё ведёт, причём она открывается

Кстати, а кто-нибудь знает как в VS сделать аналог git add --patch?

https://marketplace.visualstudio.com/items?itemName=paragdiwan.gitpatch
https://github.com/Microsoft/vscode/issues/26571
первые ссылки в гугле