mirror of
https://github.com/nextcloud/desktop.git
synced 2024-11-27 17:37:36 +03:00
066c0ba189
sphinx will fail in a race condition, if every sphinx target uses the same CACHE dir: Exception occurred: File "/usr/lib/pymodules/python2.7/sphinx/cmdline.py", line 189, in main app.build(force_all, filenames) File "/usr/lib/pymodules/python2.7/sphinx/application.py", line 204, in build self.builder.build_update() File "/usr/lib/pymodules/python2.7/sphinx/builders/__init__.py", line 196, in build_update 'out of date' % len(to_build)) File "/usr/lib/pymodules/python2.7/sphinx/builders/__init__.py", line 238, in build self.env.topickle(path.join(self.doctreedir, ENV_PICKLE_FILENAME)) File "/usr/lib/pymodules/python2.7/sphinx/environment.py", line 351, in topickle movefile(filename + '.tmp', filename) File "/usr/lib/pymodules/python2.7/sphinx/util/osutil.py", line 104, in movefile os.rename(source, dest) OSError: [Errno 2] No such file or directory
79 lines
3.6 KiB
CMake
79 lines
3.6 KiB
CMake
if(SPHINX_FOUND)
|
|
|
|
# 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")
|
|
set(SPHINX_MAN_DIR "${CMAKE_CURRENT_BINARY_DIR}/man")
|
|
set(SPHINX_PDF_DIR "${CMAKE_CURRENT_BINARY_DIR}/latex")
|
|
set(SPHINX_QCH_DIR "${CMAKE_CURRENT_BINARY_DIR}/qthelp")
|
|
set(SPHINX_HTMLHELP_DIR "${CMAKE_CURRENT_BINARY_DIR}/htmlhelp")
|
|
set(MSHTML_COMPILER wine 'C:\\Program Files\\HTML Help Workshop\\hhc.exe')
|
|
# assets
|
|
set(LATEX_LOGO "${CMAKE_CURRENT_SOURCE_DIR}/logo-blue.pdf")
|
|
|
|
configure_file("${CMAKE_CURRENT_SOURCE_DIR}/conf.py.in" conf.py @ONLY)
|
|
|
|
if(WITH_DOC)
|
|
add_custom_target(doc ALL DEPENDS doc-html doc-man COMMENT "Building documentation...")
|
|
install(DIRECTORY ${SPHINX_HTML_DIR} DESTINATION ${CMAKE_INSTALL_DOCDIR})
|
|
install(DIRECTORY ${SPHINX_MAN_DIR} DESTINATION ${CMAKE_INSTALL_MANDIR})
|
|
else(WITH_DOC)
|
|
add_custom_target(doc DEPENDS doc-html doc-man COMMENT "Building documentation...")
|
|
endif(WITH_DOC)
|
|
|
|
if(PDFLATEX_FOUND)
|
|
# if this still fails on Debian/Ubuntu, run
|
|
# apt-get install texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended
|
|
add_custom_target(doc-latex ${SPHINX_EXECUTABLE}
|
|
-q -c . -b latex
|
|
-d ${SPHINX_CACHE_DIR}/latex
|
|
-D latex_logo=${LATEX_LOGO}
|
|
${CMAKE_CURRENT_SOURCE_DIR}
|
|
${SPHINX_PDF_DIR} )
|
|
add_custom_target(doc-pdf make -C ${SPHINX_PDF_DIR} all-pdf
|
|
DEPENDS doc-latex )
|
|
add_dependencies(doc doc-pdf)
|
|
if (WITH_DOC)
|
|
install(DIRECTORY ${SPHINX_PDF_DIR} DESTINATION ${CMAKE_INSTALL_DOCDIR})
|
|
endif (WITH_DOC)
|
|
endif(PDFLATEX_FOUND)
|
|
if (EXISTS ${QT_QCOLLECTIONGENERATOR_EXECUTABLE})
|
|
add_custom_target( doc-qch-sphinx ${SPHINX_EXECUTABLE}
|
|
-q -c . -b qthelp
|
|
-d ${SPHINX_CACHE_DIR}/qthelp
|
|
${CMAKE_CURRENT_SOURCE_DIR}
|
|
${SPHINX_QCH_DIR} )
|
|
add_custom_target( doc-qch ${QT_QCOLLECTIONGENERATOR_EXECUTABLE}
|
|
${SPHINX_QCH_DIR}/*.qhcp
|
|
DEPENDS doc-qch-sphinx )
|
|
add_dependencies(doc doc-qch)
|
|
if (WITH_DOC)
|
|
install(DIRECTORY ${SPHINX_QCH_DIR} DESTINATION ${CMAKE_INSTALL_DOCDIR})
|
|
endif (WITH_DOC)
|
|
endif()
|
|
add_custom_target( doc-html ${SPHINX_EXECUTABLE}
|
|
-q -c . -b html
|
|
-d ${SPHINX_CACHE_DIR}/html
|
|
${CMAKE_CURRENT_SOURCE_DIR}
|
|
${SPHINX_HTML_DIR} )
|
|
add_custom_target( doc-man ${SPHINX_EXECUTABLE}
|
|
-q -c . -b man
|
|
-d ${SPHINX_CACHE_DIR}/man
|
|
${CMAKE_CURRENT_SOURCE_DIR}
|
|
${SPHINX_MAN_DIR} )
|
|
|
|
## Building CHM files requires HTML Help Workshop. Since it requires wine
|
|
## with special dependencies, it's impossible to write a cmake check for it.
|
|
## This is why doc-chm is not a dependency for doc. Instead, run
|
|
## doc/scripts/htmlhelp.exe to install them and run this target
|
|
## explicitly.
|
|
add_custom_target( doc-chm-sphinx ${SPHINX_EXECUTABLE}
|
|
-q -c . -b htmlhelp
|
|
-D html_theme=basic
|
|
-d ${SPHINX_CACHE_DIR}/htmlhelp
|
|
${CMAKE_CURRENT_SOURCE_DIR}
|
|
${SPHINX_HTMLHELP_DIR} )
|
|
add_custom_target( doc-chm pushd ${SPHINX_HTMLHELP_DIR}; ${MSHTML_COMPILER} *.hhp; popd
|
|
DEPENDS doc-chm-sphinx )
|
|
endif(SPHINX_FOUND)
|