python
Translate the first half of howto/descriptor
This PR completes the translation of the first half of the Python descriptor guide (howto/descriptor.po) from English to Traditional Chinese (Taiwan).
What was translated
The first half includes:
1. Introduction & Contents Section
- Guide overview explaining the four major sections
- Clear navigation guidance for readers new to descriptors
2. Primer Section (Complete)
- Simple example: Basic descriptor that returns a constant
- Dynamic lookups: Descriptors that run computations
- Managed attributes: Using descriptors to control access to instance data
-
Customized names: Leveraging
__set_name__for automatic field naming - Closing thoughts: Core descriptor concepts and their usage throughout Python
Translation Quality
- ✅ Build tested: No syntax errors or warnings
- ✅ Terminology consistency: Established standard Chinese translations for key technical terms
- ✅ reST formatting preserved: All Sphinx markup and cross-references maintained
- ✅ Code examples preserved: Programming examples left in English as per project conventions
Key Technical Terms Established
| English | 繁體中文 |
|---|---|
| descriptor | 描述器 |
| attribute lookup | 屬性查找 |
| class variable | 類別變數 |
| instance | 實例 |
| dynamic lookup | 動態查找 |
| managed attributes | 受管理的屬性 |
| dot operator | 點運算子 |
| callback | 回呼 |
The translation makes descriptor concepts accessible to Chinese-speaking Python developers, covering all fundamental examples and explanations needed to understand how descriptors work.
Fixes #450.
[!WARNING]
Firewall rules blocked me from connecting to one or more addresses
I tried to connect to the following addresses, but was blocked by firewall rules:
astral.sh
- Triggering command:
curl -LsSf REDACTED(dns block)If you need me to access, download, or install something from one of these locations, you can either:
- Configure Actions setup steps to set up my environment, which run before the firewall is enabled
- Add the appropriate URLs or hosts to my firewall allow list
💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.
@copilot
- for the existing translation, observe how other po files do these:
- add the line break as appropriate
- you need to translate the docstrings and code comments in the code black
- continue translating next section
@copilot
- for the existing translation, observe how other po files do these:
- add the line break as appropriate ...
Fixed line breaks and translated code comments in existing sections. Continued translation with "Complete Practical Example" section including validator classes and practical applications. All code comments now properly translated to Chinese following established patterns from other po files. (58f99a2)
PR Preview Action v1.6.2 :---: |
:rocket: View preview athttps://python.github.io/python-docs-zh-tw/pr-preview/pr-1120/
|
![github-actions[bot] avatar](https://avatars.githubusercontent.com/in/15368?v=4 "Published by a pub.dev verified publisher"){kind=small}