docs: experimenting with multi-language Sphinx

.github/workflows/crowdin.yml

@@ -0,0 +1,29 @@
+name: Crowdin Action
+
+on:
+  push:
+    push:
+      paths-ignore:
+        - 'docs/**'
+
+jobs:
+  synchronize-with-crowdin:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v2
+    - name: Sync with Crowdin
+      uses: crowdin/github-action@1.4.5
+      with:
+        project_id: ${{ secrets.CROWDIN_PROJECT_ID }}
+        token: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}
+        download_translations: true
+        source: 'docs/locales/en_US/LC_MESSAGES/*.po'
+        translation: 'docs/locales/%locale_with_underscore%/LC_MESSAGES/%original_file_name%'
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        CROWDIN_PROJECT_ID: ${{ secrets.CROWDIN_PROJECT_ID }}
+        CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}

docs/conf.py

@@ -297,3 +297,10 @@ def setup(sphinx):
 
 # If true, do not generate a @detailmenu in the "Top" node's menu.
 #texinfo_no_detailmenu = False
+
+# -- Options for gettext builder ------------------------------------------
+
+# Generates uuid information for version tracking in message catalogs.
+gettext_uuid = True
+
+gettext_compact = False