[skip changelog] Fix link checking task and workflow

Author: silvanocerza

.github/workflows/link-validation.yaml

@@ -21,5 +21,41 @@ jobs:
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
 
+      - name: Install Go
+        uses: actions/setup-go@v2
+        with:
+          go-version: "1.14"
+
+      - name: Installs Go dependencies
+        shell: bash
+        run: go get -u github.com/pseudomuto/protoc-gen-doc/cmd/protoc-gen-doc
+
+      - name: Install protoc compiler
+        uses: arduino/setup-protoc@v1.1.0
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Python
+        uses: actions/setup-python@v1
+        with:
+          python-version: "3.6"
+          architecture: "x64"
+
+      - name: Cache dependencies
+        uses: actions/cache@v1
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+
+      - name: Install Python dependencies
+        run: |
+          python3 -m pip install --upgrade pip
+          python3 -m pip install -r ./requirements_docs.txt
+
+      - name: Build docs
+        run: task docs:build
+
       - name: Verify links
         run: task docs:check-links

Taskfile.yml

@@ -56,9 +56,15 @@ tasks:
 
   docs:check-links:
     desc: Verifies there are no dead links in documentation
-    dir: docs
     cmds:
-      - npx -p markdown-link-check -c 'for file in **/*.md; do markdown-link-check -q "$file"; done'
+      - |
+        npx -p markdown-link-check -c '
+        STATUS=0
+        for file in $(find -name "*.md"); do
+          markdown-link-check -c markdown-link-check-config.json -q "$file"
+          STATUS=$(( $STATUS + $? ))
+        done
+        exit $STATUS'
 
   docs:format:
     desc: Automatically formats documentation

markdown-link-check-config.json

@@ -0,0 +1,10 @@
+{
+  "ignorePatterns": [
+    {
+      "pattern": "https?://localhost:\\d*/"
+    },
+    {
+      "pattern": "https?://(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?):\\d*"
+    }
+  ]
+}