DoxyPress – Modern Doxygen
3 comments
·January 10, 2025eXpl0it3r
Any reason to not upstream the refactorings?
The default theme doesn't look that great on mobile. At least one can change the side menu size.
The challenges I'm facing with doxygen is to create a seamless integration with a MkDocs site, but not just for a single version. The current workaround of manually copying the generated MkDocs header and footer isn't very automated...
lidavidm
I'm also curious why it's a fork (I'm sure there's a good reason?)
Coincidentally I was looking into C++ documentation generators again.
In terms of integration, what I've settled on for apache/arrow-adbc is using Sphinx as the toplevel site generator, then writing a script that generates fake Intersphinx indices for a Doxygen site. That way you can link to Doxygen items from within Sphinx without having to hardcode URLs, instead by referencing a class name or similar, and Sphinx will warn if you reference something nonexistent, without having to use something like breathe that tries to render the Doxygen output within Sphinx. (Same approach with Javadoc -> Sphinx, too.)
Also of note:
> What is CopperSpice
> CopperSpice is a C++ library derived from the Qt framework. Our motivation for developing CopperSpice was to change the core design of the libraries leveraging modern C++ functionality.
> The redesign allowed us to completely remove the Meta-Object Compiler (moc) system. Moc is a code generator and did not support many aspects of modern C++ including templates, complex data types, static type checking, and relied heavily on string comparisons. Removing moc improves run time performance, reduces the complexity of the build process, and allows more issues to be detected at compile time.
This sounds pretty great. Does anyone have experience using it?