fmt/doc/CMakeLists.txt

find_program(DOXYGEN doxygen)
if (NOT DOXYGEN)
  message(STATUS "Target 'doc' disabled (requires doxygen)")
  return ()
endif ()

find_package(PythonInterp QUIET REQUIRED)
find_program(SPHINX_EXECUTABLE NAMES sphinx-build sphinx-build-3)

add_custom_target(doc
  COMMAND ${PYTHON_EXECUTABLE} ${CMAKE_CURRENT_SOURCE_DIR}/build.py
                               ${SPHINX_EXECUTABLE} ${FMT_VERSION}
  SOURCES api.rst syntax.rst usage.rst build.py conf.py _templates/layout.html)

include(GNUInstallDirs)
install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html/
        DESTINATION ${CMAKE_INSTALL_DATAROOTDIR}/doc/fmt OPTIONAL
        PATTERN ".doctrees" EXCLUDE)
Make documentation builds more reproducible by using virtualenv 2015-04-10 15:39:09 +00:00			`find_program(DOXYGEN doxygen)`
			`if (NOT DOXYGEN)`
			`message(STATUS "Target 'doc' disabled (requires doxygen)")`
Only enable doc target if breathe is available 2015-03-02 00:35:29 +00:00			`return ()`
			`endif ()`

Use Cmake to find Python and Sphinx-doc. Signed-off-by: Vitaly Zaitsev <vitaly@easycoding.org> 2020-07-07 14:35:01 +00:00			`find_package(PythonInterp QUIET REQUIRED)`
			`find_program(SPHINX_EXECUTABLE NAMES sphinx-build sphinx-build-3)`

Pass version from CMake to Sphinx 2015-11-23 16:10:02 +00:00			`add_custom_target(doc`
Use Cmake to find Python and Sphinx-doc. Signed-off-by: Vitaly Zaitsev <vitaly@easycoding.org> 2020-07-07 14:35:01 +00:00			`COMMAND ${PYTHON_EXECUTABLE} ${CMAKE_CURRENT_SOURCE_DIR}/build.py`
			`${SPHINX_EXECUTABLE} ${FMT_VERSION}`
Improve docs 2018-12-28 23:05:42 +00:00			`SOURCES api.rst syntax.rst usage.rst build.py conf.py _templates/layout.html)`
Only add the doc target if doxygen and sphinx-build are available 2015-01-30 20:53:52 +00:00
Use Cmake to find Python and Sphinx-doc. Signed-off-by: Vitaly Zaitsev <vitaly@easycoding.org> 2020-07-07 14:35:01 +00:00			`include(GNUInstallDirs)`
Make documentation installation optional (#333) 2016-05-24 14:03:08 +00:00			`install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html/`
Use Cmake to find Python and Sphinx-doc. Signed-off-by: Vitaly Zaitsev <vitaly@easycoding.org> 2020-07-07 14:35:01 +00:00			`DESTINATION ${CMAKE_INSTALL_DATAROOTDIR}/doc/fmt OPTIONAL`
Don't install sphinx cache files When building documentation sphinx creates cached files in the .doctrees directory and aren't required for viewing documentation only for building. As added benefit this makes fmt reprodcubile as the cached files are different when the build environment is varied. 2020-05-29 21:19:16 +00:00			`PATTERN ".doctrees" EXCLUDE)`