На чем собирать документацию к проекту?

Question

[Александр Ф]

Здравствуйте!
Есть сервер сборки в проекте GitLab.
Для каждого микрокомпонента проекта есть своя репа. Для каждого микрокомпонента пишется своя дока. Сейчас это делается с помощью Word и ручного перевода в pdf. Следовательно, наглядной версионности для документации не получается, как для текстовых файлов с кодом.
Возможно ли писать доку в каком-нибудь markdown или latex, и в дальнейшем автоматически собирать из этого pdf? Насколько я понял, для обычного latex или markdown есть сборщики, но сложность в том, что в docx документе используются фирменные стили для доки. Подскажите, куда можно капнуть?
Сборщики в проекте используются.

Comments

[Adamos]

Стили есть где угодно - хоть в Латексе, хоть в банальном HTML.
Просто забудьте, что существуют офисные пакеты - и вам сразу станет легче разобраться в каком-нибудь https://wkhtmltopdf.org/ - например.

[AVKor]

Adamos,

Стили есть где угодно - хоть в Латексе, хоть в банальном HTML.

https://ru.wikipedia.org/wiki/Латекс

Answer 1

[AVKor]

https://www.sphinx-doc.org/ как один из возможных вариантов.