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/CI.yml

@@ -150,7 +150,7 @@ jobs:
     strategy:
       fail-fast: true  # false to test all, true to fail entire job if any fail
       matrix:
-        distro: [ debian, ubuntu_18_04, ubuntu_20_04, ubuntu_21_04, ubuntu_21_10 ]
+        distro: [ debian, ubuntu_18_04, ubuntu_20_04, ubuntu_21_10 ]
         package: [ -p ]
         extension: [ deb ]
         include:  # package these differently

.github/workflows/clang.yml

@@ -9,10 +9,6 @@ jobs:
   lint:
     name: Clang Format Lint
     runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false  # false to test all, true to fail entire job if any fail
-      matrix:
-        inplace: [ true, false ]  # removed ubuntu_18_04 for now
 
     steps:
     - name: Checkout
@@ -25,10 +21,10 @@ jobs:
         extensions: 'cpp,h,m,mm'
         clangFormatVersion: 13
         style: file
-        inplace: ${{ matrix.inplace }}
+        inplace: false
 
     - name: Upload Artifacts
-      if: ${{ matrix.inplace == true }}
+      if: failure()
       uses: actions/upload-artifact@v3
       with:
         name: sunshine

.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