DOC: Only recompile Sphinx documentation when required

RTKConsortium · Feb 21, 2025 · 1659c08 · 1659c08
1 parent a62ea55
commit 1659c08
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 11 deletions.
diff --git a/documentation/docs/CMakeLists.txt b/documentation/docs/CMakeLists.txt
@@ -6,17 +6,14 @@ if(RTK_BUILD_SPHINX)
   # Copy the source tree documentation to the build tree before calling sphinx.
   # The images are downloaded when conf.py is run by sphinx.
   add_custom_target(copy_sources ALL
-    COMMAND ${CMAKE_COMMAND} -E remove_directory "${RTK_DOC_OUTPUT_DIR}/examples"
-    COMMAND ${CMAKE_COMMAND} -E remove_directory "${RTK_DOC_OUTPUT_DIR}/applications"
-    COMMAND ${CMAKE_COMMAND} -E remove_directory "${RTK_DOC_OUTPUT_DIR}/documentation"
-    COMMAND ${CMAKE_COMMAND} -E copy_directory "${RTK_SOURCE_DIR}/examples" "${RTK_DOC_OUTPUT_DIR}/examples"
-    COMMAND ${CMAKE_COMMAND} -E copy_directory "${RTK_SOURCE_DIR}/applications" "${RTK_DOC_OUTPUT_DIR}/applications"
-    COMMAND ${CMAKE_COMMAND} -E copy_directory "${RTK_SOURCE_DIR}/documentation" "${RTK_DOC_OUTPUT_DIR}/documentation"
-    COMMAND ${CMAKE_COMMAND} -E copy "${RTK_SOURCE_DIR}/conf.py" "${RTK_DOC_OUTPUT_DIR}/conf.py"
-    COMMAND ${CMAKE_COMMAND} -E copy "${RTK_SOURCE_DIR}/index.md" "${RTK_DOC_OUTPUT_DIR}/index.md"
-    COMMAND ${CMAKE_COMMAND} -E copy "${RTK_SOURCE_DIR}/GettingStarted.md" "${RTK_DOC_OUTPUT_DIR}/GettingStarted.md"
-    COMMAND ${CMAKE_COMMAND} -E copy "${RTK_SOURCE_DIR}/INSTALLATION.md" "${RTK_DOC_OUTPUT_DIR}/INSTALLATION.md"
-    COMMAND ${CMAKE_COMMAND} -E copy "${RTK_SOURCE_DIR}/CodeContribution.md" "${RTK_DOC_OUTPUT_DIR}/CodeContribution.md"
+    COMMAND ${CMAKE_COMMAND} -E create_symlink "${RTK_SOURCE_DIR}/examples" "${RTK_DOC_OUTPUT_DIR}/examples"
+    COMMAND ${CMAKE_COMMAND} -E create_symlink "${RTK_SOURCE_DIR}/applications" "${RTK_DOC_OUTPUT_DIR}/applications"
+    COMMAND ${CMAKE_COMMAND} -E create_symlink "${RTK_SOURCE_DIR}/documentation" "${RTK_DOC_OUTPUT_DIR}/documentation"
+    COMMAND ${CMAKE_COMMAND} -E copy_if_different "${RTK_SOURCE_DIR}/conf.py" "${RTK_DOC_OUTPUT_DIR}/conf.py"
+    COMMAND ${CMAKE_COMMAND} -E copy_if_different "${RTK_SOURCE_DIR}/index.md" "${RTK_DOC_OUTPUT_DIR}/index.md"
+    COMMAND ${CMAKE_COMMAND} -E copy_if_different "${RTK_SOURCE_DIR}/GettingStarted.md" "${RTK_DOC_OUTPUT_DIR}/GettingStarted.md"
+    COMMAND ${CMAKE_COMMAND} -E copy_if_different "${RTK_SOURCE_DIR}/INSTALLATION.md" "${RTK_DOC_OUTPUT_DIR}/INSTALLATION.md"
+    COMMAND ${CMAKE_COMMAND} -E copy_if_different "${RTK_SOURCE_DIR}/CodeContribution.md" "${RTK_DOC_OUTPUT_DIR}/CodeContribution.md"
     COMMENT "Copying documentation sources"
     )
 

diff --git a/documentation/docs/ExternalData/FetchExternalData.cmake b/documentation/docs/ExternalData/FetchExternalData.cmake
@@ -1,6 +1,10 @@
 # Fetch external data from https://data.kitware.com
 # Used by Sphinx conf.py during setup.
 #
+if(POLICY CMP0009)
+    cmake_policy(SET CMP0009 NEW)
+endif()
+
 set(link_content sha512)
 
 if(NOT EXTERNAL_DATA_INPUT_ROOT)