https://github.com/boschglobal/doxysphinx

A lightweight Doxygen extension for Sphinx
https://github.com/boschglobal/doxysphinx

docs-as-code doxygen python sphinx sphinx-extension

Last synced: 11 days ago
JSON representation

A lightweight Doxygen extension for Sphinx

• Host: GitHub
• URL: https://github.com/boschglobal/doxysphinx
• Owner: boschglobal
• License: mit
• Created: 2022-05-09T10:35:34.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2025-10-13T14:43:54.000Z (4 months ago)
• Last Synced: 2025-11-18T11:28:36.312Z (2 months ago)
• Topics: docs-as-code, doxygen, python, sphinx, sphinx-extension
• Language: Python
• Homepage: https://boschglobal.github.io/doxysphinx/
• Size: 11 MB
• Stars: 31
• Watchers: 5
• Forks: 12
• Open Issues: 32
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.md
  • Codeowners: CODEOWNERS
  • Notice: NOTICE.md

Awesome Lists containing this project

README

          








---

[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE.md)

[![Pypi package](https://img.shields.io/pypi/v/doxysphinx)](https://pypi.org/project/doxysphinx/)

[![supported Python versions](https://img.shields.io/pypi/pyversions/doxysphinx)](https://pypi.org/project/doxysphinx/)

[![Build action: CI](https://github.com/boschglobal/doxysphinx/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/boschglobal/doxysphinx/actions/workflows/ci.yml)

[![Build action: CD](https://github.com/boschglobal/doxysphinx/actions/workflows/cd.yml/badge.svg?tag=latest)](https://github.com/boschglobal/doxysphinx/actions/workflows/cd.yml)

Doxysphinx is a [Doxygen](https://doxygen.nl) and [Sphinx](https://sphinx-doc.org) 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](https://github.com/boschglobal/doxysphinx/blob/main/docs/using_rst_in_doxygen.md) 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](https://github.com/boschglobal/doxysphinx/blob/main/docs/alternatives.md).

## Links

📚 [Doxysphinx Overview](https://boschglobal.github.io/doxysphinx)

🚀 [Getting Started](https://boschglobal.github.io/doxysphinx/docs/getting_started.html)

💻 [Developer Quickstart](https://boschglobal.github.io/doxysphinx/docs/dev_guide.html)

🤖 [Releases](https://github.com/boschglobal/doxysphinx/releases)