|
@@ -80,19 +80,13 @@ if (BUILDDOC)
|
80
|
80
|
list (GET PYTHON_VERSION_LIST 0 PYTHON_VERSION_MAJOR)
|
81
|
81
|
list (GET PYTHON_VERSION_LIST 1 PYTHON_VERSION_MINOR)
|
82
|
82
|
set (SITE_PACKAGES ${CMAKE_INSTALL_PREFIX}/${LIB_INSTALL_DIR}/python${PYTHON_VERSION_MAJOR}.${PYTHON_VERSION_MINOR}/site-packages)
|
83
|
|
-
|
84
|
|
- # throw a warning if site-packages doesn't exist, might need a more robust way on adding make install dependency and paths
|
85
|
|
- if (NOT EXISTS ${CMAKE_CURRENT_BINARY_DIR}/${SITE_PACKAGES})
|
86
|
|
- message( WARNING " - Sphinx documentation 'pydoc' target depends on python libs generated by 'install' target. Run that first!")
|
87
|
|
- endif()
|
88
|
|
-
|
89
|
83
|
configure_file (${CMAKE_CURRENT_SOURCE_DIR}/doxy/conf.py.in ${CMAKE_CURRENT_BINARY_DIR}/pydoc/conf.py @ONLY)
|
90
|
84
|
configure_file (${CMAKE_CURRENT_SOURCE_DIR}/doxy/index.rst ${CMAKE_CURRENT_BINARY_DIR}/pydoc/index.rst COPYONLY)
|
91
|
85
|
add_custom_target (pydoc
|
92
|
|
- COMMAND rm -r ${CMAKE_BINARY_DIR}/python-staging && mkdir -p ${CMAKE_BINARY_DIR}/python-staging
|
93
|
|
- COMMAND find ${CMAKE_BINARY_DIR}/src -name "_pyupm_*.so" -exec cp {} ${CMAKE_BINARY_DIR}/python-staging \;
|
94
|
|
- COMMAND find ${CMAKE_BINARY_DIR}/src -name "pyupm_*.py" -exec cp {} ${CMAKE_BINARY_DIR}/python-staging \;
|
95
|
|
- COMMAND ${SPHINX_API_EXECUTABLE} -f -o pydoc ${CMAKE_BINARY_DIR}/python-staging
|
|
86
|
+ COMMAND rm -r -f ${CMAKE_BINARY_DIR}/pyupm && mkdir -p ${CMAKE_BINARY_DIR}/pyupm
|
|
87
|
+ COMMAND find ${CMAKE_BINARY_DIR}/src -name "_pyupm_*.so" -exec cp {} ${CMAKE_BINARY_DIR}/pyupm \;
|
|
88
|
+ COMMAND find ${CMAKE_BINARY_DIR}/src -name "pyupm_*.py" -exec cp {} ${CMAKE_BINARY_DIR}/pyupm \;
|
|
89
|
+ COMMAND ${SPHINX_API_EXECUTABLE} -f -o pydoc ${CMAKE_BINARY_DIR}/pyupm
|
96
|
90
|
# todo: use a separate cmake FILE module for string replacement instead
|
97
|
91
|
COMMAND ${SPHINX_EXECUTABLE} -b html pydoc html/python
|
98
|
92
|
COMMAND sed -i.bak s|\">pyupm_|\">|g html/python/index.html html/python/modules.html
|
|
@@ -106,19 +100,19 @@ if (BUILDDOC)
|
106
|
100
|
find_package(Yuidoc)
|
107
|
101
|
if(YUIDOC_FOUND)
|
108
|
102
|
# node required for Yuidoc documentation
|
109
|
|
- find_package(Node)
|
110
|
|
- file(GLOB_RECURSE JSDOC_FILES RELATIVE ${CMAKE_CURRENT_SOURCE_DIR}/doxy/node doxy/node/*)
|
111
|
|
- foreach(JSDOC_FILE ${JSDOC_FILES})
|
112
|
|
- configure_file(${CMAKE_CURRENT_SOURCE_DIR}/doxy/node/${JSDOC_FILE} ${CMAKE_CURRENT_BINARY_DIR}/${JSDOC_FILE} COPYONLY)
|
113
|
|
- endforeach()
|
114
|
|
- add_custom_target(jsdoc
|
115
|
|
- NODE_PATH=${NODE_PATH} ${NODE_EXECUTABLE} docgen -m upm -i xml -t ${CMAKE_CURRENT_SOURCE_DIR}/src -g ../../../../docs/images/
|
116
|
|
- COMMAND ${YUIDOC_EXECUTABLE} -C --no-sort --helpers generators/yuidoc/helper.js --themedir generators/yuidoc/tmpl -o html/node jsdoc/yuidoc/upm
|
117
|
|
- COMMAND NODE_PATH=${NODE_PATH} ${NODE_EXECUTABLE} tolower -i html/node
|
118
|
|
- DEPENDS doc
|
119
|
|
- WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
|
|
103
|
+ find_package(Node)
|
|
104
|
+ file(GLOB_RECURSE JSDOC_FILES RELATIVE ${CMAKE_CURRENT_SOURCE_DIR}/doxy/node doxy/node/*)
|
|
105
|
+ foreach(JSDOC_FILE ${JSDOC_FILES})
|
|
106
|
+ configure_file(${CMAKE_CURRENT_SOURCE_DIR}/doxy/node/${JSDOC_FILE} ${CMAKE_CURRENT_BINARY_DIR}/${JSDOC_FILE} COPYONLY)
|
|
107
|
+ endforeach()
|
|
108
|
+ add_custom_target(jsdoc
|
|
109
|
+ NODE_PATH=${NODE_PATH} ${NODE_EXECUTABLE} docgen -m upm -i xml -t ${CMAKE_CURRENT_SOURCE_DIR}/src -g ../../../../docs/images/
|
|
110
|
+ COMMAND ${YUIDOC_EXECUTABLE} -C --no-sort --helpers generators/yuidoc/helper.js --themedir generators/yuidoc/tmpl -o html/node jsdoc/yuidoc/upm
|
|
111
|
+ COMMAND NODE_PATH=${NODE_PATH} ${NODE_EXECUTABLE} tolower -i html/node
|
|
112
|
+ DEPENDS doc
|
|
113
|
+ WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
|
120
|
114
|
COMMENT "Generating API documentation with Yuidoc" VERBATIM
|
121
|
|
- )
|
|
115
|
+ )
|
122
|
116
|
endif()
|
123
|
117
|
endif()
|
124
|
118
|
|