OUTPUT_DIRECTORY = “_build” - the output directory.GENERATE_LATEX = NO - it’s on by default, but you might not need it.VERBATIM_HEADERS = NO- otherwise sources for header files will be included in the docs - I usually find this redundant.PROJECT_NAME - self explanatory, here we set `C++ Doxygen Sphinx Breathe`.Run in the docs_sphinx directory: doxygen -g mv Doxyfile Doxyfile.inĮdit the following fields in Doxyfile.in: Now for the heart of the matter: we are going to use Breathe to hook up the output from Doxygen to your Sphinx nonsense.įor clarity we will start over, but you could copy over the Doxygen.in file from the last part and make some edits. Now _build/html/index.html should look better! Hook it up to your C++ code via output from Doxygen via Breathe You could fill out the bottom three options later. To refresh your memory, we had for the contents of the header file:
![doxygen tutorial doxygen tutorial](https://embeddedinventor.com/wp-content/uploads/2020/12/Slide1-1-1024x576.jpg)
Setting up the projectįrom the previous post, your project should already have the following directories and files: CMakeLists.txt docs_doxygen/Doxyfile.in include/cpp_doxygen_sphinx.hpp src/cpp_doxygen_sphinx.cppīut: The only parts you will really need for the next part are: include/cpp_doxygen_sphinx.hpp src/cpp_doxygen_sphinx.cpp If you aren’t on a Mac, I don’t know, somehow figure out those installations with your favorite package manager. Any other Sphinx configuration packages you may want, e.g.:.Make sure you have all the needed tools installed:
Doxygen tutorial how to#
In the last post, we already showed how to get warnings for documentation. Note that we won’t incorporate this into the CMake process. This next part will be about getting an actually good looking website out there using Doxygen/ Sphinx/ ReadTheDocs/ Breathe (oof).
![doxygen tutorial doxygen tutorial](https://image1.slideserve.com/1832156/example-1-preparing-for-doxygen-l.jpg)
Setting up Doxygen/Sphinx/ReadTheDocs/Breathe