run:sudo apt-get install gettext

-name:Validate

run:VERSION=${{ github.event.pull_request.base.ref }} MODE=dummy make

run:VERSION=${{ github.event.pull_request.base.ref }} MODE=dummy make all

run:sudo apt-get install gettext

-name:Build

run:make

run:make all

-name:Deploy to gh page

uses:JamesIves/github-pages-deploy-action@3.7.1

.DEFAULT_GOAL := help# Sets default action to be help

import re, sys

output = []

for line in sys.stdin:

match = re.match(r'^([a-zA-Z_-]+):.*?## (.*)$$', line)

if match:

target, help = match.groups()

output.append("%-10s %s" % (target, help))

output.sort()

print('\n'.join(output))

CPYTHON_CLONE := ../cpython/

SPHINX_CONF :=$(CPYTHON_CLONE)/Doc/conf.py

LANGUAGE := zh_TW

BRANCH :=$(or$(VERSION),$(shell git describe --contains --all HEAD))

JOBS := 4

.PHONY: all

all:$(VENV)/bin/sphinx-build$(VENV)/bin/blurb clone

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

mkdir -p$(LC_MESSAGES)

fordirnamein$$(find. -name'*.po'| xargs -n1 dirname| sort -u| grep -v'^\.$$');do mkdir -p$(LC_MESSAGES)/$$dirname;done

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)

help:

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

clone:

clone:## Clone latest cpython repository to `../cpython/` if it doesn't exist

git clone --depth 1 --no-single-branch https://github.com/python/cpython.git$(CPYTHON_CLONE)||echo"cpython exists"

cd$(CPYTHON_CLONE)&& git checkout$(BRANCH)

.PHONY: upgrade_venv

upgrade_venv:$(VENV)/bin/activate

upgrade_venv:$(VENV)/bin/activate## Upgrade the venv that compiles the doc

.$(VENV)/bin/activate; python3 -m pip install --upgrade sphinx python-docs-theme blurb

.PHONY: progress

progress:

progress:## Compute current progression

@python3 -c'import sys; print("{:.1%}".format(int(sys.argv[1]) / int(sys.argv[2])))'\

.PHONY: todo

todo:

todo:## List remaining tasks

forfilein*.po*/*.po;doecho$$(msgattrib --untranslated$$file| grep ^msgid| sed 1d| wc -l )$$file;done| grep -v ^0| sort -gr

.PHONY: merge

merge: upgrade_venv

merge: upgrade_venv## To merge pot from upstream

ifneq "$(shell cd$(CPYTHON_CLONE) 2>/dev/null && git describe --contains --all HEAD)" "$(BRANCH)"

$(error "You're merging from a different branch")

.PHONY: fuzzy

fuzzy:

fuzzy:## Find fuzzy strings

forfilein*.po*/*.po;doecho$$(msgattrib --only-fuzzy --no-obsolete"$$file"| grep -c'#, fuzzy')$$file;done| grep -v ^0| sort -gr

.PHONY: rm_cpython

rm_cpython:

rm_cpython:## Remove cloned cpython repo

rm -rf$(CPYTHON_CLONE)

3. 存檔以後，執行以下列指令編譯輸出文件，以確保你的修改沒有 rST 的語法錯誤或警告 ::