Add Thrust Docs

.github/workflows/build-docs.yml

@@ -37,13 +37,23 @@ jobs:
           source: ./docs
           destination: ./_site
 
-      # Build libcudacxx docs
+      # Libcudacxx
       - name: Build libcudacxx docs
         uses: actions/jekyll-build-pages@v1
         with:
           source: ./libcudacxx/docs/jekyll
           destination: ./_site/libcudacxx
 
+      # Thrust
+      - name: Build Thrust markdown in Docker
+        run: ./thrust/docs/build_doxygen.bash
+
+      - name: Build thrust docs
+        uses: actions/jekyll-build-pages@v1
+        with:
+          source: ./thrust/build_docs
+          destination: ./_site/thrust
+
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v2
 

thrust/docs/Dockerfile

@@ -0,0 +1,18 @@
+FROM ubuntu:22.04
+
+SHELL [ "/usr/bin/env", "/bin/bash", "-c" ]
+
+ENV APT_KEY_DONT_WARN_ON_DANGEROUS_USAGE=1
+
+RUN apt-get -y -qq update; \
+    apt-get -y -qq upgrade; \
+    apt-get -y -qq install doxygen unzip wget
+
+RUN mkdir -p /opt/doxybook2; \
+    cd /opt/doxybook2; \
+    wget -q -O doxybook2.zip "https://github.com/matusnovak/doxybook2/releases/download/v1.5.0/doxybook2-linux-amd64-v1.5.0.zip"; \
+    unzip -xf doxybook2.zip
+
+ENV PATH "$PATH:/opt/doxybook2/bin"
+
+SHELL [ "/bin/bash" ]

thrust/docs/docker_build_docs.bash

@@ -0,0 +1,24 @@
+#!/usr/bin/env sh
+
+## This script will produce a 'build_docs' folder that contains a jekyll site containing all the Thrust docs
+## This is used in CI to produce a site for Thrust under CCCL
+
+set -ex
+
+SCRIPT_PATH=$(cd $(dirname ${0}); pwd -P)
+cd $SCRIPT_PATH
+
+mkdir -p build
+(
+    cd build
+    cp ../github_pages/Gemfile .
+    docker build -f ../Dockerfile -t thrust:docs .
+)
+
+cd $SCRIPT_PATH/..
+(
+    docker run -it --rm \
+        --mount type=bind,src=$(pwd),dst=/cccl \
+        thrust:docs \
+            bash -c "/cccl/docs/generate_markdown.bash"
+)

thrust/docs/github_pages/_config.yml

@@ -12,6 +12,8 @@ search.heading_level: 4
 
 incremental: true
 
+baseurl: "cccl/thrust"
+
 # just-the-docs ignores these filenames by default.
 include: [ "contributing.md", "code_of_conduct.md" ]