GitHub Action
Ninja i18n
Automate your i18n workflow and ensure that your i18n files are always up to date with the latest changes in your source code.
Ninja-showcase.mp4
- When a pull request is opened or updated, the action will run and check for new i18n issues.
- If issues are found, the action creates a comment on the pull request with an issues report including links to the Fink localization editor to resolve the issues.
- After the issues are resolved, the action will automatically update the pull request comment to reflect the changes.
- If no issues are found, the action will simply not create any comments.
- Automated i18n linting for pull requests
- Detection of new broken inlang projects
- Comment creation with issue report
- Link creation to fix issues directly in Fink localization editor
Add the following workflow file to the main
branch of your repository in this path .github/workflows/ninja_i18n.yml
name: Ninja i18n action
on: pull_request_target
# explicitly configure permissions, in case your GITHUB_TOKEN workflow permissions are set to read-only in repository settings
permissions:
pull-requests: write # Necessary to comment on PRs
issues: read # Necessary to read issue comments
contents: read # Necessary to access the repo content
jobs:
ninja-i18n:
name: Ninja i18n - GitHub Lint Action
runs-on: ubuntu-latest
steps:
- name: Run Ninja i18n
# @main ensures that the latest version of the action is used
uses: opral/ninja-i18n-action@main
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
Note: Commit the workflow file to the main
branch of your repository before testing.
Create a pull request with changes to your i18n files and see if the action runs and creates a comment with the issues report:
- Create a new
test-ninja
branch in your repository - Open the
test-ninja
branch in Fink localization editor and delete a translation for testing purposes - Commit and push the change
- Create a pull request from the
test-ninja
branch tomain
- Check if the action runs and creates a comment with the issues report
Click here to watch a video showing the below steps in GitHub
Name | Requirement | Description |
---|---|---|
GITHUB_TOKEN |
required | Usage: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} , Ninja i18n action uses this in-built GitHub token to make the API calls for interacting with GitHub. It is built into Github Actions and does not need to be manually specified in your secrets store. More Info |
Please make sure that:
-
you have set up an inlang project with lint rules in your repository
-
you have activated actions for your repository:
- On GitHub.com, navigate to the main page of the repository
- Click Actions tab
- Click the button Enable Actions on this repository
-
actions and workflows are allowed in your repository:
- On GitHub.com, navigate to the main page of the repository
- Click Settings tab
- Click Actions in the left sidebar, then click General
- Select the desired option (e.g. Allow all actions and workflows) under Actions permissions
- Click Save to apply the settings
-
if the action never reports, please make sure that the pathPattern of your plugin in the project settings is a relative path (starting with "./")