Initial version of sphinx documentation and...

- remove ubuntu 21.04 from CI (end of life)
- adjust matrix strategy for clang.yml
- Use lessons learned from RetroArcher on localize.yml, crowdin.yml, and locale.py
- Add end of life comments to Dockerfiles
- Adjust dependency order in Dockerfiles

.github/workflows/localize.yml

@@ -3,15 +3,16 @@ name: localize
 on:
   push:
     branches: [nightly]
-    paths:  # prevents workflow from running unless files in these directories change
-      - 'sunshine/**'  # only localizing files inside sunshine directory
+    paths:  # prevents workflow from running unless these files change
+      - 'sunshine/**'
+      - 'locale/sunshine.po'
   workflow_dispatch:
 
 jobs:
   localize:
     name: Update Localization
-    if: ${{ github.event.pull_request.merged }}
     runs-on: ubuntu-latest
+
     steps:
     - name: Checkout
       uses: actions/checkout@v3
@@ -37,9 +38,37 @@ jobs:
       run: |
         python ./scripts/_locale.py --extract
 
-    - name: GitHub Commit & Push  # push changes back into nightly
-      uses: actions-js/push@v1.3
+    - name: git diff
+      run: |
+        # print the git diff
+        git diff --exit-code locale/sunshine.po
+
+        # set the variable with minimal output
+        OUTPUT=$(git diff --exit-code --numstat locale/sunshine.po)
+        echo "git_diff=${OUTPUT}" >> $GITHUB_ENV
+
+    - name: git reset
+      if: ${{ env.git_diff != '1	1	locale/sunshine.po' }}  # only run if more than 1 line changed
+      run: |
+        git reset --hard
+
+    - name: Create/Update Pull Request
+      uses: peter-evans/create-pull-request@v4
       with:
-        github_token: ${{ secrets.GITHUB_TOKEN }}
-        branch: nightly
-        message: localization updated by localize workflow
+        add-paths: |
+          locale/*.po
+        token: ${{ secrets.GH_PAT }}  # must trigger PR tests
+        commit-message: New localization template
+        branch: localize/update
+        delete-branch: true
+        base: nightly
+        title: New Babel Updates
+        body: |
+          Update report
+          - Updated with *today's* date
+          - Auto-generated by [create-pull-request][1]
+
+          [1]: https://github.com/peter-evans/create-pull-request
+        labels: |
+          babel
+          l10n