Merge 5276a43 into c47feab

CMakeLists.txt

@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.3)
+cmake_minimum_required(VERSION 3.11)
 
 # Project definition
 
@@ -985,11 +985,17 @@ foreach(PLUGIN ${PLUGINS})
     add_subdirectory(src/plugins/${PLUGIN})
 endforeach()
 
-# Configure our help file
+# Fetch parts of our documentation and build it
 
-configure_file(${CMAKE_SOURCE_DIR}/doc/${CMAKE_PROJECT_NAME}.qhcp.in
+execute_process(COMMAND ${CMAKE_COMMAND} -E copy_directory ${CMAKE_SOURCE_DIR}/doc
+                                                           ${PROJECT_BUILD_DIR}/doc)
+
+configure_file(${PROJECT_BUILD_DIR}/doc/${CMAKE_PROJECT_NAME}.qhcp.in
                ${PROJECT_BUILD_DIR}/doc/${CMAKE_PROJECT_NAME}.qhcp)
 
+build_documentation(user)
+build_documentation(developer)
+
 # Build the GUI version of OpenCOR
 
 qt5_wrap_cpp(SOURCES_MOC ${HEADERS_MOC})

cmake/common.cmake

@@ -45,6 +45,39 @@ endmacro()
 
 #===============================================================================
 
+macro(build_documentation DOCUMENTATION_NAME)
+    # Build the given documentation as an external project and have it copied to
+    # our final documentation directory
+
+    set(DOCUMENTATION_BUILD ${DOCUMENTATION_NAME}DocumentationBuild)
+
+    string(REPLACE ";" "|"
+           DOCUMENTATION_SPHINX_EXECUTABLE "${SPHINX_EXECUTABLE}")
+
+    ExternalProject_Add(${DOCUMENTATION_BUILD}
+        SOURCE_DIR
+            ${CMAKE_SOURCE_DIR}/ext/doc/${DOCUMENTATION_NAME}
+        GIT_REPOSITORY
+            https://github.com/opencor/${DOCUMENTATION_NAME}-documentation
+        CMAKE_ARGS
+            -DPYTHON_EXECUTABLE=${PYTHON_EXECUTABLE}
+            -DSPHINX_EXECUTABLE=${DOCUMENTATION_SPHINX_EXECUTABLE}
+        LIST_SEPARATOR
+            |
+        INSTALL_COMMAND
+            ${CMAKE_COMMAND} -E copy_directory ${PROJECT_BUILD_DIR}/ext/Build/${DOCUMENTATION_BUILD}/html
+                                               ${PROJECT_BUILD_DIR}/doc/${DOCUMENTATION_NAME}
+    )
+
+    # Add our external project as a dependency to our project build target, so
+    # that our Help window plugin can generate the help files that will be
+    # embedded in OpenCOR as a resource
+
+    add_dependencies(${PROJECT_BUILD_TARGET} ${DOCUMENTATION_BUILD})
+endmacro()
+
+#===============================================================================
+
 macro(add_plugin PLUGIN_NAME)
     # Various initialisations