OpenParable
Skip to content
← Back to skills

Translate Po

Documents
translate-po

Translate Po is an Agent Skill for documents published in the python/python-docs-zh-tw repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Translates PO file entries from English to Traditional Chinese (zh_TW) following project conventions. Use when translating new PO files or untranslated entries.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/python/python-docs-zh-tw/blob/HEAD/.claude/skills/translate-po/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/translate-po, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

translate-po

Translate English PO msgid entries to Traditional Chinese msgstr following all project rules.

Prerequisites

  1. Read the full msgid before translating
  2. Check msgctxt and translator comments for context
  3. Look up terminology in references/terminology.md
  4. 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

  1. Check term in references/terminology.md
  2. If not found, check glossary.po in project root
  3. If uncertain, add #, fuzzy flag
  4. 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:

  • Line length <= 79 characters
  • Full-width punctuation in Chinese text
  • CJK-Latin spacing correct
  • reST syntax preserved
  • Terminology matches glossary
  • No forbidden zh_CN terms

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 mappings
  • references/rst-cheatsheet.md - reST syntax rules