Customize doxygen (v1.8.9) output to use the twitter bootstrap framework (v3.3.1)
This started as work done by Stratify Labs and was extended further here. Credit
Doxygen provides a handful of ways to customize the output. The simplest way is to customize the HTML output.
doxygen -w html header.html footer.html customdoxygen.css
Also, you can augment doxygen’s default stylesheet with a customdoxygen.css stylesheet. This is where you would place any custom styling such as sticky footers.
How to Integrate
To integrate this into your own project tell your doxyfile to use these 4 files in the HTML section (see the example site for an example of each file):
- Adds a Bootstrap navbar
- Wraps the content in a Bootstrap container/row
- Closes the extra divs opened in the header.html
- Adds additional styling such as a sticky footer
- Where the magic happens to augment the HTML with bootstrap
NOTE: If you want to use the customdoxygen.css stylesheet from this repository, then you will need to replace the customdoxygen.css style sheet generated by the doxygen command above. If your customdoxygen.css file is in the directory when you run the doxygen command, it will be moved to customdoxygen.css.bak and you can restore it by overwriting the new version with the backup.
See the example-site directory for a minimal working example.
- Menu is not correctly displayed when Doxygen sidebar is enabled.