jowharshamshiri / doxygen-awesome-css

Custom CSS theme for for Doxygen 1.8.17 html-documentation with lots of customization parameters.

Doxygen Awesome for Doxygen 1.8.17

Doxygen Awesome is a custom CSS theme for Doxygen HTML-documentation with lots of customization parameters.

Motivation

I really like how the Doxygen HTML-documentation is structured! But IMHO it looks a bit outdated.

This theme is an attemt to update the visuals of Doxygen without changing it's overall layout too much.

Fixed for Doxygen 1.8.17

Features

• 🌈 Clean, modern design
• 🚀 Heavily customizable by adjusting CSS-variables
• 🧩 No changes to the HTML structure of Doxygen required
• 📱 Improved mobile usability
• 🌘 Dark mode!
• 🥇 Works with Doxygen 1.8.17, have not tested with other versions.

Installation

Copy the file doxygen-awesome.css from this repository into your project or add this repository as submodule and check out the latest release:

git submodule add https://github.com/jowharshamshiri/doxygen-awesome-css.git
cd doxygen-awesome-css
git checkout v2.0.3

# Doxyfile
GENERATE_TREEVIEW      = YES # optional. Also works without treeview
HTML_EXTRA_STYLESHEET  = doxygen-awesome-css/doxygen-awesome.css

Further installation instructions:

• How to install extensions
• How to customize the theme (colors, spacing, border-radius, ...)
• Tips and Tricks for further configuration

Browser support

Tested with

• Chrome 98, Chrome 98 for Android, Chrome 87 for iOS
• Safari 15, Safari for iOS 15
• Firefox 97, Firefox Daylight 97 for Android, Firefox Daylight 96 for iOS

Credits

• This theme is inspired by the vuepress static site generator default theme.
• Thank you for all the feedback on github!

Read Next: Extensions