FazBrowse GitHub Viewer
|
Trending
|
URL:
|
Home
Tools:
[Download Repo ZIP]
[View Raw Code]
[Original HTTPS Page]
python-docs-zh-tw/Makefile at weblate · python/python-docs-zh-tw · GitHub
python
python-docs-zh-tw
Repository navigation
Code
Issues
33
(33)
Pull requests
12
(12)
Discussions
Actions
Wiki
Security and quality
Insights
Expand file tree
Breadcrumbs
python-docs-zh-tw
/
Makefile
Copy path
More file actions
More file actions
Latest commit
History
History
History
132 lines (106 loc) · 4.82 KB
Breadcrumbs
python-docs-zh-tw
/
Makefile
Copy path
File metadata and controls
132 lines (106 loc) · 4.82 KB
Raw
Copy raw file
Download raw file
Open symbols panel
Edit and raw actions
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
#
Makefile for Chinese (Taiwan) Python Documentation
#
#
Here is what you can do:
#
#
- make all # Automatically build an html local version
#
- make todo # To list remaining tasks
#
- make merge # To merge pot from upstream
#
- make fuzzy # To find fuzzy strings
#
- make progress # To compute current progression
#
- make upgrade_venv # To upgrade the venv that compiles the doc
#
#
Modes are: autobuild-stable, autobuild-dev, and autobuild-html,
#
documented in gen/src/3.6/Doc/Makefile as we're only delegating the
#
real work to the Python Doc Makefile.
#
#
Credits: Python Documentation French Translation Team (https://github.com/python/python-docs-fr)
.DEFAULT_GOAL
:= help
#
Sets default action to be help
define
PRINT_HELP_PYSCRIPT
#
start of Python section
import re, sys
output = []
#
Loop through the lines in this file
for line in sys.stdin:
#
if the line has a command and a comment start with
#
two pound signs, add it to the output
match = re.match(r'^([a-zA-Z_-]+):.*?
#
# (.*)$$', line)
if match:
target, help = match.groups()
output.append("%-10s %s" % (target, help))
#
Sort the output in alphanumeric order
output.sort()
#
Print the help result
print('\n'.join(output))
endef
export
PRINT_HELP_PYSCRIPT
#
End of python section
CPYTHON_CLONE
:= ../cpython/
SPHINX_CONF
:=
$(
CPYTHON_CLONE
)
/Doc/conf.py
LANGUAGE
:= zh_TW
LC_MESSAGES
:=
$(
CPYTHON_CLONE
)
/Doc/locales/
$(
LANGUAGE
)
/LC_MESSAGES
VENV
:= ~/.venvs/python-docs-i18n/
PYTHON
:=
$(
shell
which python3)
MODE
:= autobuild-dev-html
BRANCH
:=
$(
or
$(
VERSION
)
,
$(
shell
git describe --contains --all HEAD)
)
JOBS
:= 4
.PHONY
: all
all
:
$(
VENV
)
/bin/sphinx-build
$(
VENV
)
/bin/blurb clone
#
# Automatically build an html local version
mkdir -p
$(
LC_MESSAGES
)
for
dirname
in
$$
(find
.
-name
'
*.po
'
|
xargs -n1 dirname
|
sort -u
|
grep -v
'
^\.$$
'
)
;
do
mkdir -p
$(
LC_MESSAGES
)
/
$$
dirname
;
done
for
file
in
*
.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 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
)
$(
VENV
)
/bin/activate
:
mkdir -p
$(
VENV
)
$(
PYTHON
)
-m venv
$(
VENV
)
$(
VENV
)
/bin/sphinx-build
:
$(
VENV
)
/bin/activate
.
$(
VENV
)
/bin/activate
;
python3 -m pip install sphinx python-docs-theme
$(
VENV
)
/bin/blurb
:
$(
VENV
)
/bin/activate
.
$(
VENV
)
/bin/activate
;
python3 -m pip install blurb
.PHONY
: upgrade_venv
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
:
#
# Compute current progression
@python3 -c
'
import sys; print("{:.1%}".format(int(sys.argv[1]) / int(sys.argv[2])))
'
\
$(
shell
msgcat
*
.po
*
/
*
.po | msgattrib --translated | grep -c '^msgid')
\
$(
shell
msgcat
*
.po
*
/
*
.po | grep -c '^msgid')
.PHONY
: todo
todo
:
#
# List remaining tasks
for
file
in
*
.po
*
/
*
.po
;
do
echo
$$
(msgattrib --untranslated
$$
file
|
grep ^msgid
|
sed 1d
|
wc -l )
$$
file
;
done
|
grep -v ^0
|
sort -gr
.PHONY
: merge
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")
endif
(cd $(CPYTHON_CLONE)/Doc; rm -f build/NEWS)
(cd $(CPYTHON_CLONE)/Doc; $(VENV)/bin/sphinx-build -Q -b gettext -D gettext_compact=0 . locales/pot/)
find $(CPYTHON_CLONE)/Doc/locales/pot/ -name '*.pot' |\
while read -r POT;\
do\
PO="./$$(echo "$$POT" | sed "s
#
$(CPYTHON_CLONE)/Doc/locales/pot/##; s#\.pot\$$#.po#")";
\
mkdir -p "$$(dirname "$$PO")";
\
if [ -f "$$PO" ];
\
then
\
case "$$POT" in
\
*whatsnew*) msgmerge --lang=$(LANGUAGE) --backup=off --force-po --no-fuzzy-matching -U "$$PO" "$$POT" ;;
\
*) msgmerge --lang=$(LANGUAGE) --backup=off --force-po -U "$$PO" "$$POT" ;;
\
esac
\
else
\
msgcat --lang=$(LANGUAGE) -o "$$PO" "$$POT";
\
fi
\
done
.PHONY
: update_txconfig
update_txconfig
:
curl -L https://rawgit.com/python-doc-ja/cpython-doc-catalog/catalog-
$(
BRANCH
)
/Doc/locales/.tx/config
|
\
grep --invert-match
'
^file_filter = *
'
|
\
sed -e
'
s/source_file = pot\/\(.*\)\.pot/trans.zh_TW = \1.po/
'
|
\
sed -n
'
w .tx/config
'
.PHONY
: fuzzy
fuzzy
:
#
# Find fuzzy strings
for
file
in
*
.po
*
/
*
.po
;
do
echo
$$
(msgattrib --only-fuzzy --no-obsolete
"
$$
file
"
|
grep -c
'
#, fuzzy
'
)
$$
file
;
done
|
grep -v ^0
|
sort -gr
.PHONY
: rm_cpython
rm_cpython
:
#
# Remove cloned cpython repo
rm -rf
$(
CPYTHON_CLONE
)
Back
|
FazBrowse Home
|
New Git URL