Skip to content
W. H. Wang edited this page Jul 6, 2025 · 4 revisions

專案根目錄的 Makefile 是不是只能在【類 Unix】環境下使用?畢竟裡面使用的命令列工具有些在 Windows 平台下預設是沒有的。像是:msgcat、grep...等。

目前還沒有辦法於 Windows 上執行 make 的建置相關指令。若單純要翻譯的話 Poedit 有支援 Windows 可以針對 .po files 修改;需要執行 make 相關指令可以考慮再轉換到 GitHub Codespace 執行


在 Makefile 中的環境變數【VENV】所指向的目錄【~/.venvs/python-docs-i18n/】是在哪裡建立的?是如何建立的?是需要手動建立的嗎?還是說是透過什麼樣的工具自動建立的?

會在執行 $(VENV)/bin/activate 執行喔,另外 $(VENV)/bin/activate 會被 $(VENV/bin/sphinx-build) 所呼叫並建立虛擬環境,建立的方法是透過 Python 內建的虛擬環境建立模組執行 python3 -m venv <virtual_env_path>


除了 3.X 以外的 gh-pages、weblate branch 是用來做什麼的?

  • 3.X: 官方的 build script 會拉各個 branch 來 build 出各語言頁面,如果相同 string 任一版本有譯文就會在其他版本被複用 (有多版本則取用最新版),所以只要對最新版本 branch (3.13) 翻譯就好
  • gh-pages: 我們現在會把 merge 進 3.13 branch 的翻譯內容 build 一份在 github page 上(workflow 請見here
  • weblate: 是串接 weblate 的實驗用 branch。project 目前貢獻方式是要透過 GitHub 上發 PR & review,但其實這對不熟悉 git/GitHub 但有翻譯能力的志工不友善,所以過去曾想要引入 Weblate 來作為另一個平台,但因為 Weblate 規定的 directory 格式與 python 翻譯 repo 相牴觸,且自動化流程的設計與開發難度較高,目前這項開發是處於 pending 狀態,等有餘裕再繼續處理。
Clone this wiki locally
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy