From 3445c9233f71b694064c8e67408bd7e57df0db10 Mon Sep 17 00:00:00 2001 From: Corentin Le Molgat Date: Fri, 4 Jul 2025 16:18:15 +0200 Subject: [PATCH] cpp: Add DoxygenLayout.xml move "detailedDescription" to top to follow devsite layout convention --- cmake/cpp.cmake | 1 + ortools/cpp/Doxyfile.in | 2 +- ortools/doxygen/DoxygenLayout.xml | 269 ++++++++++++++++++++++++++++++ 3 files changed, 271 insertions(+), 1 deletion(-) create mode 100644 ortools/doxygen/DoxygenLayout.xml diff --git a/cmake/cpp.cmake b/cmake/cpp.cmake index 551bbd255d..88dd525a99 100644 --- a/cmake/cpp.cmake +++ b/cmake/cpp.cmake @@ -593,6 +593,7 @@ if(BUILD_CXX_DOC) ${PROJECT_BINARY_DIR}/cpp/Doxyfile ${PROJECT_BINARY_DIR}/cpp/doxygen-awesome.css ${PROJECT_SOURCE_DIR}/ortools/doxygen/header.html + ${PROJECT_SOURCE_DIR}/ortools/doxygen/DoxygenLayout.xml ${PROJECT_SOURCE_DIR}/ortools/cpp/stylesheet.css WORKING_DIRECTORY ${PROJECT_SOURCE_DIR} COMMENT "Generating C++ API documentation with Doxygen" diff --git a/ortools/cpp/Doxyfile.in b/ortools/cpp/Doxyfile.in index 3b22a9d3b4..4f863f4d6a 100644 --- a/ortools/cpp/Doxyfile.in +++ b/ortools/cpp/Doxyfile.in @@ -796,7 +796,7 @@ FILE_VERSION_FILTER = # DoxygenLayout.xml, doxygen will parse it automatically even if the LAYOUT_FILE # tag is left empty. -LAYOUT_FILE = +LAYOUT_FILE = ortools/doxygen/DoxygenLayout.xml # The CITE_BIB_FILES tag can be used to specify one or more bib files containing # the reference definitions. This must be a list of .bib files. The .bib diff --git a/ortools/doxygen/DoxygenLayout.xml b/ortools/doxygen/DoxygenLayout.xml new file mode 100644 index 0000000000..5708d9ef86 --- /dev/null +++ b/ortools/doxygen/DoxygenLayout.xml @@ -0,0 +1,269 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +