Workflow file for this run
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| name: Rebuild English User Documentation for Translation | |
| on: | |
| push: | |
| branches: | |
| - beta | |
| - xliffWithDeployKey | |
| paths: | |
| - 'user_docs/en/*.md' | |
| jobs: | |
| rebuild-translation-source: | |
| runs-on: windows-latest | |
| steps: | |
| - name: Checkout repository | |
| uses: actions/checkout@v3 | |
| with: | |
| fetch-depth: 0 | |
| - name: Set up Python | |
| uses: actions/setup-python@v4 | |
| with: | |
| python-version: '3.11' | |
| - name: Install dependencies | |
| run: | | |
| python -m pip install --upgrade pip | |
| pip install lxml requests | |
| - name: update xliff files | |
| shell: pwsh | |
| run: | | |
| # for any English markdown files changed within the commits of this push, | |
| # update the corresponding xliff file (if one exists) to reflect the current markdown file, | |
| # keeping existing translation IDs in tact. | |
| $ErrorActionPreference = 'Stop' | |
| $changedFiles = git diff --name-only ${{github.event.before}}.. -- user_docs/en/*.md | |
| foreach ($file in $changedFiles) { | |
| Write-Host "$file has changed" | |
| $baseName = [System.IO.Path]::GetFileNameWithoutExtension($file) | |
| $xliff = "user_docs/en/$baseName.xliff" | |
| $tempXliff = "user_docs/en/$baseName.xliff.temp" | |
| $markdown = $file | |
| if (Test-Path $xliff) { | |
| Write-Host "Updating $xliff with changes from $markdown" | |
| python user_docs/markdownTranslate.py updateXliff -x $xliff -m $file -o $tempXliff | |
| Write-Host "Renaming $tempXliff to $xliff" | |
| move-item -Path $tempXliff -Destination $xliff -Force | |
| } else { | |
| Write-Host "Ignoring $markdown as it does not have a corresponding xliff file" | |
| } | |
| } | |
| if: success() | |
| - name: Commit and Push changes | |
| env: | |
| GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} | |
| run: | | |
| $ErrorActionPreference = 'Stop' | |
| git config --local user.name "GitHub Actions" | |
| git config --local user.email "[email protected]" | |
| $filesChanged = git diff --name-only -- *.xliff | |
| if ($filesChanged) { | |
| Write-Host "xliff files were changed. Committing and pushing changes." | |
| foreach ($file in $filesChanged) { | |
| git add $file | |
| Write-Host "Committing $file" | |
| git commit -m "Update $file" | |
| } | |
| Write-Host "Setting up ssh for push" | |
| # Ensure .ssh directory exists | |
| mkdir -p ~/.ssh | |
| # Add github.com to the list of known hosts for ssh | |
| ssh-keyscan github.com >> ~/.ssh/known_hosts | |
| # set the private key of the Github deploy key as the ssh key | |
| echo ${{ secrets.XLIFF_DEPLOY_PRIVATE_KEY}} >~.ssh/id_rsa | |
| # Tell git to use ssh for pushing | |
| git remote set-url origin [email protected]:${{ github.repository }} | |
| Write-Host "Pushing changes" | |
| git push origin HEAD | |
| } else { | |
| Write-Host "No xliff files were changed. Skipping commit and push." | |
| } | |
| if: success() | |
| - name: Crowdin upload | |
| # This step must only be run after successfully pushing changes to the repository. | |
| # Otherwise if the push fails, subsequent runs may cause new translation IDs to be created, | |
| # which will cause needless retranslation of existing strings. | |
| env: | |
| crowdinProjectID: ${{ vars.CROWDIN_PROJECT_ID }} | |
| crowdinAuthToken: ${{ secrets.CROWDIN_AUTH_TOKEN }} | |
| run: | | |
| # Check if we changed userGuide.xliff in this action. | |
| # If we did, upload it to Crowdin. | |
| $ErrorActionPreference = 'Stop' | |
| $changed = git diff --name-only ${{GITHUB.SHA}}.. -- user_docs/en/userGuide.xliff | |
| if ($changed) { | |
| Write-Host "Uploading userGuide.xliff to Crowdin" | |
| # 18 is the file ID for userGuide.xliff in Crowdin. | |
| python appVeyor/crowdinSync.py uploadSourceFile 18 user_docs/en/userguide.xliff | |
| } else { | |
| Write-Host "Not uploading userGuide.xliff to Crowdin as it has not changed" | |
| } |