Skip to content

Improve the CI and the translation in readthedocs #841

Improve the CI and the translation in readthedocs

Improve the CI and the translation in readthedocs #841

Workflow file for this run

name: update-translations
on:
workflow_dispatch:
pull_request:
schedule:
- cron: "0 0 * * *" #runs at 00:00 UTC everyday
jobs:
update:
runs-on: ubuntu-latest
permissions:
contents: write # for git push; turn all other permissions 'read'
env:
SPHINXINTL_TRANSIFEX_ORGANIZATION_NAME: sphinx-doc
SPHINXINTL_TRANSIFEX_PROJECT_NAME: sphinx-doc
TX_TOKEN: ${{ secrets.TX_TOKEN }}
steps:
# 1. Set up environment
- uses: actions/checkout@v4
- name: Initialize and update submodule
run: |
git submodule init
git submodule update
- name: Setup Python
uses: actions/setup-python@v5
with:
python-version: 3.9
cache: 'pip'
- name: Set up git config
run: |
git config --global user.email "sphinx-auto-update"
git config --global user.name "sphinx-auto-update"
- name: Install graphviz
run: sudo apt-get install graphviz
- name: Install dependencies
run: |
pip install -U pip setuptools
pip install -r ./requirements.txt
- name: Install Transifex CLI
working-directory: /usr/local/bin
run: |
curl -o- https://raw.githubusercontent.com/transifex/cli/master/install.sh | bash
tx --version
# 2. Remove obsolete POT files from repository and obsolete resources from Transifex
- name: Generate templates from scratch
run: |
rm -rf ./locale/pot
./locale/generate_templates.sh
- name: Just print what would be locked and deleted of the resources in Transifex
if: github.event_name == 'pull_request'
run: locale/lock-translations.py locale/.tx/config -d
- name: Lock and delete obsolete resources in Transifex
if: github.event_name != 'pull_request'
run: locale/lock-translations.py locale/.tx/config
- name: Include obsolete POT for removal
run: |
obsolete_potfiles=$(git status -s | grep ^' D' | cut -d' ' -f3)
if [ -n "$obsolete_potfiles" ]; then git rm $obsolete_potfiles; fi
git checkout locale/
# 3. Update translation files
- name: Update translations
run: |
sh ./locale/generate_templates.sh
cat ./locale/.tx/config
sh ./locale/update.sh
# 4. Commit and push changes
- name: After success
run: |
git add locale
git add sphinx
git diff-index --cached --quiet HEAD || git commit -vm "Update translations by GHA https://github.com/${{ github.repository }}/actions/runs/${{ github.run_number }}"
- name: GitHub Push
if: github.event_name != 'pull_request'
run: git push