1.1 --- a/docs/src/CMakeLists.txt Sun Sep 03 09:10:16 2023 +0200
1.2 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000
1.3 @@ -1,75 +0,0 @@
1.4 -#
1.5 -# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
1.6 -#
1.7 -# Copyright 2021 Mike Becker, Olaf Wintermann All rights reserved.
1.8 -#
1.9 -# Redistribution and use in source and binary forms, with or without
1.10 -# modification, are permitted provided that the following conditions are met:
1.11 -#
1.12 -# 1. Redistributions of source code must retain the above copyright
1.13 -# notice, this list of conditions and the following disclaimer.
1.14 -#
1.15 -# 2. Redistributions in binary form must reproduce the above copyright
1.16 -# notice, this list of conditions and the following disclaimer in the
1.17 -# documentation and/or other materials provided with the distribution.
1.18 -#
1.19 -# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
1.20 -# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
1.21 -# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
1.22 -# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
1.23 -# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
1.24 -# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
1.25 -# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
1.26 -# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
1.27 -# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
1.28 -# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
1.29 -# POSSIBILITY OF SUCH DAMAGE.
1.30 -#
1.31 -
1.32 -set(PANDOC_DESTDIR ${CMAKE_BINARY_DIR}/docs/web)
1.33 -set(PANDOC_ARGS -c ucx.css -B header.html -A footer.html -T 'UAP Common Extensions')
1.34 -set(PANDOC_SRC index.md license.md install.md features.md)
1.35 -set(LOGO_PATH ../../uaplogo.png)
1.36 -
1.37 -if (NOT EXISTS ${PANDOC_EXECUTABLE})
1.38 - find_program(PANDOC_EXECUTABLE pandoc)
1.39 - if(NOT EXISTS ${PANDOC_EXECUTABLE})
1.40 - message(STATUS "Pandoc not found, docs-html target will not be generated.")
1.41 - return()
1.42 - endif()
1.43 -endif()
1.44 -
1.45 -message(STATUS "HTML Documentation will be generated at: ${PANDOC_DESTDIR}.")
1.46 -file(MAKE_DIRECTORY ${PANDOC_DESTDIR})
1.47 -
1.48 -# UCX 3.0 documentation
1.49 -foreach(source_file ${PANDOC_SRC})
1.50 - string(REPLACE .md .html dest_file ${source_file})
1.51 - string(PREPEND dest_file "${PANDOC_DESTDIR}/")
1.52 - list(APPEND PANDOC_DEST ${dest_file})
1.53 - add_custom_command(
1.54 - OUTPUT ${dest_file}
1.55 - COMMAND ${PANDOC_EXECUTABLE} ${PANDOC_ARGS} -o ${dest_file} ${source_file}
1.56 - WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
1.57 - MAIN_DEPENDENCY ${source_file}
1.58 - DEPENDS header.html footer.html
1.59 - )
1.60 -endforeach()
1.61 -
1.62 -# UCX 2.1 documentation
1.63 -add_custom_target(docs-html-21
1.64 - COMMAND ${PANDOC_EXECUTABLE} -c ucx.css -B header-ucx2.html -A footer.html
1.65 - -T 'UAP Common Extensions' -o ${PANDOC_DESTDIR}/modules-ucx2.html modules-ucx2.md
1.66 - WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
1.67 - DEPENDS modules-ucx2.md header-ucx2.html footer.html
1.68 - COMMENT "Adding UCX 2.1 HTML documentation."
1.69 -)
1.70 -
1.71 -# Collect all HTML documentation
1.72 -add_custom_target(docs-html
1.73 - COMMAND ${CMAKE_COMMAND} -E copy ucx.css ${PANDOC_DESTDIR}/ucx.css
1.74 - COMMAND ${CMAKE_COMMAND} -E copy ${LOGO_PATH} ${PANDOC_DESTDIR}/uaplogo.png
1.75 - DEPENDS ${PANDOC_DEST} docs-html-21
1.76 - WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
1.77 - COMMENT "Generating HTML documentation with pandoc."
1.78 -)
