ci: auto deploy the GitHub pages/docs on releases

.github/workflows/ghpages.yml

@@ -0,0 +1,57 @@
+name: Deploy Docs to GitHub
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    runs-on: ubuntu-22.04
+    steps:
+    - name: 'Checkout'
+      uses: actions/checkout@v3
+      with:
+        fetch-depth: 0
+    - name: 'Get latest tag'
+      run: echo "GIT_LATEST_TAG=$(git tag | grep '^[0-9]\+\.[0-9]\+\?\.[0-9]\+\?$' | sort -V -r | head -n1)" >> $GITHUB_ENV
+
+    - name: 'Variables'
+      run: |
+        echo $GITHUB_REF_NAME
+        echo $GIT_LATEST_TAG
+
+    - name: 'Install prerequisites'
+      if: github.ref_name == env.GIT_LATEST_TAG
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y \
+          libdrm-dev \
+          doxygen \
+          meson \
+    - name: 'Build the Docs'
+      if: github.ref_name == env.GIT_LATEST_TAG
+      run: meson setup _build -D enable_docs=true && meson compile -C _build
+
+    - name: 'Upload the artifacts'
+      if: github.ref_name == env.GIT_LATEST_TAG
+      uses: actions/upload-pages-artifact@v1
+      with:
+        path: "_build/doc/html-out"
+
+    - name: 'Deploy to GitHub Pages'
+      if: github.ref_name == env.GIT_LATEST_TAG
+      id: deployment
+      uses: actions/deploy-pages@v1

doc/meson.build

@@ -13,6 +13,7 @@ libva_headers_doc = [
   'va_enc_hevc.h',
   'va_enc_vp8.h',
   'va_enc_vp9.h',
+  'va_enc_av1.h',
   'va_fei.h',
   'va_fei_h264.h',
   'va_fei_hevc.h',
@@ -33,7 +34,7 @@ foreach h : libva_headers_doc
 endforeach
 
 config = configuration_data()
-config.set('PACKAGE_VERSION', meson.project_version())
+config.set('PACKAGE_VERSION', libva_version)
 config.set('VA_HEADER_DIR', headerdir)
 config.set('VA_HEADER_FILES', headers)
 config.set('VA_HTML_FOOTER', footer)