validate-translation git:20260205.f942333A

Immutable. This exact content never changes and is served at /api/v1/blob/275957acd46db55c.

---
name: validate-translation
description: Reviews translated PO entries for quality, checking terminology, punctuation, reST syntax, and line length. Use to validate existing translations.
argument-hint: <path-to-po-file>
---

# review-translation

Validate translated PO entries against project rules and report issues.

## What to Check

### 1. Terminology Consistency
- Compare terms against `glossary.po` and terminology dictionary
- Flag zh_CN terms that should be zh_TW (see `references/validation-rules.md`)
- Check for inconsistent translations of the same term

### 2. Punctuation Rules
- Chinese text must use full-width: `「」（）、，。：；！？`
- English text must use half-width: `(),.;:!?`
- Brackets: Full-width if content has Chinese, half-width if English-only

### 3. CJK-Latin Spacing
- Space required between Chinese and Latin characters
- No space between Latin and Chinese punctuation/symbols

### 4. reST Syntax Preservation
- All `:role:` syntax must be intact
- Link URLs must be unchanged
- `::` markers must be preserved
- Check for missing `\\ ` escapes before roles

### 5. Line Length
- Maximum 79 characters per line
- Multi-line format for longer content

## Review Process

1. **Parse PO file** - Extract msgid/msgstr pairs
2. **Check each entry** - Apply all validation rules
3. **Categorize issues** - ERROR (must fix), WARNING (should fix), INFO
4. **Generate report** - List issues with line numbers and suggestions

## Issue Severity

| Severity | Description | Examples |
|----------|-------------|----------|
| ERROR | Must fix before merge | Broken reST, missing translation |
| WARNING | Should fix | Wrong terminology, spacing issues |
| INFO | Optional improvement | Inefficient line wrapping |

## Quick Validation Commands

After review, run: `make lint`, `make wrap`, `make build <file>.po`

## References

- `references/validation-rules.md` - Complete validation checklist