docs/source/CMakeLists.txt

find_package(Sphinx REQUIRED)

# 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 3
find_package(PythonInterp 3 REQUIRED)

# Building using 'make_docs.py' python script
add_custom_target(ceres_docs ALL
                  ${PYTHON_EXECUTABLE}
                  "${Ceres_SOURCE_DIR}/scripts/make_docs.py"
                  "${Ceres_SOURCE_DIR}"
                  "${Ceres_BINARY_DIR}/docs"
                  "${SPHINX_EXECUTABLE}"
                  USES_TERMINAL
                  COMMENT "Building HTML documentation with Sphinx")
Update all CMake to lowercase function name style. 2015-08-09 15:18:42 +01:00			`find_package(Sphinx REQUIRED)`
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}/*")`

Fix dependency check for building documentation 2021-06-19 03:09:09 +02:00			`# Find python 3`
			`find_package(PythonInterp 3 REQUIRED)`

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`
Fix dependency check for building documentation 2021-06-19 03:09:09 +02:00			`${PYTHON_EXECUTABLE}`
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"`
Sphinx and CMake, based on this example: 2013-03-12 00:56:56 -07:00			`"${SPHINX_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")`