WIP: use jupytext into examples and documentation

.github/workflows/full_documentation.yml

@@ -10,19 +10,7 @@ env:
   MEILISEARCH_HOST_URL: https://backend.search.pyansys.com
   MEILISEARCH_PUBLIC_API_KEY: ${{ secrets.MEILISEARCH_PUBLIC_API_KEY }}
 # Controls when the workflow will run
-on:
-  # Triggers the workflow on push or pull request events but only for the main branch
-  push:
-    tags:
-     - v*
-  workflow_dispatch:
-    inputs:
-      logLevel:
-        description: 'Log level'
-        required: true
-        default: 'warning'
-      tags:
-        description: 'Test scenario tags'
+on: [pull_request, workflow_dispatch]
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
@@ -47,6 +35,17 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
 
+      # TODO: install pandoc on self hosted runners to remove this step
+      - name: Install Chocolatey and Pandoc if necessary
+        run: |
+          # Check if Chocolatey is installed
+          if ((Get-Command choco -ErrorAction SilentlyContinue) -eq $null) {
+              # Install Chocolatey
+              Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
+          }
+
+          C:\ProgramData\chocolatey\bin\choco install pandoc -y
+
       - name: 'Create virtual env'
         run: |
           python -m venv testenv
@@ -71,7 +70,9 @@ jobs:
       - name: Create HTML Documentations
         run: |
           testenv\Scripts\Activate.ps1
-          sphinx-build -j auto --color -b html -a doc/source doc/_build/html
+          cd doc
+          .\make.bat html
+          # sphinx-build -j auto --color -b html -a doc/source doc/_build/html
 
 #      - name: Create PDF Documentations
 #        run: |
@@ -85,12 +86,12 @@ jobs:
           path: doc/_build/html
           retention-days: 7
 
-      - name: Upload HTML documentation artifact
-        uses: actions/upload-artifact@v3
-        with:
-          name: documentation-html-edb
-          path: doc/_build/html/EDBAPI
-          retention-days: 7
+      # - name: Upload HTML documentation artifact
+      #   uses: actions/upload-artifact@v3
+      #   with:
+      #     name: documentation-html-edb
+      #     path: doc/_build/html/EDBAPI
+      #     retention-days: 7
 
 #      - name: Upload PDF documentation artifact
 #        uses: actions/upload-artifact@v3