name:build

concurrency:preview-${{ github.ref }}

permissions:

contents:write

pull-requests:write

on:

pull_request:

-name:Install uv

uses:astral-sh/setup-uv@v6

-name:Validate

-name:Build HTML Docs

run:VERSION=${{ github.event.repository.default_branch }} JOBS=4 MODE=html make all

-name:Deploy PR Doc Preview

if:${{ ( github.event.pull_request.head.repo.full_name == github.event.pull_request.base.repo.full_name ) }}

uses:rossjrw/pr-preview-action@v1

with:

source-dir:../cpython/Doc/build/html

preview-branch:gh-pages

umbrella-dir:pr-preview

action:auto

-name:Deploy to gh page

uses:JamesIves/github-pages-deploy-action@v4.7.3

with:

GITHUB_TOKEN:${{ secrets.GITHUB_TOKEN }}

BRANCH:gh-pages

FOLDER:../cpython/Doc/build/html

CLEAN:true

token:${{ secrets.GITHUB_TOKEN }}

branch:gh-pages

folder:../cpython/Doc/build/html

clean:true

clean-exclude:pr-preview/

-name:Sync with CPython

run:make clone merge rm_cpython wrap

-uses:tibdex/github-app-token@v2

id:generate-token

-uses:actions/create-github-app-token@v2

id:app-token

with:

app_id:${{ secrets.APP_ID }}

private_key:${{ secrets.APP_PRIVATE_KEY }}

app-id:${{ secrets.APP_ID }}

private-key:${{ secrets.APP_PRIVATE_KEY }}

-name:Create Pull Request

id:cpr

uses:peter-evans/create-pull-request@v6

with:

token:${{ steps.generate-token.outputs.token }}

token:${{ steps.app-token.outputs.token }}

commit-message:sync with cpython ${{ env.LATEST_COMMIT_ID }}

committer:GitHub <noreply@github.com>

author:github-actions[bot] <github-actions[bot]@users.noreply.github.com>

defentry_check(pofile:polib.POFile)->str:

lines_tranlated=len(pofile.translated_entries())

lines_untranlated=len(pofile.untranslated_entries())

iflines_tranlated==0:

eliflines_untranlated==0:

else:

progress_percentage=round(progress*100,2)

defget_open_issues_count()->int:

defformat_line_table_header()->list:

return [f"|Filename|Progress|Issue|Assignee|\r\n",

return [f"|Filename|Progress (#string)|Issue|Assignee|\r\n",

f"|-------:|:-------|:----|:-------|\r\n"]

defformat_issue_link(url:str)->str:

returnf"[{url.split('/')[-1]}]({url})"iflen(url)>0else''

defformat_line_file(dirname:str,filename:str,data:dict)->str:

returnf"|[`{filename}`](https://github.com/python/python-docs-zh-tw/tree/3.13/{dirname}/{filename})"+ \

defformat_line_po_issue_display(issue_link:str,issue_number:str,progress:float,create_issue_link:str)->str:

ifissue_link:

ifprogress!=100.:

defformat_line_directory(dirname:str)->str:

defformat_line_po(filename:str,po_link:str,progress:str,num_entries:str,issue_display:str,assignee:str)->str:

ifprogress==100:

if__name__=="__main__":

forfilepathinglob.glob(str(BASE_DIR/"**/*.po"),recursive=True):

path=Path(filepath)

filename=path.name

dirname=path.parent.nameifpath.parent.name!=BASE_DIR.nameelse'/'

dirname=path.parent.nameifpath.parent.name!=BASE_DIR.nameelse'root'

po=polib.pofile(filepath)

num_entries=len(list(filter(lambdae:note.obsolete,po)))

num_translated=len(po.translated_entries())

summary.setdefault(dirname, {})[filename]= {

'progress':entry_check(po),

'po_info': {

'num_entries':num_entries,

'num_translated':num_translated,

'progress':round(num_translated/num_entries*100,2),

},

'issue':'',

'assignee':'',

}

writeliner= []

summary_sorted=dict(sorted(summary.items()))

total_entries,total_translated=0,0

fordirname,filedictinsummary_sorted.items():

writeliner.append(format_line_directory(dirname))

writeliner.extend(format_line_table_header())

dir_total_entries,dir_total_translated=0,0

lines= []

filedict_sorted=dict(sorted(filedict.items()))

forfilename,filedatainfiledict_sorted.items():

writeliner.append(format_line_file(dirname,filename,filedata))

issue_link=filedata['issue']

issue_display=format_line_po_issue_display(issue_link,issue_number,filedata['po_info']['progress'],create_issue_link)

line_po=format_line_po(

filename,

po_link,

filedata['po_info']['progress'],

filedata['po_info']['num_entries'],

issue_display,

filedata['assignee'],

)

lines.append(line_po)

dir_total_entries+=filedata['po_info']['num_entries']

dir_total_translated+=filedata['po_info']['num_translated']

dir_progress=round(dir_total_translated/dir_total_entries*100,2)

writeliner.append(f"##{dirname} ({dir_progress}%)\r\n")

writeliner.extend(format_line_table_header())

writeliner.extend(lines)

overall_progress=round(total_translated/total_entries*100,2)

writeliner= [title]+writeliner

withopen(

f"summarize_progress/result.md",

"w",

)asfile:

withopen(f"summarize_progress/result.md","w")asfile:

file.writelines(writeliner)

This document describes the terminology dictionaries for maintaining translation consistency across the Python documentation project.

The translation dictionary project provides curated key terms and their translations to help translators maintain consistent terminology usage across different documents. The dictionaries are maintained using LLM knowledge to identify and categorize important Python terminology.

The complete terminology dictionary containing important terms identified from Python documentation. Contains:

-**source_term**: The original English term

-**translated_term**: The corresponding Chinese (Traditional) translation

-**frequency**: Number of occurrences across all files

-**files_count**: Number of different files containing this term

-**source_file**: Example file where this term was found

-**directory**: Directory of the source file

-**example_files**: List of up to 5 files containing this term

Total entries:~196 essential Python terms

A curated subset of~118 terms focusing on the most important Python terminology. Includes additional columns:

-**priority**: High/Medium priority classification

-**category**: Term classification

-**Core Concepts** (7 terms): class, function, method, module, package, object, type

-**Built-in Types** (9 terms): int, str, list, dict, tuple, set, float, bool, complex

-**Keywords/Constants** (25 terms): None, True, False, return, import, def, async, await, and other Python keywords

-**Exceptions** (29 terms): Common*Error and*Exception classes

-**Code Elements** (14 terms): Magic methods like__init__,__str__, etc.

-**Common Terms** (34 terms): Important technical concepts like decorator, generator, iterator

The terminology dictionaries are maintained using LLM knowledge to identify important Python terms and their translations. The dictionaries can be updated as needed to reflect new terminology or improved translations.

1. Start with`focused_terminology_dictionary.csv`

2. Learn standard translations for core Python concepts

3. Reference high-frequency terms for consistency

1. Check new translations against the dictionary

2. Verify consistent terminology usage

3. Update dictionary when establishing new standard translations

1. Track translation progress for key technical terms

2. Identify terminology needing standardization

3. Prioritize translation efforts using frequency data

CSV files use UTF-8 encoding to properly handle Chinese characters. Compatible with Excel, Google Sheets, and other spreadsheet applications.

New terms can be identified and added based on:

- Frequency of appearance in documentation

- Importance to Python concepts

- Consistency needs across translation files

The dictionaries are maintained through careful analysis of:

- Core Python terminology in official documentation

- Existing translation patterns in .po files

- Category-based organization for translator efficiency

- Regular review of term translations for consistency

- Cross-reference with official Python terminology

- Validation against established translation conventions

This documentation provides comprehensive guidance for maintaining and using the translation dictionary system to ensure consistent, high-quality Python documentation translation.