Как мы разрабатываем документацию в открытом проекте Embox

[domix32]

А не пробовали посмотреть в сторону mdBook?
Перепилил на коленке доку из вашей репы — результат, репа.
Из минусов только отсутвие нормального способа поддержки переводимости. Генерацию PDF пока не тестировал.

[abondarev]

Нет не видели.
Спасибо. Выглядит очень круто!

[nihlete]

В готовых примерах явно не хватает моноширинного текста для кодовых вставок.

По поводу жирного шрифта попробуйте заменить pdflatex + babel на lualatex + polyglossia сможете использовать давно привычные всем ttf шрифты.
P.s. xelatex тоже может работать с ttf, но мне привычнее lualatex.

[abondarev]

Спасибо. Попробуем.
Экспериментировали! но с lualatex были какие то свои заморочки. Сейчас уже на вскидку не вспомню.

[pauloa]

Еще можно посмотреть sphinx
Достаточно удобная штука, умеет собираться в версию для web и pdf. Пишут, что поддерживает мультиязычность.

[abondarev]

Спасибо, попробуем. Слышали, но не пробовали