使用 Codespace 開發與預覽頁面

目前翻譯專案內的一些輔助腳本大多是 *nix/macOS 上才跑得動、難以在 Windows 上執行，若你手邊只有 Windows 系統的話就可以運用 GitHub 所提供的 Codespaces 環境來開發。

什麼是 Codespaces?

Codespaces 為 GitHub 所提供的雲端開發環境，只要使用者有網頁瀏覽器就可以開啟虛擬機進行開發，使用介面幾乎和 VSCode 一樣，也會直接帶有你的 GitHub 權限。

操作方式

1. 進入你 forked repo 頁面，開啟一個新的 Codespace

   

2. Codespace 介面如下圖所示（即網頁版本的 VSCode）。開發方式就是一般 GitHub 協作流程，圖中為翻譯 howto/annotations.po 中的一個句子後將改動推上去範例，指令如下：

   git checkout -b translate-howto-annotation  # 建立名為 translate-howto-annotation 的新 branch 並 checkout
   git add howto/annotations.po                # git add 有所改動的檔案
   git commit -m "..."                         # 增加一個 commit，盡量寫一下簡明扼要的 commit message
   git push origin translate-howto-annotation  # 將 branch 推上去，點擊 output 中自動出現的連結，即可在修改內容後發出 PR

   

3. 若想要預覽 html 的樣子，可以輸入以下指令

   VERSION=3.12 make all                                # 建置 html 的指令，會需要跑 15-20 分鐘
   python -m http.server -d ../cpython/Doc/build/html   # 在虛擬機上 serve 靜態文件頁面

   當輸入第二個指令後，Codespace 會出現提示對話框，點擊「以瀏覽器開啟」按鈕就會開啟文件預覽頁面。