This PR implements a comprehensive terminology extraction system to help maintain consistent translations across the Python documentation project.

Overview

The implementation provides tools to extract key terms and their translations from all .po files in the repository, creating reference dictionaries that translators can use to ensure consistency.

Key Features

• Intelligent terminology extraction: Processes all 509 .po files to identify significant technical terms while filtering out common English words
• Dual dictionary output:
  • Complete dictionary (14,698 terms) for comprehensive reference
  • Focused dictionary (2,904 terms) highlighting high-priority Python terminology
• Smart categorization: Terms are classified by type (Core Concepts, Built-in Types, Keywords/Constants, Exceptions, Code Elements)
• Frequency analysis: Tracks how often terms appear and across how many files
• Priority classification: Helps translators focus on the most important terms first

Tools Added

.scripts/extract_terminology.py

Main extraction script that:

• Scans all .po files recursively
• Applies intelligent filters to focus on technical terminology
• Extracts code elements from backticks
• Tracks frequency and file distribution
• Generates comprehensive CSV output

.scripts/create_focused_dictionary.py

Curation script that:

• Filters for high-priority terms
• Categorizes by term type
• Assigns priority levels
• Creates translator-friendly focused output

Generated Dictionaries

terminology_dictionary.csv

Complete dictionary with columns: source_term, translated_term, frequency, files_count, source_file, directory, example_files

focused_terminology_dictionary.csv

Curated dictionary with additional columns: priority, category

Example high-priority terms:

source_term,translated_term,frequency,category
class,abstract base class（抽象基底類別）,921,Core Concepts
function,呼叫函式時被傳遞給,315,Core Concepts
None,如果一個物件是不滅的,518,Keywords/Constants
ValueError,若 list 中無此元素則會觸發,103,Exceptions

Documentation

• TERMINOLOGY_DICTIONARY.md: Comprehensive documentation covering usage, integration, and technical details
• Updated .scripts/README.md: Integration with existing translation tools

Benefits for Translators

1. Consistency: Reference standard translations for key Python terms
2. Efficiency: Focus on high-priority terminology first
3. Quality: Reduce translation inconsistencies across documents
4. Onboarding: Help new translators learn established terminology

Usage

# Generate complete dictionary
python3 .scripts/extract_terminology.py

# Create focused version
python3 .scripts/create_focused_dictionary.py

The tools can be re-run as translations are updated to maintain current terminology references.

Fixes #1104.

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.