2013-08-16 22:15:15 +08:00
|
|
|
find_package(Sphinx QUIET)
|
2013-08-02 04:30:59 +08:00
|
|
|
|
2013-08-16 22:15:15 +08:00
|
|
|
if(NOT DEFINED SPHINX_THEME)
|
|
|
|
|
set(SPHINX_THEME default)
|
|
|
|
|
endif()
|
|
|
|
|
|
|
|
|
|
if(NOT DEFINED SPHINX_THEME_DIR)
|
|
|
|
|
set(SPHINX_THEME_DIR)
|
|
|
|
|
endif()
|
|
|
|
|
|
|
|
|
|
# configured documentation tools and intermediate build results
|
|
|
|
|
set(BINARY_BUILD_DIR "${CMAKE_CURRENT_BINARY_DIR}/_build")
|
|
|
|
|
|
|
|
|
|
# Sphinx cache with pickled ReST documents
|
|
|
|
|
set(SPHINX_CACHE_DIR "${CMAKE_CURRENT_BINARY_DIR}/_doctrees")
|
|
|
|
|
|
|
|
|
|
# HTML output directory
|
|
|
|
|
set(SPHINX_HTML_DIR "${CMAKE_CURRENT_BINARY_DIR}/html")
|
|
|
|
|
|
|
|
|
|
configure_file(
|
|
|
|
|
"${CMAKE_CURRENT_SOURCE_DIR}/conf.py.in"
|
|
|
|
|
"${BINARY_BUILD_DIR}/conf.py"
|
|
|
|
|
@ONLY)
|
|
|
|
|
|
|
|
|
|
if(SPHINX_FOUND)
|
|
|
|
|
add_custom_target(docs
|
|
|
|
|
${SPHINX_EXECUTABLE}
|
|
|
|
|
-b html
|
|
|
|
|
-c "${BINARY_BUILD_DIR}"
|
|
|
|
|
-d "${SPHINX_CACHE_DIR}"
|
|
|
|
|
"${CMAKE_CURRENT_SOURCE_DIR}"
|
|
|
|
|
"${SPHINX_HTML_DIR}"
|
|
|
|
|
COMMENT "Building HTML documentation with Sphinx")
|
2013-08-02 04:30:59 +08:00
|
|
|
else()
|
2013-08-16 22:15:15 +08:00
|
|
|
add_custom_target(docs
|
|
|
|
|
echo "Please install python-sphinx to build the docs or read the docs online: https://projecttox.readthedocs.org/en/latest"
|
|
|
|
|
- COMMENT "No sphinx executable found")
|
2013-08-01 05:38:21 +08:00
|
|
|
endif()
|
