summaryrefslogtreecommitdiffstats
path: root/cmake/docs.cmake
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--cmake/docs.cmake46
1 files changed, 46 insertions, 0 deletions
diff --git a/cmake/docs.cmake b/cmake/docs.cmake
new file mode 100644
index 0000000..286d027
--- /dev/null
+++ b/cmake/docs.cmake
@@ -0,0 +1,46 @@
+# ---- Dependencies ----
+
+set(extract_timestamps "")
+if (CMAKE_VERSION VERSION_GREATER_EQUAL "3.24")
+ set(extract_timestamps DOWNLOAD_EXTRACT_TIMESTAMP YES)
+endif ()
+
+include(FetchContent)
+FetchContent_Declare(
+ mcss URL
+ https://github.com/friendlyanon/m.css/releases/download/release-1/mcss.zip
+ URL_MD5 00cd2757ebafb9bcba7f5d399b3bec7f
+ SOURCE_DIR "${PROJECT_BINARY_DIR}/mcss"
+ UPDATE_DISCONNECTED YES
+ ${extract_timestamps}
+)
+FetchContent_MakeAvailable(mcss)
+
+find_package(Python3 3.6 REQUIRED)
+
+# ---- Declare documentation target ----
+
+set(
+ DOXYGEN_OUTPUT_DIRECTORY "${PROJECT_BINARY_DIR}/docs"
+ CACHE PATH "Path for the generated Doxygen documentation"
+)
+
+set(working_dir "${PROJECT_BINARY_DIR}/docs")
+
+foreach (file IN ITEMS Doxyfile conf.py)
+ configure_file("docs/${file}.in" "${working_dir}/${file}" @ONLY)
+endforeach ()
+
+set(mcss_script "${mcss_SOURCE_DIR}/documentation/doxygen.py")
+set(config "${working_dir}/conf.py")
+
+add_custom_target(
+ docs
+ COMMAND "${CMAKE_COMMAND}" -E remove_directory
+ "${DOXYGEN_OUTPUT_DIRECTORY}/html"
+ "${DOXYGEN_OUTPUT_DIRECTORY}/xml"
+ COMMAND "${Python3_EXECUTABLE}" "${mcss_script}" "${config}"
+ COMMENT "Building documentation using Doxygen and m.css"
+ WORKING_DIRECTORY "${working_dir}"
+ VERBATIM
+)