validate-translation

Validate PO file translations for terminology, punctuation, and reST syntax.

282|224|Updated Jun 24, 2018
One-click install
npx skills add https://github.com/python/python-docs-zh-tw --skill validate-translation-python
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: validate-translation
Source: https://github.com/python/python-docs-zh-tw/tree/main/.claude/skills/validate-translation
Command: npx skills add https://github.com/python/python-docs-zh-tw --skill validate-translation-python

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill reviews translated PO entries for quality, enforcing terminology consistency, punctuation rules, CJK-Latin spacing, reST syntax preservation, and appropriate line lengths.

Core Features & Use Cases

  • Terminology & Glossary Validation: compares terms against glossary.po and terminology dictionaries to flag inconsistencies.
  • Punctuation & Spacing Enforcement: ensures correct full-width vs half-width punctuation and proper CJK-Latin spacing.
  • Syntax & Link Preservation: verifies reST roles, links, and code block markers remain intact during reviews.
  • Use Case: maintainers running QA on Python docs translations across zh_TW and zh_CN to ensure consistency before releases.

Quick Start

Use the validate-translation skill to review a PO file and produce a quality report.

Frequently Asked Questions about validate-translation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate terminology consistency in a translated PO file?▼

PO file validation checks translated msgstr entries against glossary.po and a terminology dictionary to flag inconsistent term usage, categorizing mismatches as ERROR or WARNING in the final report.

How do I enforce CJK and Latin spacing rules in software localization?▼

Enforcing CJK and Latin spacing in software localization requires parsing translated PO entries to verify proper full-width and half-width punctuation usage and correct character spacing between Latin and CJK text.

Does PO file validation check reST syntax preservation?▼

Yes, PO file validation checks reST syntax preservation by verifying that reST roles, hyperlinks, and code block markers remain intact in the translated msgstr entries during the quality review process.

Can I use translation validation for Python docs localization in zh_TW and zh_CN?▼

Yes, translation validation can be used for Python docs localization in zh_TW and zh_CN, allowing maintainers to run QA on multilingual PO files to ensure terminology and formatting consistency before releases.

What is the best way to generate a translation quality report for multilingual projects?▼

The best way to generate a translation quality report for multilingual projects is to parse PO files and apply defined validation rules that categorize terminology, spacing, and syntax issues as ERROR, WARNING, or INFO into a concise output report.

Why are my translated PO entries flagged for line length issues?▼

Translated PO entries are flagged for line length issues because the validation process checks the msgstr text against appropriate line length limits to ensure documentation formatting remains consistent and readable.