1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
|
CONFIGURE_FILE(${CMAKE_CURRENT_SOURCE_DIR}/conf.py.in ${CMAKE_CURRENT_BINARY_DIR}/conf.py)
# On windows, it is required that the paths to the dll dependencies (e.g. zlib, libpng, ...) are contained
# in the CMAKE_LIBRARY_PATH variable (especially with Visual Studio).
# Some warnings will be output when configuring the whole project if it is not the case.
# Otherwise, the Python API documentation will not be generated as the import of the tulip modules will fail.
# Turn CMAKE_LIBRARY_PATH list into a string in order to pass all its contents to the CMake command generating the doc,
# only the first list entry is transferred otherwise.
STRING(REPLACE ";" "," CMAKE_LIBRARY_PATH_STR "${CMAKE_LIBRARY_PATH}")
# Ensure that libraries paths are in MSYS format when using MSYS Makefiles,
# otherwise the documentation fails to build
IF("${CMAKE_GENERATOR}" MATCHES ".*MSYS.*")
file(TO_CMAKE_PATH "${CMAKE_LIBRARY_PATH_STR}" CMAKE_LIBRARY_PATH_STR)
ENDIF("${CMAKE_GENERATOR}" MATCHES ".*MSYS.*")
# copy .py files in CMAKE_CURRENT_BINARY_DIR
# in order to avoid polluting the source tree with python .pyc files
FILE(GLOB PYFILES *.py)
FILE(COPY ${PYFILES} DESTINATION .)
ADD_CUSTOM_TARGET(pythonBindingsDoc ALL ${CMAKE_COMMAND} -DSPHINX_EXECUTABLE=${SPHINX_EXECUTABLE}
-DPython_EXECUTABLE=${Python_EXECUTABLE}
-DSRC_DIR=${CMAKE_CURRENT_SOURCE_DIR}
-DBIN_DIR=${CMAKE_CURRENT_BINARY_DIR}
-DTULIP_SOURCE_DIR=${CMAKE_SOURCE_DIR}
-DTULIP_BUILD_DIR=${CMAKE_BINARY_DIR}
-DQT_BIN_DIR=${QT_BINARY_DIR}
-DAPPLE=${APPLE} -DWIN32=${WIN32}
-DCMAKE_LIBRARY_PATH=${CMAKE_LIBRARY_PATH_STR}
-P ${CMAKE_CURRENT_SOURCE_DIR}/genSphinxDoc.cmake
DEPENDS ${LibTulipCorePythonBindingsName}
${LibTulipGUIPythonBindingsName}
${TULIP_PLUGIN_TARGETS}
copyTulipPythonPlugins
copyTulipPluginsPyInBuild
VERBATIM)
SET_DIRECTORY_PROPERTIES(PROPERTIES ADDITIONAL_CLEAN_FILES "doc;doctrees")
INSTALL(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html
DESTINATION ${CMAKE_INSTALL_DOCDIR}/tulip-python
COMPONENT tulip_python_doc)
|
