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

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

id:app-token

with:

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

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

-name:Deploy PR Doc Preview

uses:rossjrw/pr-preview-action@v1

with:

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

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

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>

Useful scripts for the translation.

The repository includes terminology dictionaries (`terminology_dictionary.csv` and`focused_terminology_dictionary.csv`) that provide standard translations for important Python terms to maintain consistency across documents. These dictionaries are maintained using LLM knowledge and can be referenced by translators.

See`TERMINOLOGY_DICTIONARY.md` for detailed usage and integration with translation workflow.

Translate all untranslated entries of the given .po file with Google Translate.

.scripts/google_translate.sh library/csv.po

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)