docs/source/CMakeLists.txt

# HTML output directory
set(SPHINX_HTML_DIR "${Ceres_BINARY_DIR}/docs/html")

# Install documentation
install(DIRECTORY ${SPHINX_HTML_DIR}
        DESTINATION ${CMAKE_INSTALL_DOCDIR}
        COMPONENT Doc
        PATTERN "${SPHINX_HTML_DIR}/*")

# Find python
find_package(Python REQUIRED COMPONENTS Interpreter)

# Building using 'make_docs.py' python script
add_custom_target(ceres_docs ALL
                  $<TARGET_FILE:Python::Interpreter>
                  "${Ceres_SOURCE_DIR}/scripts/make_docs.py"
                  "${Ceres_SOURCE_DIR}"
                  "${Ceres_BINARY_DIR}/docs"
                  "${Sphinx_BUILD_EXECUTABLE}"
                  USES_TERMINAL
                  COMMENT "Building HTML documentation with Sphinx")
Sphinx and CMake, based on this example: 2013-03-12 00:56:56 -07:00			`# HTML output directory`
Use Ceres_[SOURCE/BINARY]_DIR not CMAKE_XXX_DIR to support nesting. 2017-04-02 20:39:38 +01:00			`set(SPHINX_HTML_DIR "${Ceres_BINARY_DIR}/docs/html")`
Sphinx and CMake, based on this example: 2013-03-12 00:56:56 -07:00
			`# Install documentation`
Update all CMake to lowercase function name style. 2015-08-09 15:18:42 +01:00			`install(DIRECTORY ${SPHINX_HTML_DIR}`
Standardize path handling using GNUInstallDirs 2022-02-16 01:18:43 +01:00			`DESTINATION ${CMAKE_INSTALL_DOCDIR}`
Sphinx and CMake, based on this example: 2013-03-12 00:56:56 -07:00			`COMPONENT Doc`
			`PATTERN "${SPHINX_HTML_DIR}/*")`

Require at least CMake 3.16 2023-09-09 20:55:57 +02:00			`# Find python`
			`find_package(Python REQUIRED COMPONENTS Interpreter)`
Fix dependency check for building documentation 2021-06-19 03:09:09 +02:00
Sphinx and CMake, based on this example: 2013-03-12 00:56:56 -07:00			`# Building using 'make_docs.py' python script`
Update all CMake to lowercase function name style. 2015-08-09 15:18:42 +01:00			`add_custom_target(ceres_docs ALL`
Require at least CMake 3.16 2023-09-09 20:55:57 +02:00			`$<TARGET_FILE:Python::Interpreter>`
Use Ceres_[SOURCE/BINARY]_DIR not CMAKE_XXX_DIR to support nesting. 2017-04-02 20:39:38 +01:00			`"${Ceres_SOURCE_DIR}/scripts/make_docs.py"`
			`"${Ceres_SOURCE_DIR}"`
			`"${Ceres_BINARY_DIR}/docs"`
Rework the Sphinx find module 2023-09-10 15:25:31 +02:00			`"${Sphinx_BUILD_EXECUTABLE}"`
Retain terminal formatting when building docs 2022-05-28 20:29:04 +02:00			`USES_TERMINAL`
Sphinx and CMake, based on this example: 2013-03-12 00:56:56 -07:00			`COMMENT "Building HTML documentation with Sphinx")`