jobs:

ci:

if:github.repository == 'python/python-docs-zh-tw'

runs-on:ubuntu-latest

permissions:

-name:Copy content

run:|

shell:bash

-name:Commit wiki code

progress_percentage=round(progress*100,2)

NUMBER_OF_ISSUES=get_open_issues_count()

result_list= []

forissueinresult["items"]:

ifissue["assignee"]isNone:

assignee=issue["assignee"]["login"]ifissue["assignee"]else""

title=issue["title"]

if"翻譯"notintitleand"translate"notintitle.lower():

match=re.search("(?P<dirname>[^\s`][a-zA-z-]+)/(?P<filename>[a-zA-Z0-9._-]+(.po)?)",title)

match=re.search(

"(?P<dirname>[^\s`][a-zA-z-]+)/(?P<filename>[a-zA-Z0-9._-]+(.po)?)",title)

ifnotmatch:

dirname,filename=match.group('dirname','filename')

ifnotfilename.endswith('.po'):

result_list.append(((dirname,filename),issue["assignee"]["login"]))

result_list.append(((dirname,filename),assignee,issue["html_url"]))

defformat_line_file(filename:str,result:str)->str:

defformat_line_table_header()->list:

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

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

defformat_issue_link(url:str)->str:

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

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

defformat_line_directory(dirname:str)->str:

if__name__=="__main__":

filename=path.name

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

po=polib.pofile(filepath)

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

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

'progress':entry_check(po),

'issue':'',

'assignee':'',

}

for (category,filename),assigneeinissue_list:

for (category,filename),assignee,issue_urlinissue_list:

try:

summary[category][filename]+=f", 💻{assignee}"

summary[category][filename]['issue']=issue_url

summary[category][filename]['assignee']=assignee

exceptKeyError:

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

fordirname,filedictinsummary_sorted.items():

writeliner.append(format_line_directory(dirname))

writeliner.extend(format_line_table_header())

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

forfilename,resultinfiledict_sorted.items():

writeliner.append(format_line_file(filename,result))

forfilename,filedatainfiledict_sorted.items():

writeliner.append(format_line_file(filename,filedata))

withopen(

f"summarize_progress/dist/summarize_progress.md",

f"summarize_progress/result.md",

"w",

)asfile:

file.writelines(writeliner)

forfilein*.po*/*.po;do ln -f$$file$(LC_MESSAGES)/$$file;done

.$(VENV)/bin/activate;$(MAKE) -C$(CPYTHON_CLONE)/Doc/ SPHINXOPTS='-j$(JOBS) -D locale_dirs=locales -D language=$(LANGUAGE) -D gettext_compact=0'$(MODE)

.PHONY: build

build:$(VENV)/bin/sphinx-build$(VENV)/bin/blurb clone## Automatically build an html local version

@$(eval target=$(filter-out$@,$(MAKECMDGOALS)))

@if [-z$(target) ];then\

exit 1;\

@if ["$(suffix$(target))"!=".po" ];then\

exit 1;\

@if [[!-f"$(target)" ]];then\

exit 1;\

@mkdir -p$(LC_MESSAGES)

@$(eval dir=`echo$(target) | xargs -n1 dirname`)## Get dir

@if [ $(dir) != "." ]; then \

echo "mkdir -p $(LC_MESSAGES)/$(dir)"; \

mkdir -p $(LC_MESSAGES)/$(dir); \

echo "ln -f ./$(target) $(LC_MESSAGES)/$(target)"; \

ln -f ./$(target) $(LC_MESSAGES)/$(target); \

fi

@echo "----"

@. $(VENV)/bin/activate; $(MAKE) -C $(CPYTHON_CLONE)/Doc/ SPHINXOPTS='-j$(JOBS) -D language=$(LANGUAGE) -D locale_dirs=locales -D gettext_compact=0' SOURCES='$(basename $(target)).rst' html

help:

@python3 -c"$$PRINT_HELP_PYSCRIPT"<$(MAKEFILE_LIST)

.PHONY: lint

lint:$(VENV)/bin/sphinx-lint## Run sphinx-lint

$(VENV)/bin/sphinx-lint --enable default-role

%:

@:

上請參考 https://gitforwindows.org/）

- 一個 ``.po`` 檔的編輯器。推薦使用 `Poedit<https://poedit.net>`_，若熟悉 po 檔用一般文字編輯器亦可。

- macOS 的使用者還需要先利用 `homebrew<https://brew.sh/index_zh-tw>`_ 安裝 gettext，屆時 Sphinx 會使用到。

..code-block::bash

- 安裝 pre-commit 自動在 commit 時檢查 ``.po`` 檔格式。

..code-block::bash