name: i18n consistency check

# 防止主页或某章 README 改动后，其它语言版本跟不上而漂移。
# 详见 scripts/check_i18n_consistency.py。
#
# 触发时机：
#   1. 任何 PR / push 改动了 README、chapterN/、docs/<locale>/ 等 i18n 相关文件
#   2. 手动 workflow_dispatch

on:
  pull_request:
    paths:
      - "README.md"
      - "README.he.md"
      - "index*.md"
      - "docs/**"
      - "chapter*/README*.md"
      - "book*/**"
      - "mkdocs.yml"
      - "extras/site-nav-i18n.json"
      - "extras/lang-switcher.js"
      - "extras/nav-collapse.js"
      - "scripts/check_i18n_consistency.py"
      - "scripts/site_i18n.py"
      - ".github/workflows/i18n-check.yml"
  push:
    branches: [main]
    paths:
      - "README.md"
      - "README.he.md"
      - "index*.md"
      - "docs/**"
      - "chapter*/README*.md"
      - "book*/**"
      - "mkdocs.yml"
      - "extras/site-nav-i18n.json"
      - "extras/lang-switcher.js"
      - "extras/nav-collapse.js"
      - "scripts/check_i18n_consistency.py"
      - "scripts/site_i18n.py"
      - ".github/workflows/i18n-check.yml"
  workflow_dispatch: {}

permissions:
  contents: read

jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5

      - uses: actions/setup-python@v5
        with:
          python-version: "3.12"

      - name: Install static-site i18n dependency
        run: pip install "mkdocs-material>=9.5,<10"

      - name: Check static-site navigation and UI translations
        run: python scripts/site_i18n.py

      - name: Run i18n consistency check
        run: python scripts/check_i18n_consistency.py