fix: fix docs CI workflow; build in MRs; build and deploy on master (#…

…2504)

* fix: fix docs CI workflow; build in MRs; build and deploy on master

* fix: set link checker to warn, not error, for site in docs/

.github/workflows/docs.yml

@@ -1,18 +1,35 @@
 name: Build and deploy GH Pages
+
 on:
   push:
     branches:
       - master
+  pull_request:
+    branches:
+      - master
 
 jobs:
   build:
     runs-on: ubuntu-latest
+    if: github.ref != 'refs/heads/master'
+    steps:
+      - name: checkout
+        uses: actions/checkout@v4
+      - name: build
+        uses: shalzz/zola-deploy-action@v0.18.0
+        env:
+          BUILD_DIR: docs/
+          BUILD_ONLY: true
+
+  build_and_deploy:
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/master'
     steps:
       - name: checkout
-        uses: actions/checkout@v3.0.0
+        uses: actions/checkout@v4
       - name: build_and_deploy
-        uses: shalzz/zola-deploy-action@v0.17.2
+        uses: shalzz/zola-deploy-action@v0.18.0
         env:
           PAGES_BRANCH: gh-pages
           BUILD_DIR: docs/
-          TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

docs/config.toml

@@ -17,6 +17,8 @@ highlight_theme = "kronuz"
 #  { theme = "base16-ocean-light", filename = "syntax-theme-light.css" },
 #]
 
+[link_checker]
+internal_level = "warn"
 
 [extra]
 author = "Vincent Prouillet"