Merge pull request #423 from thewtex/doc-build

doc build

Author: thewtex

.github/workflows/build-test-publish.yml

@@ -291,7 +291,7 @@ jobs:
 
           python -m pip install --upgrade pip
           python -m pip install ninja
-          python -m pip install 'sphinx==4.4.0' 'docutils<0.18'
+          python -m pip install 'sphinx==7.2.6'
           python -m pip install --ignore-installed six
           python -m pip install ipython
 

Superbuild/External-ClangFormat.cmake

@@ -26,6 +26,14 @@ else()
   #   `git config clangFormat.binary /path/to/clang-format`.
 endif()
 
+# Set the timestamps of the extracted files to their archived
+# timestamps.
+if(${CMAKE_VERSION} VERSION_LESS 3.24)
+  set(download_extract_timestamp_flag)
+else()
+  set(download_extract_timestamp_flag DOWNLOAD_EXTRACT_TIMESTAMP TRUE)
+endif()
+
 if(NOT TARGET ClangFormat AND _clang_format_hash)
   ExternalProject_add(ClangFormat
     URL ${_clang_format_url}
@@ -39,5 +47,6 @@ if(NOT TARGET ClangFormat AND _clang_format_hash)
     LOG_TEST 0
     LOG_INSTALL 0
     INSTALL_COMMAND ${CMAKE_COMMAND} -P ${CMAKE_CURRENT_BINARY_DIR}/ITKClangFormatConfig.cmake
+    ${download_extract_timestamp_flag}
     )
 endif()

Superbuild/External-Python.cmake

@@ -17,6 +17,6 @@ ExternalProject_Add(ITKPython
   DOWNLOAD_COMMAND ""
   CONFIGURE_COMMAND ${PYTHON_EXECUTABLE} -m venv "${_itk_venv}"
   BUILD_COMMAND ${ITKPYTHON_EXECUTABLE} -m pip install --upgrade pip
-  INSTALL_COMMAND ${ITKPYTHON_EXECUTABLE} -m pip install --ignore-installed itk>=5.4rc3 sphinx==4.4.0 docutils<0.18 traitlets==5.6.0 six black nbsphinx ipywidgets sphinx-contributors ipykernel matplotlib itkwidgets[lab,notebook]>=1.0a21 pydata-sphinx-theme
+  INSTALL_COMMAND ${ITKPYTHON_EXECUTABLE} -m pip install --ignore-installed itk>=5.4rc3 sphinx==7.2.6 six black nbsphinx ipywidgets sphinx-contributors ipykernel matplotlib itkwidgets[lab,notebook]>=1.0a51 pydata-sphinx-theme
   COMMAND ${CMAKE_COMMAND} -P ${CMAKE_CURRENT_BINARY_DIR}/ITKBlackConfig.cmake
   )