boschglobal / doxysphinx

A lightweight Doxygen extension for Sphinx
https://boschglobal.github.io/doxysphinx/
MIT License
7 stars 11 forks source link
docs-as-code doxygen python sphinx sphinx-extension
doxysphinx

License Pypi package supported Python versions Build action: CI Build action: CD

Doxysphinx is a Doxygen and Sphinx integration tool.

It is an easy-to-use cli tool and typically runs right after Doxygen generation. It reuses the Doxygen generated HTML output and integrates it into Sphinx document generation. With this, Doxysphinx supports all known Doxygen features and at the same time integrates well with the Sphinx output (for example, Sphinx-Themes, search etc.). Doxysphinx, also supports restructured text (rST) annotations within C++ files.

Internally, Doxysphinx creates an rST file for each (Doxygen) HTML file and includes the HTML using .. raw:: html directive. Later Sphinx picks up these rST files and creates an integrated documentation.

Check out Doxysphinx alternatives here.

Links

📚 Doxysphinx Overview

🚀 Getting Started

💻 Developer Quickstart

🤖 Releases