@xpack-3rd-party/doxygen-awesome-css
v2.2.0-1
Published
A source xPack with the Doxygen Awesome CSS custom theme
Downloads
134
Readme
An xpm/npm package with the Doxygen Awesome CSS custom theme
This project provides a convenient way to integrate the Doxygen Awesome CSS custom theme into the xpm/npm ecosystem, by allowing to install it as a package dependency.
The open-source project is hosted on GitHub as xpack-3rd-party/doxygen-awesome-css-xpack.
Install
This project is available from the npmjs.com
registry as the package
@xpack-3rd-party/doxygen-awesome-css
,
and the easiest way to add it to a project is via
xpm or npm; it can also be used as any Git project, but for
this better use the upstream project.
Prerequisites
A recent xpm, which is a portable Node.js command line application.
It is recommended to update to the latest version with:
npm install --global xpm@latest
For details please follow the instructions in the xPack install page.
xpm
To install this project as a dependency in xPack projects, use xpm:
cd my-project
xpm init # Unless a package.json is already present
xpm install @xpack-3rd-party/doxygen-awesome-css@latest
ls -l xpacks/xpack-3rd-party-doxygen-awesome-css
npm
To install the project as a dependency in npm projects:
cd my-project
npm init # Unless a package.json is already present
npm install @xpack-3rd-party/doxygen-awesome-css@latest --save-dev
ls -l node_module/@xpack-3rd-party/doxygen-awesome-css
Branches
In addition to the original main
branch, there are two
xPack specific branches:
xpack
, with the latest stable version (default)xpack-develop
, with the current development version
All development is done in the xpack-develop
branch, and contributions via
Pull Requests should be directed to this branch.
When new releases are published, the xpack-develop
branch is merged
into xpack
.
When there are new upstream releases:
- upstream
main
is merged into the localmain
- the local
main
is merged intoxpack-develop
- the project is tested
xpack-develop
is merged intoxpack
The original README follows.
Doxygen Awesome
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 attempt to update the visuals of Doxygen without changing its overall layout too much.
Features
- 🌈 Clean, modern design
- 🚀 Heavily customizable by adjusting CSS-variables
- 🧩 No changes to the HTML structure of Doxygen required
- 📱 Improved mobile usability
- 🌘 Dark mode support!
- 🥇 Works best with doxygen 1.9.1 - 1.9.4 and 1.9.6
Examples
Some websites using this theme:
- Documentation of this repository
- wxWidgets
- OpenCV 5.x
- Zephyr
- FELTOR
- Spatial Audio Framework (SAF)
- libCloudSync
- libsl3
Installation
To use the theme in your documentation, copy the required CSS and JS files from this repository into your project or add the repository as submodule and check out the latest release:
git submodule add https://github.com/jothepro/doxygen-awesome-css.git
cd doxygen-awesome-css
git checkout v2.2.0
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
.
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 install instructions to figure out what files are required for your setup.
Choosing a layout
There is two layout options. Choose one of them and configure Doxygen accordingly:
1️⃣ 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:GENERATE_TREEVIEW = YES # optional. Also works without treeview DISABLE_INDEX = NO FULL_SIDEBAR = NO HTML_EXTRA_STYLESHEET = doxygen-awesome-css/doxygen-awesome.css HTML_COLORSTYLE = LIGHT # required with Doxygen >= 1.9.5
2️⃣ Sidebar-Only Theme Hides the top titlebar to give more space to the content. The treeview must be enabled in order for this theme to work.
Required files:
doxygen-awesome.css
,doxygen-awesome-sidebar-only.css
Required
Doxyfile
configuration:GENERATE_TREEVIEW = YES # required! DISABLE_INDEX = NO FULL_SIDEBAR = NO HTML_EXTRA_STYLESHEET = doxygen-awesome-css/doxygen-awesome.css \ doxygen-awesome-css/doxygen-awesome-sidebar-only.css HTML_COLORSTYLE = LIGHT # required with Doxygen >= 1.9.5
Caution:
- This theme is not compatible with the
FULL_SIDEBAR = YES
option provided by Doxygen! HTML_COLORSTYLE
must be set toLIGHT
since Doxygen 1.9.5!
Further installation instructions:
- Installing extensions
- Customizing the theme (colors, spacing, border-radius, ...)
- Tips and Tricks for further configuration
Browser support
Tested with
- Chrome 110, Chrome 109 for Android, Chrome 110 for iOS
- Safari 16, Safari for iOS 16
- Firefox 110, Firefox 110 for Android, Firefox 109 for iOS
- Edge 110
The theme does not strive to be backwards compatible to (significantly) older browser versions.
Credits
Thanks for all the bug reports and inspiring feedback on github!
Special thanks to all the contributors:
Read Next: Extensions