doxyconfig

Add this repository as a submodule to your project.

git submodule add https://github.com/LizardByte/doxyconfig.git third-party/doxyconfig

Place project specific Doxyfile config in ./docs/Doxyfile. You can overwrite anything from the common config here.

Add the following to your CMakeLists.txt file.

option(BUILD_DOCS "Build documentation" ON)
if(BUILD_DOCS)
    add_subdirectory(third-party/doxyconfig docs)
endif()

Add the following to your .gitignore file.

# doxyconfig
docs/doxyconfig*

Optionally, add the following to the input list in your Doxyfile.

INPUT += ../third-party/doxyconfig/docs/source_code.md

Optionally, copy the .readthedocs.yaml file to the root of your project.