| name | translate-po |
| description | Translates PO file entries from English to Traditional Chinese (zh_TW) following project conventions. Use when translating new PO files or untranslated entries. |
| argument-hint | <path-to-po-file> |
translate-po
Translate English PO msgid entries to Traditional Chinese msgstr following all project rules.
Prerequisites
- Read the full msgid before translating
- Check msgctxt and translator comments for context
- Look up terminology in
references/terminology.md
- Check
references/forbidden-terms.md for zh_CN terms to avoid
Translation Process
Step 1: Content Analysis
Identify content type:
- Pure prose: Translate normally
- Code-only: Preserve exactly (no translation)
- Mixed: Translate prose, preserve code/roles
- reST structural: Preserve directives, translate display text
Step 2: Apply Rules
Punctuation:
- Chinese text: Full-width
「」（）、，。：；！？
- English text: Half-width
(),.;:!?
CJK-Latin Spacing:
- Add space between Chinese and Latin: "使用 CPU 運算" (correct)
- No space with symbols: "使用「CPU」運算" (correct)
Line Width: Max 79 characters (use multi-line format for longer text)
Step 3: reST Handling
See references/rst-cheatsheet.md for complete rules.
Key patterns:
:mod:os`` -> Keep unchanged:term:iterator -> `:term:`疊代器 <iterator>- Chinese before role: "參閱\ :mod:
os"
- After
:: markers: "範例： ::"
Step 4: Terminology Workflow
- Check term in
references/terminology.md
- If not found, check
glossary.po in project root
- If uncertain, add
#, fuzzy flag
- Never use zh_CN terms from
references/forbidden-terms.md
Output Format
msgid "Original English text"
msgstr "翻譯後的中文內容"
For uncertain translations, add #, fuzzy flag before the entry.
Quality Checklist
Before outputting, verify:
Examples
Simple Prose
msgid "Python is a programming language."
msgstr "Python 是一種程式語言。"
With Terminology
msgid "This function returns an iterator."
msgstr "此函式回傳一個疊代器。"
With reST Role
msgid "See :func:`len` for details."
msgstr "詳情請參閱\\ :func:`len`。"
With Link
msgid "Visit the `Python website <https://python.org>`_."
msgstr "請造訪 `Python 網站 <https://python.org>`_。"
With Term Reference
msgid "Returns a :term:`context manager`."
msgstr "回傳一個\\ :term:`情境管理器 <context manager>`。"
Mixed Content
msgid "The :class:`list` type is a :term:`mutable` sequence."
msgstr ":class:`list` 型別是一個\\ :term:`可變物件 <mutable>` 序列。"
Multi-line Format
msgstr ""
"第一行翻譯內容"
"第二行繼續翻譯。"
Fuzzy Flag
Add #, fuzzy when translation is uncertain or needs human review:
#, fuzzy
msgid "Original text"
msgstr "可能需要審核的翻譯"
References
references/terminology.md - Key term translations (186 terms)references/forbidden-terms.md - zh_CN to zh_TW mappingsreferences/rst-cheatsheet.md - reST syntax rules
