EXTEND.md Schema for baoyu-translate

Format

EXTEND.md uses YAML format:

# Default target language (ISO code or common name)
target_language: zh-CN

# Default translation mode
default_mode: normal  # quick | normal | refined

# Target audience (affects annotation depth and register)
audience: general  # general | technical | academic | business | or custom string

# Translation style preference
style: storytelling  # storytelling | formal | technical | literal | academic | business | humorous | conversational | elegant | or custom string

# Word count threshold to trigger chunked translation
chunk_threshold: 4000

# Max words per chunk
chunk_max_words: 5000

# Custom glossary (merged with built-in glossary)
# CLI --glossary flag overrides these
# Supports inline entries and/or file paths
glossary:
  - from: "Reinforcement Learning"
    to: "强化学习"
  - from: "Transformer"
    to: "Transformer"
    note: "Keep English"

# Load glossary from external file(s)
# Supports absolute path or relative to EXTEND.md location
# File format: markdown table with | from | to | note | columns,
# or YAML list of {from, to, note} entries
glossary_files:
  - ./my-glossary.md
  - /path/to/shared-glossary.yaml

# Language-pair specific glossaries
glossaries:
  en-zh:
    - from: "AI Agent"
      to: "AI 智能体"
  ja-zh:
    - from: "人工知能"
      to: "人工智能"

Fields

Glossary Entry

Glossary File Format

External glossary files (glossary_files) support two formats:

Markdown table (.md):

| from | to | note |
|------|----|------|
| Reinforcement Learning | 强化学习 | |
| Transformer | Transformer | Keep English |

YAML list (.yaml / .yml):

- from: "Reinforcement Learning"
  to: "强化学习"
- from: "Transformer"
  to: "Transformer"
  note: "Keep English"

Paths can be absolute or relative to the EXTEND.md file location.

Priority

1. CLI --glossary file entries
2. EXTEND.md glossaries[pair] entries
3. EXTEND.md glossary entries (inline)
4. EXTEND.md glossary_files entries (in listed order, later files override earlier)
5. Built-in glossary (e.g., references/glossary-en-zh.md)

Later entries override earlier ones for the same source term.