-
Notifications
You must be signed in to change notification settings - Fork 72
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
13 changed files
with
704 additions
and
573 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,47 +1,56 @@ | ||
doxygen-bootstrapped | ||
=================== | ||
Doxygen theme that applies the styles of twitter bootstrap | ||
|
||
Customize doxygen (v1.8.8) output to use the twitter bootstrap framework (v3.2.0) | ||
[SEE DEMO HERE](https://biogearsengine.com/documentation/index.html) | ||
|
||
[Demo](https://biogearsengine.com/documentation/index.html) | ||
# Installation | ||
|
||
I took the work done by CoActionOS and extended it further. | ||
[Credit](http://coactionos.com/embedded%20design%20tips/2014/01/07/Tips-Integrating-Doxygen-and-Bootstrap/) | ||
Requires 'doxygen v1.8.9' or below, and 'doxygen-gui'. | ||
|
||
* Open doxywizard | ||
* File > Open > /example-site/Doxyfile | ||
|
||
Now you can use this configuration as template for your project. | ||
|
||
# Customizing Doxygen | ||
Doxygen provides for a handful of ways to [customize the output](http://www.stack.nl/~dimitri/doxygen/manual/customize.html). The simplest way is to customize the HTML output. | ||
|
||
Doxygen allows you to customize the HTML output by modifying a master HTML header, footer, and stylesheet. The following command will generate the default Doxygen HTML files. | ||
# For developers | ||
Doxygen allows to customize the HTML output by modifying the HTML header, | ||
footer and stylesheet. If you want, you can then include additional stylesheets and javascript files. | ||
The following command will generate the default Doxygen files. | ||
|
||
`doxygen -w html header.html footer.html customdoxygen.css` | ||
|
||
Modifying these files alone is not enough to get good Twitter Bootstrap integration. Bootstrap requires that certain classes be applied within the HTML. For example, a Bootstrap “table” needs to have a class called “table” in order to apply the Bootstrap table formatting. We just need to augment the default HTML with these Bootstrap classes. To do this, we use the provided doxy-boot.js javascript file. | ||
|
||
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. | ||
Modifying these files alone is not enough to get a good integration. | ||
Bootstrap requires that certain classes be applied within the HTML. For example, | ||
a Bootstrap “table” needs to have a class called “table” in order to apply the Bootstrap | ||
table formatting. We just need to augment the default HTML with these Bootstrap classes. | ||
To do this, we use the provided doxy-boot.js javascript file. Also, here you will find extra ways to | ||
[customize the output](http://www.stack.nl/~dimitri/doxygen/manual/customize.html). | ||
|
||
# How to Integrate | ||
# Files | ||
|
||
This is easy to integrate into your own doxyfile. Simply tell your doxyfile to use these 3 files in the HTML section (see the example site for an example of each file): | ||
This theme uses the next files in the HTML section of doxywizard. See example-site. | ||
|
||
* HTML_HEADER=header.html | ||
* Adds a simple Bootstrap navbar for the title | ||
* Wraps the content in a Bootstrap container/row combo | ||
|
||
> Adds a Bootstrap navbar | ||
> | ||
> Wraps the content in a Bootstrap container/row | ||
* HTML_FOOTER=footer.html | ||
* Simply closes the extra divs opened in the header.html | ||
* HTML_EXTRA_STYLESHEET=customdoxygen.css | ||
|
||
You should also copy `doxy-boot.js` into your `html` directory, else it won't be found. | ||
> Closes the extra divs opened in the header.html | ||
We have also modified the HTML header/footer to load the Bootstrap css/javascript and our custom javascript (doxy-boot.js). This is where you can specify your own bootstrap compilation. These files will also need to be placed in the html directory (or sub-directory) else they wont be found. | ||
* HTML\_EXTRA_STYLESHEET=customdoxygen.css | ||
|
||
``` | ||
<link href="bootstrap3/css/bootstrap.min.css" rel="stylesheet"> | ||
<script src="bootstrap3/js/jquery-2.0.3.min.js"></script> | ||
<script src="bootstrap3/js/bootstrap.min.js"></script> | ||
<script type="text/javascript" src="doxy-boot.js"></script> | ||
``` | ||
> Adds additional styling such as a sticky footer | ||
* HTML\_EXTRA_FILES=doxy-boot.js | ||
|
||
> Where the magic happens to augment the HTML with bootstrap | ||
## Todo List | ||
* Menu is not correctly displayed when Doxygen sidebar is enabled. | ||
* Class index is incorrectly displayed. | ||
* Search engine is not fully responsive. | ||
* GENERATE_TREEVIEW option is not shown, or initialized correctly. | ||
|
||
## Credits | ||
This started as work done by CoActionOS and was extended further here. | ||
[Credit](http://coactionos.com/embedded%20design%20tips/2014/01/07/Tips-Integrating-Doxygen-and-Bootstrap/) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.