[doc] Embed CI graph generation in docs build (learning-process#832)

Author: aobolensk

.github/workflows/pages.yml

@@ -44,15 +44,11 @@ jobs:
       - name: Install dependencies
         run: |
           python3 -m pip install -r docs/requirements.txt
-          python3 -m pip install graphviz pyyaml
       - name: Download artifact
         uses: actions/download-artifact@v8
         with:
           name: doxygen-documentation-xml
           path: xml
-      - name: Generate CI jobs graph
-        run: |
-          python3 scripts/jobs_graph.py --out docs/_static/ci_graph --format svg
       - name: Configure project
         run: >
           cmake -S . -B build -D USE_DOCS=ON -D PPC_BUILD_COMPONENTS=OFF

docs/CMakeLists.txt

@@ -5,9 +5,22 @@ endif()
 set(SOURCEDIR "${CMAKE_CURRENT_SOURCE_DIR}")
 set(BUILDDIR "${CMAKE_CURRENT_BINARY_DIR}/_build/html")
 set(GETTEXTDIR "${CMAKE_CURRENT_BINARY_DIR}/_build/gettext")
+set(CI_GRAPH_SOURCE "${CMAKE_SOURCE_DIR}/.github/workflows/main.yml")
+set(CI_GRAPH_OUTPUT "${SOURCEDIR}/_static/ci_graph.svg")
 
 find_package(Python REQUIRED COMPONENTS Interpreter)
 
+add_custom_command(
+  OUTPUT "${CI_GRAPH_OUTPUT}"
+  COMMAND
+    ${Python_EXECUTABLE} "${CMAKE_SOURCE_DIR}/scripts/jobs_graph.py" --workflow
+    "${CI_GRAPH_SOURCE}" --out "${SOURCEDIR}/_static/ci_graph" --format svg
+  DEPENDS "${CMAKE_SOURCE_DIR}/scripts/jobs_graph.py" "${CI_GRAPH_SOURCE}"
+  WORKING_DIRECTORY "${CMAKE_SOURCE_DIR}"
+  COMMENT "Generating CI jobs graph")
+
+add_custom_target(docs_ci_graph DEPENDS "${CI_GRAPH_OUTPUT}")
+
 add_custom_target(
   docs_help
   COMMAND ${SPHINXBUILD} -M help "${SOURCEDIR}" "${BUILDDIR}/en" ${SPHINXOPTS}
@@ -52,3 +65,4 @@ add_custom_target(
           ${SPHINXOPTS}
   WORKING_DIRECTORY "${SOURCEDIR}"
   COMMENT "Building HTML documentation for English and Russian")
+add_dependencies(docs_html docs_ci_graph)

docs/requirements.txt

@@ -2,3 +2,4 @@ Sphinx==9.1.0
 sphinx-rtd-theme==3.1.0
 sphinx-intl==2.3.2
 breathe==4.36.0
+PyYAML==6.0.3