python · eopXD · Jun 20, 2020 · Jun 20, 2020 · May 18, 2021 · May 24, 2021
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -0,0 +1,20 @@
+name: build
+
+on:
+  pull_request:
+    branches:
+      - "3.7"
+      - "3.8"
+      - "3.9"
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Install Dependencies
+        run: sudo apt-get install gettext
+
+      - name: Build
+        run: VERSION=${{ github.event.pull_request.base.ref }} make
diff --git a/.github/workflows/deploy-gh-page.yml b/.github/workflows/deploy-gh-page.yml
@@ -0,0 +1,26 @@
+name: deploy-gh-page
+
+on:
+  push:
+    branches:
+      - "3.9"
+
+jobs:
+  cd:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Install Dependencies
+        run: sudo apt-get install gettext
+
+      - name: Build
+        run: make
+
+      - name: Deploy to gh page
+        uses: JamesIves/github-pages-deploy-action@3.7.1
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          BRANCH: gh-pages
+          FOLDER: ../cpython/Doc/build/html
+          CLEAN: true
diff --git a/.github/workflows/py39-sync-cpython.yml b/.github/workflows/py39-sync-cpython.yml
@@ -0,0 +1,64 @@
+name: python-3.9-sync-with-cpython
+
+on:
+  push:
+    branches:
+      - "3.9"
+  schedule:
+    - cron: "0 0 * * *"
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+    env:
+      VERSION: "3.9"
+      BRANCH: "cron/sync/3.9"
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          ref: ${{ env.VERSION }}
+
+      - name: Get the changes on branch (if exists)
+        continue-on-error: true
+        run: |
+          git fetch origin ${{ env.BRANCH }}:${{ env.BRANCH }}
+          git reset --hard ${{ env.BRANCH }}
+
+      - name: Set env
+        run: echo "LATEST_COMMIT_ID=$(git ls-remote https://github.com/python/CPython.git $VERSION | head -c 8)" >> $GITHUB_ENV
+
+      - name: Install Dependencies
+        run: sudo apt-get install gettext
+
+      - name: Sync with CPython
+        run: make clone && make merge && make rm_cpython
+
+      - uses: tibdex/github-app-token@v1
+        id: generate-token
+        with:
+          app_id: ${{ secrets.APP_ID }}
+          private_key: ${{ secrets.APP_PRIVATE_KEY }}
+
+      - name: Create Pull Request
+        id: cpr
+        uses: peter-evans/create-pull-request@v3
+        with:
+          token: ${{ steps.generate-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>
+          base: ${{ env.VERSION }}
+          branch: ${{ env.BRANCH }}
+          delete-branch: false
+          title: 'Sync with CPython ${{ env.VERSION }}'
+          body: |
+            Sync with CPython ${{ env.VERSION }}
+          draft: true
+          labels: |
+            sync-cpython
+            automation
+
+      - name: Check outputs
+        run: |
+          echo "Pull Request Number - ${{ steps.cpr.outputs.pull-request-number }}"
+          echo "Pull Request URL - ${{ steps.cpr.outputs.pull-request-url }}"
diff --git a/Makefile b/Makefile
@@ -22,20 +22,20 @@ LC_MESSAGES := $(CPYTHON_CLONE)/Doc/locales/$(LANGUAGE)/LC_MESSAGES
 VENV := ~/.venvs/python-docs-i18n/
 PYTHON := $(shell which python3)
 MODE := autobuild-dev-html
-BRANCH = $(shell git describe --contains --all HEAD)
+BRANCH := $(or $(VERSION), $(shell git describe --contains --all HEAD))
 JOBS = 1
 
 
 .PHONY: all
-all: $(VENV)/bin/sphinx-build $(VENV)/bin/blurb $(SPHINX_CONF)
+all: $(VENV)/bin/sphinx-build $(VENV)/bin/blurb clone
 	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)
 
 
-$(SPHINX_CONF):
-	git clone --depth 1 --no-single-branch https://github.com/python/cpython.git $(CPYTHON_CLONE)
+clone:
+	git clone --depth 1 --no-single-branch https://github.com/python/cpython.git $(CPYTHON_CLONE)  || echo "cpython exists"
 	cd $(CPYTHON_CLONE) && git checkout $(BRANCH)
 
 
@@ -84,11 +84,11 @@ endif
 	        if [ -f "$$PO" ];\
 	        then\
 	            case "$$POT" in\
-	            *whatsnew*) msgmerge --backup=off --force-po --no-fuzzy-matching -U "$$PO" "$$POT" ;;\
-	            *)          msgmerge --backup=off --force-po -U "$$PO" "$$POT" ;;\
+	            *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 -o "$$PO" "$$POT";\
+	            msgcat --lang=$(LANGUAGE) -o "$$PO" "$$POT";\
 	        fi\
 	    done
 
@@ -104,3 +104,7 @@ update_txconfig:
 .PHONY: fuzzy
 fuzzy:
 	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:
+	rm -rf $(CPYTHON_CLONE)
diff --git a/README.rst b/README.rst
@@ -6,11 +6,11 @@ Python 官方說明文件臺灣繁體中文翻譯計畫
    :target: https://t.me/PyDocTW
    :alt: Join Chat on Telegram
 
-這是 Python 3.7 官方說明文件的臺灣繁體中文（zh_TW）翻譯。
+這是 Python 3.9 官方說明文件的臺灣繁體中文（zh_TW）翻譯。
 
-翻譯之前，請務必詳讀並同意\ `授權與 License`_。參與方式請參考\ `參加翻譯`_。
+翻譯之前，請務必詳讀並同意\ `授權與 License`_。參與方式請參考\ `參與翻譯`_。
 
-您可以在 https://python-doc-tw.github.io/ 瀏覽目前翻譯的成果。
+您可以在 https://python.github.io/python-docs-zh-tw/ 瀏覽目前翻譯的成果。
 
 想問問題、認識翻譯同好，歡迎加入 Telegram 聊天室 `t.me/PyDocTW`_
 
@@ -61,19 +61,26 @@ the PSF for inclusion in the documentation.
 您在對 PSF 送出說明文件貢獻的同時，即表示同意上述的協議。
 
 
-參加翻譯
+參與翻譯
 ========
 
-如何參加翻譯
+關於 po (Portable Object) 檔
+-----------------------------
+
+此為所需翻譯的文字檔，副檔名為 ``.po``，不同語系就會有一個 po 檔。主要內容為翻譯的參考原始字串 (*msgid*)，\
+及需要填入的翻譯字串 (*msgstr*)。有時你會看到 ``#, fuzzy`` 的註記，它代表此翻譯字串需要校閱。
+
+翻譯流程
 ------------
 
-**事先需要有：**
+事先需要有
+~~~~~~~~~~
 
 - 一個 `GitHub 帳號 <https://github.com/join>`_
 - `安裝好 git <https://help.github.com/articles/set-up-git/>`_\ （Windows
   上請參考 https://gitforwindows.org/）
-- 一個 ``.po`` 檔的編輯器，如果還沒有的話請使用 `poedit <https://poedit.net>`_
-- MacOS 的使用者還需要先利用 `homebrew <https://brew.sh/index_zh-tw>`_ 安裝 gettext ，屆時 Sphinx 會使用到。
+- 一個 ``.po`` 檔的編輯器。推薦使用 `Poedit <https://poedit.net>`_，若熟悉 po 檔用一般文字編輯器亦可。
+- macOS 的使用者還需要先利用 `homebrew <https://brew.sh/index_zh-tw>`_ 安裝 gettext，屆時 Sphinx 會使用到。
 .. code-block:: bash
 
   brew install gettext
@@ -84,7 +91,10 @@ the PSF for inclusion in the documentation.
 按鈕），這樣會把整個專案複製一份到你的 GitHub 帳號底下，你可以對這個 fork
 進行修改。
 
-在\ **第一次貢獻以前**\ （還沒有 clone 過），請在 terminal 裡依照以下步驟：
+第一次貢獻以前（還沒有 clone 過)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+請在 terminal 裡依照以下步驟：
 
 .. code-block:: bash
 
@@ -97,7 +107,10 @@ the PSF for inclusion in the documentation.
   # 將 python/python-docs-zh-tw 設為 upstream remote
   git remote add upstream https://github.com/python/python-docs-zh-tw.git
 
-在\ **每一次翻譯時**\ 請遵照以下步驟（`GitHub Flow`_）：
+每一次翻譯時
+~~~~~~~~~~~~
+
+請遵照以下步驟（`GitHub Flow`_）：
 
 .. _GitHub Flow: https://guides.github.com/introduction/flow/
 
@@ -106,27 +119,30 @@ the PSF for inclusion in the documentation.
 
 接著在 terminal 裡按照以下步驟：
 
-1. 基於最新版本的 ``upstream/3.7`` 開啟一個 branch，現在假設我們想要翻譯 Glossary
+1. 基於最新版本的 ``upstream/3.9`` 開啟一個 branch，現在假設我們想要翻譯 Glossary \
    所以把這個 branch 叫做 ``glossary`` ::
 
     git fetch upstream
-    git checkout -b glossary upstream/3.7
+    git checkout -b glossary upstream/3.9
 
-2. 接著就可以開始翻譯，你可以使用 Poedit 應用程式將檔案打開，或是用以下指令\
-   （翻譯不同檔案時將 glossary 換成別的檔名） ::
+2. 接著就可以開始翻譯（翻譯時可參考`翻譯守則`_），你可以手動開啟 Poedit 應用程式再選檔案或用以下指令請 Poedit 將檔案\
+   打開，翻譯不同檔案時將 glossary 換成別的檔名） ::
 
     poedit glossary.po
 
-3. 存檔以後，可以輸出文件以確保你的修改沒有 rST 的語法錯誤或警告 ::
+3. 存檔以後，執行以下列指令編譯輸出文件，以確保你的修改沒有 rST 的語法錯誤或警告 ::
 
     make
 
-   這個過程中 Sphinx 會幫你檢查 rST 語法錯誤，我們盡量保持沒有 warning
+   如果你還沒有執行 `維護、預覽`_ 的 clone CPython 的動作，此指令會自動幫你 clone CPython，\
+   並且會使用 Sphinx 幫你檢查 rST 語法錯誤，我們盡量保持沒有 warning \
    的狀態，因此如果有出現 warning 的話請修復它。另外也記得檢查是否符合\
    `翻譯守則`_
 
-4. 在瀏覽器中打開編譯出來的文件以確認整份文件的語意通暢\
-   （翻譯別的檔案時將 glossary 換成別的檔名） ::
+4. 輸出的文件會被放置在您的本地端 CPython clone（見 `維護、預覽`_ 段落的圖示）\
+   底下的 ``Doc/build/html``，切換到該目錄再使用 ``python3 -m http.server`` \
+   或類似的靜態網頁伺服器即可以預覽成果。你可以執行下列指令請瀏覽器打開編譯出來的文件\
+   以確認整份文件的語意通暢（翻譯別的檔案時將 glossary 換成別的檔名） ::
 
     open ../cpython/Doc/build/html/glossary.html
 
@@ -159,14 +175,16 @@ the PSF for inclusion in the documentation.
 
 - 從 upstream（我們的主要 GitHub repo）做 fetch 的動作
 - 對 origin（你的 fork）做 push
-- 永遠不對 ``3.7`` branch 進行修改，請保持讓這個 branch 唯讀，可以避免\
+- 永遠不對 ``3.9`` branch 進行修改，請保持讓這個 branch 唯讀，可以避免\
   掉很多問題。
 
 要翻譯哪些東西
 --------------
 
-最簡單的貢獻方式就是更新 *fuzzy entries*，讓翻譯的內容保持與最新版本的文件\
-同步。請參考 `尋找 fuzzy entries`_ 段落。
+主要是填入翻譯字串 (*msgid*) 以及更新有標記為 ``#, fuzzy`` 的字串。
+
+其中最簡單的貢獻方式就是更新 *fuzzy entries*，讓曾經翻譯的內容保持與最新版本的文件\
+同步。請參考 `尋找有翻譯過但需校閱的 fuzzy entries`_ 段落。
 
 此外，當前的目標為完成 **Tutorial** 的翻譯，因此在 ``tutorial/`` 底下的所有
 po 檔皆為首要的翻譯對象。您也可以幫忙校對已經翻譯過的內容。
@@ -344,7 +362,7 @@ type                  型別
 幫助，則可以使用 Telegram_。
 
 .. _Issue: https://github.com/python-doc-tw/python-docs-zh-tw/issues
-.. _Telegram: https://t.me/PyDocT
+.. _Telegram: https://t.me/PyDocTW
 
 另外，此翻譯的 coordinator 為 `adrianliaw <https://github.com/adrianliaw>`_，\
 您也可以透過此 email 聯繫：``adrianliaw2000 at gmail dot com``。
@@ -382,36 +400,28 @@ type                  型別
 這樣可以避免下載完整的 commit 歷史（對輸出文件沒什麼幫助），但仍然能把所有的
 branch clone 下來。
 
-與 CPython 同步最新的 pot 檔
-----------------------------
+與 CPython 同步最新的 pot 檔 (目前由 GitHub Actions 定時代為執行)
+----------------------------------------------------------
+
+pot 檔為翻譯的樣板檔案，它包含需要翻譯的原始字串 (*msgid*) 跟其對應的空白翻譯字串 (*msgstr*)，\
+此步驟會參考最新的 CPython 中的 pot 檔來更新 po 檔。如果是之前在 po 檔中已填入過翻譯字串但參考的 \
+pot 檔的 ``msgid`` 已有變動，則此指令會自動加上 ``#, fuzzy`` 的標記，代表內容有些許差異需要更新。
 
 .. code-block:: bash
 
   $ make merge
 
-尋找 fuzzy entries
-------------------
+尋找有翻譯過但需校閱的 fuzzy entries
+---------------------------------
 
-*Fuzzy entries* 係指更新 po 檔的原始字串（*msgid*）以後，大部分內容相同但有\
-些許差異的字串，即表示該字串的翻譯需要更新。在 po 檔中，您會看到 ``#, fuzzy``
-的字樣，這就表示了接下來的字串是 fuzzy entry，需要更新翻譯。
+在 po 檔中，您會看到 ``#, fuzzy`` 的字樣，這就表示了接下來的字串是 fuzzy entry，需要更新翻譯。\
+您可以自行用習慣的文字編輯器、Linux 指令搜尋有包含此字樣的檔案，但請記得 ``#, fuzzy`` 標記的翻譯字串\
+有可能是尚未翻譯過的空白字串 (*msgstr*)。執行下列指令會列出有 *Fuzzy entries* 的檔案且會排除這個情形。
 
 .. code-block:: bash
 
   $ make fuzzy
 
-本地端編譯輸出文件
-------------------
-
-輸出的文件會被放置在您的本地端 CPython clone（見 `維護、預覽`_ 段落的圖示）\
-底下的 ``Doc/build/html``，切換到該目錄再使用 ``python3 -m http.server``
-或類似的靜態網頁伺服器即可以預覽成果。編譯程序則使用：
-
-.. code-block:: bash
-
-  $ make
-
-
 Project History
 ===============