Switch to single translation file. (#8)

Includes an update to stub translations.

Author: kattni

.github/workflows/translate.yml

@@ -49,25 +49,63 @@ jobs:
           git config --local user.email "$(git log --pretty='%ae' -1)"
           git config --local user.name "brutusthebee[bot]"
 
-      - name: Regenerate PO files
-        run: |
-          tox -e docs-translate
+      # Temporary disabled until we're fully registered with Weblate.
+      # - name: Regenerate PO files
+      #   env:
+      #     DEEPL_API_KEY: ${{ secrets.DEEPL_API_KEY }}
+      #   run: |
+      #     tox -e docs-translate
 
-      - name: Update Needed?
-        id: updated
-        run: |
-          if [[ $(git status --porcelain) ]]; then
-            echo "updated=true" >> ${GITHUB_OUTPUT}
-          else
-            echo "updated=false" >> ${GITHUB_OUTPUT}
-          fi
-
-      - name: Commit updated translations
-        if: steps.updated.outputs.updated == 'true'
-        env:
-          GITHUB_TOKEN: ${{ github.token }}
-        run: |
-          # Commit the updated PO files.
-          git add docs/locales
-          git commit -m "Update translations to $(git rev-parse --short HEAD)."
-          git push origin
+      # - name: Configure Weblate
+      #   env:
+      #     WEBLATE_API_TOKEN: ${{ secrets.WEBLATE_API_TOKEN }}
+      #   run: |
+      #     cat <<EOF > ~/.weblate
+      #     [weblate]
+      #     url = https://hosted.weblate.org/api/
+      #     key = $WEBLATE_API_TOKEN
+      #     translation = beeware/tutorial
+      #     EOF
+
+      # - name: Lock Weblate and Sync
+      #   run: wlc lock
+      # - name: Commit Weblate changes
+      #   run: wlc commit
+      # - name: Push Weblate changes
+      #   run: wlc push
+      # - name: Pull translation updates pushed by Weblate
+      #   run: git pull origin
+
+      # - name: Update Needed?
+      #   id: updated
+      #   run: |
+      #     if [[ $(git status --porcelain) ]]; then
+      #       echo "updated=true" >> ${GITHUB_OUTPUT}
+      #     else
+      #       echo "updated=false" >> ${GITHUB_OUTPUT}
+      #     fi
+
+      # - name: Commit updated translations
+      #   if: steps.updated.outputs.updated == 'true'
+      #   env:
+      #     GITHUB_TOKEN: ${{ github.token }}
+      #   run: |
+      #     # Commit the updated PO files.
+      #     git add docs/locales
+      #     git commit -m "Update translations to $(git rev-parse --short HEAD)."
+      #     git push origin
+
+      # - name: Ensure Weblate has current updates
+      #   if: steps.updated.outputs.updated == 'true'
+      #   run: wlc pull
+
+      # - name: Unlock Weblate
+      #   run: wlc unlock
+
+      # # This step is only needed if you're trying to diagnose test failures that
+      # # only occur in CI, and can't be reproduced locally. When it runs, it will
+      # # open an SSH server (URL reported in the logs) so you can ssh into the CI
+      # # machine.
+      # - name: Setup tmate session
+      #   uses: mxschmitt/action-tmate@v3
+      #   if: failure()

docs/en/SUMMARY.md

@@ -3,8 +3,8 @@
 - [Tutorial 2 - Making it interesting](tutorial/tutorial-2.md)
 - [Tutorial 3 - Packaging for distribution](tutorial/tutorial-3.md)
 - [Tutorial 4 - Updating your application](tutorial/tutorial-4.md)
-- Tutorial 5 - Taking it Mobile
-    - [Tutorial 5 - Taking it Mobile](tutorial/tutorial-5/index.md)
+- Tutorial 5 - Taking it mobile
+    - [Tutorial 5 - Taking it mobile](tutorial/tutorial-5/index.md)
     - [Tutorial 5 - Taking it mobile: Android](tutorial/tutorial-5/android.md)
     - [Tutorial 5 - Taking it mobile: iOS](tutorial/tutorial-5/iOS.md)
 - [Tutorial 6 - Put it on the web!](tutorial/tutorial-6.md)
@@ -15,4 +15,6 @@
     - [Customizing icons](tutorial/topics/custom-icons.md)
     - [Using the camera](tutorial/topics/camera-access.md)
     - [Testing times](tutorial/topics/testing.md)
-- [Contributing to this tutorial](how-to/index.md)
+- How-to guides
+    - [Contributing to this tutorial](how-to/contribute.md)
+    - [Style guide](how-to/style-guide.md)

docs/en/how-to/index.md docs/en/how-to/contribute.mddocs/en/how-to/index.md renamed to docs/en/how-to/contribute.md

@@ -0,0 +1 @@
+-8<- "style_guide.md"