Merge branch 'master' into updateDocsDeegree360pre2-407

Author: julianzz98

.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+- package-ecosystem: "github-actions"
+  directory: "/"
+  schedule:
+      interval: "weekly"

.github/scripts/update_locale.sh

@@ -0,0 +1,40 @@
+#!/bin/bash
+# ------------------------------------------------------------------------------
+# pgRouting Scripts
+# Copyright(c) pgRouting Contributors
+#
+# Update the locale files
+# ------------------------------------------------------------------------------
+
+
+
+DIR=$(git rev-parse --show-toplevel)
+
+pushd "${DIR}" > /dev/null || exit 1
+
+pushd build > /dev/null || exit 1
+cmake -DLOCALE=ON ..
+
+make locale
+popd > /dev/null || exit 1
+
+# List all the files that needs to be committed in build/doc/locale_changes.txt
+awk '/^Update|^Create/{print $2}' build/doc/locale_changes.txt > build/doc/locale_changes_po.txt # .po files
+cp build/doc/locale_changes_po.txt build/doc/locale_changes_po_pot.txt
+perl -pe 's/(.*)en\/LC_MESSAGES(.*)/$1pot$2t/' < build/doc/locale_changes_po.txt >> build/doc/locale_changes_po_pot.txt  # .pot files
+
+# List all the files that needs to be committed in build/presentation/locale_changes.txt
+awk '/^Update|^Create/{print $2}' build/presentation/locale_changes.txt > build/presentation/locale_changes_po.txt # .po files
+cp build/presentation/locale_changes_po.txt build/presentation/locale_changes_po_pot.txt
+perl -pe 's/(.*)en\/LC_MESSAGES(.*)/$1pot$2t/' < build/presentation/locale_changes_po.txt >> build/presentation/locale_changes_po_pot.txt  # .pot files
+
+# Remove obsolete entries #~ from .po files
+bash scripts/remove_obsolete_entries.sh
+
+# Remove duplicate string locations
+perl -i -ne 'print unless (defined($prev) && ($_ eq $prev)); $prev=$_' locale/pot/*.pot
+
+while read -r f; do git add "$f"; done < build/doc/locale_changes_po_pot.txt
+while read -r f; do git add "$f"; done < build/presentation/locale_changes_po_pot.txt
+
+popd > /dev/null || exit 1

.github/workflows/deploy-pages.yml

@@ -13,19 +13,19 @@ on:
 
 jobs:
   deploy:
-    runs-on: ubuntu-18.04
+    runs-on: ubuntu-22.04
     if: ${{ github.repository_owner == 'OSGeo' }}
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
 
       - name: Install apt packages
         run: |
           sudo apt-get install cmake cpanminus
           sudo cpanm Text::SimpleTable::AutoWidth
 
       - name: Setup Python
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v5
         with:
           python-version: '3.x'
 
@@ -44,23 +44,9 @@ jobs:
           mkdir -p build
           bash ci/build-pages.sh
 
-      - name: Update locale
-        if: github.ref == 'refs/heads/master'
-        run: |
-          mkdir -p build
-          bash tools/transifex/update_locale.sh
-
-          # Add the files, commit and push
-          for line in `cat build/doc/locale_changes_po_pot.txt`; do git add "$line"; done
-          git diff --staged --quiet || git commit -m "Update locale: commit ${{ env.GIT_HASH }}"
-          git fetch origin master
-          git restore .  # Remove the unstaged changes before rebasing
-          git rebase origin/master
-          git push origin master
-
       - name: Deploy pages
         if: github.ref == 'refs/heads/master'
-        uses: peaceiris/actions-gh-pages@v3
+        uses: peaceiris/actions-gh-pages@v4
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           publish_dir: build/_build/html

.github/workflows/linkcheck.yml

@@ -1,7 +1,32 @@
-name: Check Documentation Links 
+name: Check Documentation Links
 
-on: [push,pull_request]
+on:
+  push:
+    paths:
+      - '.github/workflows/linkcheck.yml'
+      - 'doc/**'
+      - 'locale/**'
+      - 'CMakeLists.txt'
 
+    branches-ignore:
+      - 'gh-pages'
+
+  pull_request:
+    paths:
+      - '.github/workflows/doc-check.yml'
+      - 'doc/**'
+      - 'locale/**'
+      - 'CMakeLists.txt'
+
+    branches-ignore:
+      - 'gh-pages'
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
 
 
 jobs:
@@ -12,50 +37,57 @@ jobs:
     strategy:
         fail-fast: false
         matrix:
-          language: [de,en,es,fi,fr,hu,ja,it]
+          language: [de,en,es,fi,fr,hu,ja,it,nl,pt,sv,tr,zh_Hans]
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
         with:
           fetch-depth: 2
 
-      - name: get commit message
+      - name: check modified files
+        id: check_files
         run: |
-           PROCESS=${{ false }}
-           if [[ $(git log --format=%B -n 2 | tr -d "'" | tr -d " " | grep "\[${{ matrix.language }}\]") ]]; then
-             PROCESS=${{ true }}
-           fi
-           if [[ "${{ matrix.language }}" == "en" ]]; then
-             PROCESS=${{ true }}
-           fi
-           echo "PROCESS=${PROCESS}" >> $GITHUB_ENV
-           
+          # allways processing english, no matter what the change was
+          if [[ "${{ matrix.language }}" == "en" ]]; then echo "PROCESS=true" >> $GITHUB_ENV; fi
+
+          # if there is a change on the translation
+          if git diff --name-only HEAD^ HEAD | grep -q "^locale/${{ matrix.language }}" ; then echo "PROCESS=true" >> $GITHUB_ENV; fi
+          # if the change involves a link
+          if git diff HEAD^ "locale/${{ matrix.language }}" | grep "http" | grep -q "+" ; then echo "CHK_LINK=true" >> $GITHUB_ENV; fi
+
       - name: Install python
-        if: env.PROCESS == 'true'
-        uses: actions/setup-python@v2
+        if: env.PROCESS == 'true' || env.CHK_LINK == 'true'
+        uses: actions/setup-python@v5
         with:
           python-version: '3.x'
 
 
       - name: Install dependencies
-        if: env.PROCESS == 'true'
+        if: env.PROCESS == 'true' || env.CHK_LINK == 'true'
         run: |
           sudo apt-get update
           sudo apt-get install -y \
-            graphviz
-          python -m pip install --upgrade pip
+            graphviz cmake cpanminus
+          sudo cpanm Text::SimpleTable::AutoWidth
           pip install -r requirements.txt
           pip list
 
       - name: Configure link checks
-        if: env.PROCESS == 'true'
+        if: env.PROCESS == 'true' || env.CHK_LINK == 'true'
         run: |
           mkdir build
           cd build
-          cmake -DLINKCHECK=ON -DDE=ON -DES=ON -DFI=ON -DFR=ON -DHU=ON -DJA=ON -DIT=ON ..
+          cmake -DHTML=ON -DLINKCHECK=ON -DDE=ON -DES=ON -DFI=ON -DFR=ON -DHU=ON -DJA=ON -DIT=ON -DPT=ON -DSV=ON -DTR=ON -DNL=ON -DZH_HANS=ON ..
 
-      - name: Check Links languages
+      - name: test documentation
         if: env.PROCESS == 'true'
+        run: |
+          cd build
+          make html-${{ matrix.language }}
+          make presentation-html-${{ matrix.language }}
+
+      - name: Check Links languages
+        if: env.CHK_LINK == 'true'
         run: |
           cd build
           make linkcheck-${{ matrix.language }}

.github/workflows/locale-update.yml

@@ -0,0 +1,65 @@
+name: Update Locale
+
+# This action runs:
+# - When this file changes
+# - When changes on documentation (doc)
+# - When is triggered manually
+
+on:
+  workflow_dispatch:
+  push:
+
+permissions:
+  contents: read
+
+jobs:
+  update-locale:
+    permissions:
+      contents: write  # for Git to git push
+    name: Update Locale
+    runs-on: ubuntu-22.04
+
+    strategy:
+        fail-fast: false
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Install apt packages
+        run: |
+          sudo apt-get install cmake cpanminus
+          sudo cpanm Text::SimpleTable::AutoWidth
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -r ./requirements.txt
+
+      - name: Extract branch name and commit hash
+        run: |
+          branch=${GITHUB_REF#refs/heads/}
+          git_hash=$(git rev-parse --short "$GITHUB_SHA")
+          echo "GIT_HASH=$git_hash" >> $GITHUB_ENV
+
+      - name: Initialize mandatory git config
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+      - name: Update locale
+        run: |
+          mkdir build
+          bash .github/scripts/update_locale.sh
+
+          # Add the files, commit and push
+          git diff --staged --quiet || git commit -m "Locale update: for commit ${{ env.GIT_HASH }}"
+          git restore .  # Remove the unstaged changes before rebasing
+          git push