sync-and-translate.yml

name: Sync and Translate Documentation

permissions:
  contents: write
  actions: write

on:
  schedule:
    - cron: '0 0 * * *'  # 每天 UTC 时间午夜运行一次
  workflow_dispatch:

jobs:
  sync-and-translate:
    runs-on: ubuntu-latest

    steps:
    - name: Checkout user's repo (translate branch)
      uses: actions/checkout@v2
      with:
        path: userrepo
        token: ${{ secrets.GITHUB_TOKEN }}
        repository: fan-ziqi/IsaacLab
        ref: translate

    - name: Copy po_translator.py to temporary path
      run: cp userrepo/po_translator.py /tmp/po_translator.py

    - name: Checkout user's repo (main branch)
      uses: actions/checkout@v2
      with:
        path: userrepo
        token: ${{ secrets.GITHUB_TOKEN }}
        repository: fan-ziqi/IsaacLab
        ref: main

    - name: Configure Git user
      working-directory: userrepo
      run: |
        git config --global user.name 'github-actions'
        git config --global user.email 'github-actions@github.com'

    - name: Add upstream repository and sync main
      working-directory: userrepo
      run: |
        git remote add upstream https://github.com/isaac-sim/IsaacLab.git
        git fetch upstream
        git checkout main
        git merge upstream/main -X theirs --allow-unrelated-histories

    - name: Ignore workflow changes
      working-directory: userrepo
      run: |
        git update-index --assume-unchanged .github/workflows/*

    - name: Push changes to user's repo
      working-directory: userrepo
      run: git push origin main

    - name: Checkout code from isaac-sim/IsaacLab
      uses: actions/checkout@v2
      with:
        repository: isaac-sim/IsaacLab
        ref: main
        path: isaaclab

    - name: Copy po_translator.py to docs folder
      run: cp /tmp/po_translator.py isaaclab/docs/

    - name: Check for changes
      id: changes-check
      run: |
        git fetch origin
        git diff --exit-code origin/main || echo "changes detected"
      working-directory: isaaclab
      continue-on-error: true

    - name: Exit if no changes
      if: steps.changes-check.outcome == 'success'
      run: echo "No changes detected, exiting."

    - name: Set up Python
      uses: actions/setup-python@v2
      with:
        python-version: '3.x'

    - name: Install dependencies
      run: |
        python -m pip install --upgrade pip
        pip install sphinx sphinx-intl

    - name: Generate gettext
      working-directory: isaaclab/docs
      run: make gettext

    - name: Update translations
      working-directory: isaaclab/docs
      run: sphinx-intl update -p _build/gettext -l zh_CN

    - name: Translate using custom script
      working-directory: isaaclab/docs
      run: python po_translator.py --folder ./locale --lang zh_CN --folder-language

    - name: Build HTML with translations
      working-directory: isaaclab/docs
      run: make -e SPHINXOPTS="-D language='zh_CN'" html

    - name: Copy generated files to user repo
      run: |
        mkdir -p userrepo/docs/zh_CN
        cp -r isaaclab/docs/_build/html/* userrepo/docs/zh_CN/

    - name: Commit and push changes
      working-directory: userrepo
      run: |
        git config --global user.name 'github-actions'
        git config --global user.email 'github-actions@github.com'
        git checkout -b gh-pages-zhcn
        git add docs/zh_CN
        git commit -m "Update translated documentation"
        git push origin gh-pages-zhcn --force