интегрировать Sphinx docs / rst в приложение

Мне нравится сфинкс, я играл с ним в течение короткого периода времени, и я уже нашел простое решение утомительной проблемы о кросс-платформенной совместимости математических уравнений, организация моего документа остается чистой, и я могу многое настроить из вариантов для вывода.

Теперь последняя часть, которую мне нужно решить: есть ли общий способ или четко определенный протокол для интеграции вывода sphinx в мое приложение C / C ++?

Например, sphinx способен выводить разметку как токены, как в этом псевдокоде:

std::string doc_author = "Super Mario" // already done by Sphinx
...
std::cout << doc_author << std::endl;  // i just have to use the token named doc_author with my functions/methods

Для простоты я думаю о поддержке интеграции между моим приложением и собственно поддерживаемыми параметрами вывода, такими как

  html       to make standalone HTML files
dirhtml    to make HTML files named index.html in directories
singlehtml to make a single large HTML file
pickle     to make pickle files
json       to make JSON files
htmlhelp   to make HTML files and a HTML help project
qthelp     to make HTML files and a qthelp project
devhelp    to make HTML files and a Devhelp project
epub       to make an epub
latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter
latexpdf   to make LaTeX files and run them through pdflatex
text       to make text files
man        to make manual pages
texinfo    to make Texinfo files
info       to make Texinfo files and run them through makeinfo
gettext    to make PO message catalogs
changes    to make an overview of all changed/added/deprecated items
linkcheck  to check all external links for integrity
doctest    to run all doctests embedded in the documentation (if enabled)

проблема в том, что эти технологии не для мира математики, единственная, которая предлагает относительно приличную поддержку, — это формат файла PDF и, возможно, HTML, но в этом случае я должен использовать png для максимальной совместимости, потому что многие устройства не поддерживает современное решение для рендеринга математики, и pngs страдает от фиксированного разрешения и не очень хорошо масштабируется на устройствах с высоким разрешением.

Есть простой способ интегрировать sphinx с универсальным приложением, или я должен рассмотреть и промежуточный шаг с выводом pdf из sphinx?