chore(ci): Build docs

.github/workflows/build-test.yaml

@@ -23,6 +23,13 @@ jobs:
         with:
           name: conda_artifacts
           path: ${{ env.OUTPUT_DIR }}
+  docs-build:
+    if: github.ref_type == 'branch'
+    needs: conda
+    runs-on: ubuntu-latest
+    container: rapidsai/ci-conda:latest
+    steps:
+      - run: ./ci/build_docs.sh
   wheel:
     runs-on: ubuntu-latest
     container: python:3

ci/build_docs.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+# Copyright (c) 2023-2024, NVIDIA CORPORATION.
+
+set -euo pipefail
+
+rapids-logger "Create test conda environment"
+. /opt/conda/etc/profile.d/conda.sh
+
+ENV_YAML_DIR="$(mktemp -d)"
+
+rapids-dependency-file-generator \
+  --output conda \
+  --file_key docs | tee "${ENV_YAML_DIR}/env.yaml"
+
+rapids-mamba-retry env create --yes -n docs
+conda activate docs
+
+rapids-print-env
+
+rapids-logger "Downloading artifacts from previous jobs"
+PYTHON_CHANNEL=$(rapids-download-conda-from-s3 python)
+
+rapids-mamba-retry install \
+  --channel "${PYTHON_CHANNEL}" \
+  rapids-dependency-file-generator
+
+export RAPIDS_DOCS_DIR="$(mktemp -d)"
+
+rapids-logger "Build rapids-dependency-file-generator Sphinx docs"
+pushd docs
+make dirhtml
+mkdir -p "${RAPIDS_DOCS_DIR}/rapids-dependency-file-generator/html"
+mv build/dirhtml/* "${RAPIDS_DOCS_DIR}/rapids-dependency-file-generator/html"
+if [[ "${RAPIDS_BUILD_TYPE}" != "pull-request" ]]; then
+  make text
+  mkdir -p "${RAPIDS_DOCS_DIR}/rapids-dependency-file-generator/txt"
+  mv build/text/* "${RAPIDS_DOCS_DIR}/rapids-dependency-file-generator/txt"
+fi
+popd
+
+rapids-upload-docs

docs/source/conf.py

@@ -51,8 +51,6 @@
     "navbar_align": "right",
 }
 
-html_static_path = ["_static"]
-
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]