diff --git a/.readthedocs.yml b/.readthedocs.yml index e90e042..0405f88 100644 --- a/.readthedocs.yml +++ b/.readthedocs.yml @@ -11,4 +11,6 @@ build: - cmake --workflow --preset documentation-workflow # Copy built documentation to Read the Docs output directory - mkdir -p $READTHEDOCS_OUTPUT/html - - cp -r build/* $READTHEDOCS_OUTPUT/html/ + - cp -r build/html/* $READTHEDOCS_OUTPUT/html/ + - cp -r build/markdown/* $READTHEDOCS_OUTPUT/html/ + - cp build/singlemarkdown/index.md $READTHEDOCS_OUTPUT/html/llms-full.txt diff --git a/docs/CMakeLists.txt b/docs/CMakeLists.txt index 88bf839..4a9ad75 100644 --- a/docs/CMakeLists.txt +++ b/docs/CMakeLists.txt @@ -7,18 +7,22 @@ set(SPHINX_BUILD ${CMAKE_BINARY_DIR}) # Build HTML documentation add_custom_target(html - COMMAND ${SPHINX_EXECUTABLE} -b html ${SPHINX_SOURCE} ${SPHINX_BUILD} - COMMENT "Building HTML documentation" + COMMAND ${SPHINX_EXECUTABLE} -b html ${SPHINX_SOURCE} ${SPHINX_BUILD}/html VERBATIM ) # Build markdown documentation add_custom_target(markdown - COMMAND ${SPHINX_EXECUTABLE} -b markdown ${SPHINX_SOURCE} ${SPHINX_BUILD} - COMMENT "Building Markdown documentation" + COMMAND ${SPHINX_EXECUTABLE} -b markdown ${SPHINX_SOURCE} ${SPHINX_BUILD}/markdown VERBATIM ) -# Build both formats +# Build singlemarkdown documentation and rename to llms-full.txt +add_custom_target(singlemarkdown + COMMAND ${SPHINX_EXECUTABLE} -b singlemarkdown ${SPHINX_SOURCE} ${SPHINX_BUILD}/singlemarkdown + VERBATIM +) + +# Build all formats add_custom_target(docs ALL) -add_dependencies(docs html markdown) +add_dependencies(docs html markdown singlemarkdown) diff --git a/docs/requirements.txt b/docs/requirements.txt index 98f1a95..f1db9f5 100644 --- a/docs/requirements.txt +++ b/docs/requirements.txt @@ -4,4 +4,4 @@ sphinx-contributors sphinx sphinx-llms-txt sphinxext-opengraph -sphinx-markdown-builder +sphinx-markdown-builder @ git+https://github.com/akaihola/sphinx-markdown-builder.git@singlemarkdown