name:summarize_progress

on:

workflow_dispatch:

schedule:

-cron:'30 23 * * 5'

shell:bash

-name:Commit wiki code

uses:stefanzweifel/git-auto-commit-action@v5

uses:stefanzweifel/git-auto-commit-action@v6

with:

commit_message:Weekly Update -- Summarize Progress

repository:markdown

repository:markdown

'變量':'變數',# variable

'常量':'常數',# constant

'添加':'新增',# add

'轉義':'跳脫',# escape

'基類':'基底類別',# base class

}

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:

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

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(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)

請注意此予翻譯專案的授權：Python 的說明文件是以全球的志工社群來維護。透過張貼\

此專案在 Transifex、GitHub 以及其他公眾場合，以及邀請你參與，我們向你提出一個\

協議：你必須將你對於 Python 說明文件或是 Python 說明文件翻譯的貢獻以 CC0\

（請參考 https://creativecommons.org/publicdomain/zero/1.0/legalcode/

（請參考 https://creativecommons.org/publicdomain/zero/1.0/legalcode/

）的方式授權給 PSF 使用。你可以公開地聲明你所貢獻翻譯的部分，並且如果你的翻譯被 PSF

採用，你可以（但並不須要）送出一個修改，其包含在 Misc/ACKS 或是 TRANSLATORS

檔案裡增加合適的注釋。雖然這個說明文件貢獻協議並沒有說明 PSF 有義務納入你的\

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.

Taihsiang Ho (tai271828)

Tsai, Chia-Wen

Wei-Hsiang (Matt) Wang

Weilin Du (LamentXU)

Wilson Wang (Josix)

Yu Chun Yang

Jason (chairco)