jothepro / doxygen-awesome-css

# Doxygen Awesome
**Doxygen Awesome** is a custom CSS theme for Doxygen HTML documentation with many customization options.
## Motivation
I really like how the Doxygen HTML documentation is structured, but IMHO it looks a bit outdated.
This theme is an attempt to modernize the visuals of Doxygen without changing its overall layout too much.
## Features
- 🌈 Clean, modern design
- 🚀 Highly customizable by adjusting CSS variables
- 🧩 No changes to the HTML structure of Doxygen are required
- 📱 Improved mobile usability
- 🌘 Dark mode support!
- 🥇 Works best with **Doxygen 1.9.1** - **1.9.4** and **1.9.6** - **1.18.0**
## Examples
Some websites using this theme:
- Documentation of this repository
- wxWidgets
- OpenCV 5.x
- Zephyr
- Spatial Audio Framework (SAF)
- Randolf Richardson's C++ classes
- libsl3
- DuMu x 
- OpenRemise
## Installation
To use the theme when generating your documentation, bring the required CSS and JS files from this repository into your project.
This can be done in several ways:
- manually copying the files
- adding the project as a Git submodule
- downloading the project with CMake FetchContent
- adding the project as an npm/xpm dependency
- installing the theme system-wide
All theme files are located in the root of this repository and start with the prefix `doxygen-awesome-`. You may not need all of them. Follow the installation instructions to determine which files are required for your setup.
### Git submodule
For projects that use Git, add the repository as a submodule and check out the desired release:
 [code] 
### CMake with FetchContent
For projects that build with CMake, the `FetchContent` module can be used to download the repository at configuration time.
Add the following snippet to your `CMakeLists.txt`:
 [code] 
This downloads the latest main (but any other revision could be used) and unpacks in the build folder. The `Doxyfile.in` can reference this location in the `HTML_EXTRA_STYLESHEET` field
 [code] 
When the configure stage of CMake is run, the `Doxyfile.in` is rendered to Doxyfile and Doxygen can be run as usual.
### npm/xpm dependency
In the npm ecosystem, this project can be added as a development dependency
to your project:
 [code] 
Similarly, in the xPack ecosystem, this project can be added
as a development dependency to an `xpm`
managed project.
### System-wide
You can even install the theme system-wide by running `make install`.
The files will be installed to `/usr/local/share/` by default,
but you can customize the install location with `make PREFIX=/my/custom/path install`.
### Choosing a layout
There are two layout options. Choose one of them and configure Doxygen accordingly:
- Base Theme 
 Comes with the typical Doxygen titlebar. Optionally the treeview in the sidebar can be enabled.
 Required files: `doxygen-awesome.css`
 Required `Doxyfile` configuration:
 [code] 
- Sidebar-Only Theme 
 Hides the top titlebar to give more space to the content. The treeview must be enabled in order for this theme