Added standalone doc build and target for integration with flp-mkdocs (#246)

Author: sy-c

CMakeLists.txt

@@ -25,6 +25,11 @@ project(Monitoring
 # Documentation dir
 add_subdirectory(doc)
 
+# simplified build mode for doc only
+if(ONLYDOC)
+  return()
+endif()
+
 # Add compiler flags for warnings and debug symbols
 set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -pedantic -Wextra -DBOOST_SYSTEM_NO_DEPRECATED -DBOOST_ERROR_CODE_HEADER_ONLY")
 

doc/CMakeLists.txt

@@ -1,6 +1,24 @@
 # @author  Barthélémy von Haller
 # @author  Adam Wegrzynek
+# @author  Sylvain Chapeland
 
+# define doc build path
+set(DOC_BUILD_DIR "${CMAKE_CURRENT_BINARY_DIR}/doc-build")
+
+# define doc installation path
+# ensures it ends with project name
+if (NOT CMAKE_INSTALL_DOCDIR)
+  set(CMAKE_INSTALL_DOCDIR "doc")
+endif()
+if (NOT "${CMAKE_INSTALL_DOCDIR}" MATCHES "${PROJECT_NAME}$")
+  set(CMAKE_INSTALL_DOCDIR "${CMAKE_INSTALL_DOCDIR}/${PROJECT_NAME}")
+endif()
+
+# log doc build/install paths
+message(STATUS "Documentation will be built in ${DOC_BUILD_DIR}")
+message(STATUS "Documentation will be installed in ${CMAKE_INSTALL_PREFIX}/${CMAKE_INSTALL_DOCDIR}")
+
+# doxygen-generated doc
 find_package(Doxygen OPTIONAL_COMPONENTS dot)
 if (DOXYGEN_FOUND)
   set(DOXYGEN_USE_MDFILE_AS_MAINPAGE "${CMAKE_SOURCE_DIR}/README.md")
@@ -16,10 +34,26 @@ if (DOXYGEN_FOUND)
   set(DOXYGEN_INTERACTIVE_SVG YES)
   set(DOXYGEN_DOT_GRAPH_MAX_NODES 100)
   set(DOXYGEN_DOT_TRANSPARENT YES)
-
+  set(DOXYGEN_OUTPUT_DIRECTORY ${DOC_BUILD_DIR})
+  
   doxygen_add_docs(doc
     ${CMAKE_SOURCE_DIR}
     COMMENT "Generating doxygen documentation for ${PROJECT_NAME}"
   )
 
+  # install generated files
+  install(
+    DIRECTORY ${DOC_BUILD_DIR}/html
+    TYPE DOC
+    OPTIONAL # because available only after "make doc"
+  )
+
 endif (DOXYGEN_FOUND)
+
+
+# if needed add other doc files from source tree
+# install(
+#  DIRECTORY . 
+#  TYPE DOC
+#  FILES_MATCHING PATTERN "*.md" "*.png"
+#)