Add action to build dpctl using oneAPI and generate docs

Author: oleksandr-pavlyk

.github/workflows/generate-docs.yml

@@ -0,0 +1,71 @@
+name: Generate documentation
+on:
+  push:
+    branches:
+      - master
+      - doc-deployment-action
+
+jobs:
+  build-and-deploy:
+    name: Build and Deploy Documentation
+    runs-on: ubuntu-20.04
+    steps:
+      - name: Cancel Previous Runs
+        uses: styfle/cancel-workflow-action@0.6.0
+        with:
+          access_token: ${{ github.token }}
+      - name: Add Intel repository
+        run: |
+          wget https://apt.repos.intel.com/intel-gpg-keys/GPG-PUB-KEY-INTEL-SW-PRODUCTS-2023.PUB
+          sudo apt-key add GPG-PUB-KEY-INTEL-SW-PRODUCTS-2023.PUB
+          rm GPG-PUB-KEY-INTEL-SW-PRODUCTS-2023.PUB
+          sudo add-apt-repository "deb https://apt.repos.intel.com/oneapi all main"
+          sudo apt-get update
+      - name: Install Intel OneAPI
+        run: |
+          sudo apt-get install intel-oneapi-dpcpp-cpp-compiler
+      - name: Install Level-Zero headers
+        run: |
+          sudo apt-get install -y gpg-agent wget
+          wget -qO - https://repositories.intel.com/graphics/intel-graphics.key |
+            sudo apt-key add -
+            sudo apt-add-repository \
+              'deb [arch=amd64] https://repositories.intel.com/graphics/ubuntu focal main'
+          sudo apt-get install level-zero level-zero-dev
+      - name: Install Lua
+        run: |
+          sudo apt-get install liblua5.2-dev
+      - name: Setup miniconda
+        uses: conda-incubator/setup-miniconda@v2
+        with:
+          activate-environment: dpctl
+          python-version: 3.7
+          auto-activate-base: false
+      - name: Conda info
+        shell: bash -l {0}
+        run: |
+          conda info
+          conda list
+      - name: Install sphinx dependencies
+        shell: bash -l {0}
+        run: |
+          conda install -y -c conda-forge numpy cython sphinx sphinx_rtd_theme
+          conda install -y -c conda-forge cmake=3.19 doxygen pydot setuptools make
+      - name: Checkout repo
+        uses: actions/checkout@v2
+      - name: Build dpctl & docs
+        shell: bash -l {0}
+        run: |
+          source /opt/intel/oneapi/setvars.sh
+          python setup.py develop
+          cd docs
+          mkdir -p build && cd build && rm -rf *
+          wget https://github.com/vovkos/doxyrest/releases/download/doxyrest-2.1.2/doxyrest-2.1.2-linux-amd64.tar.xz
+          tar xf doxyrest-2.1.2-linux-amd64.tar.xz
+          cmake .. -DDPCTL_ENABLE_DOXYREST=ON -DDoxyrest_DIR=`pwd`/doxyrest-2.1.2-linux-amd64
+          make Sphinx
+      - name: Deploy docs
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          # publish_dir: doc/_build/html/