co-op-translator

Co-op 翻譯器

輕鬆自動化將您的教育 GitHub 內容翻譯成多種語言，觸及全球受眾。

🌐 多語言支援

由 Co-op Translator 支援

阿拉伯語 | 孟加拉語 | 保加利亞語 | 緬甸語 | 中文（簡體） | 中文（繁體，香港） | 中文（繁體，澳門） | 中文（繁體，台灣） | 克羅地亞語 | 捷克語 | 丹麥語 | 荷蘭語 | 愛沙尼亞語 | 芬蘭語 | 法語 | 德語 | 希臘語 | 希伯來語 | 印地語 | 匈牙利語 | 印尼語 | 義大利語 | 日語 | 坎納達語 | 韓語 | 立陶宛語 | 馬來語 | 馬拉雅拉姆語 | 馬拉地語 | 尼泊爾語 | 奈及利亞皮欽語 | 挪威語 | 波斯語（法爾西語） | 波蘭語 | 葡萄牙語（巴西） | 葡萄牙語（葡萄牙） | 旁遮普語（古魯穆奇） | 羅馬尼亞語 | 俄語 | 塞爾維亞語（西里爾字母） | 斯洛伐克語 | 斯洛文尼亞語 | 西班牙語 | 斯瓦希里語 | 瑞典語 | 他加祿語（菲律賓語） | 泰米爾語 | 泰盧固語 | 泰語 | 土耳其語 | 烏克蘭語 | 烏爾都語 | 越南語

概覽

Co-op 翻譯器 幫助您輕鬆將教育類 GitHub 內容本地化成多種語言。 當您更新 Markdown 檔案、圖片或筆記本時，翻譯會自動同步，確保您的內容對全球學習者保持準確且最新。

以下是翻譯內容的組織範例：

快速開始

# 建立並啟動虛擬環境（建議）
python -m venv .venv
# Windows 系統
.venv\Scripts\activate
# macOS/Linux 系統
source .venv/bin/activate
# 安裝套件
pip install co-op-translator
# 翻譯
translate -l "ko ja fr" -md

Docker：

# 從 GHCR 拉取公共映像
docker pull ghcr.io/azure/co-op-translator:latest
# 以掛載當前資料夾及提供 .env 的方式運行（Bash/Zsh）
docker run --rm -it --env-file .env -v "${PWD}:/work" ghcr.io/azure/co-op-translator:latest -l "ko ja fr" -md

最簡設定

1. 使用範本建立 .env 檔案：.env.template
2. 設定一個 LLM 供應商（Azure OpenAI 或 OpenAI）
3. （可選）若要翻譯圖片（-img），請設定 Azure AI Vision
4. （建議）清理先前的翻譯資料夾以避免衝突（例如 translations/）
5. （建議）在 README 加入翻譯語言區塊，使用 README 語言範本
6. 參考：設定 Azure AI

使用方式

翻譯所有支援的類型：

translate -l "ko ja"

只翻譯 Markdown：

translate -l "de" -md

Markdown + 圖片：

translate -l "pt" -md -img

只翻譯筆記本：

translate -l "zh" -nb

更多參數：指令參考

功能特色

• 自動翻譯 Markdown、筆記本及圖片
• 翻譯內容與原始檔案變更保持同步
• 可本地執行（CLI）或在 CI（GitHub Actions）中使用
• 支援 Azure OpenAI 或 OpenAI；圖片翻譯可選用 Azure AI Vision
• 保留 Markdown 格式與結構

文件

• 命令列指南
• GitHub Actions 指南（公開倉庫與標準密鑰）
• GitHub Actions 指南（Microsoft 組織倉庫與組織層級設定）
• README 語言範本
• 支援語言
• 貢獻指南
• 故障排除

Microsoft 專屬指南

[!NOTE] 僅供 Microsoft “For Beginners” 倉庫維護者參考。

• 更新「其他課程」清單（僅限 MS Beginners 倉庫）

支持我們，促進全球學習

加入我們，一起革新教育內容的全球分享方式！在 GitHub 為 Co-op Translator 點⭐，支持我們打破學習與科技的語言障礙。您的關注與貢獻將帶來重大影響！歡迎提交程式碼與功能建議。

以您的語言探索 Microsoft 教育內容

• AZD for Beginners
• Edge AI for Beginners
• Model Context Protocol (MCP) For Beginners
• AI Agents for Beginners
• Generative AI for Beginners using .NET
• Generative AI for Beginners
• Generative AI for Beginners using Java
• ML for Beginners
• Data Science for Beginners
• AI for Beginners
• Cybersecurity for Beginners
• Web Dev for Beginners
• IoT for Beginners
• PhiCookBook

影片介紹

👉 點擊下方圖片於 YouTube 觀看。

• Open at Microsoft：18 分鐘簡短介紹與快速教學，教你如何使用 Co-op 翻譯器。

  

貢獻

本專案歡迎各種貢獻與建議。想為 Azure Co-op Translator 貢獻嗎？請參考我們的 CONTRIBUTING.md 了解如何協助讓 Co-op 翻譯器更易於使用。

貢獻者

行為準則

本專案採用 Microsoft 開源行為準則。 更多資訊請參閱 行為準則常見問題 或 聯絡 opencode@microsoft.com 提問或提供意見。

負責任的 AI

Microsoft 致力協助客戶負責任地使用我們的 AI 產品，分享經驗，並透過透明度說明與影響評估等工具建立信任夥伴關係。許多資源可在 https://aka.ms/RAI 找到。 Microsoft 的負責任 AI 方針基於公平性、可靠性與安全性、隱私與安全、包容性、透明度及問責制等原則。

大型自然語言、影像與語音模型——如本範例所用——可能會出現不公平、不可靠或冒犯性的行為，進而造成傷害。請參考 Azure OpenAI 服務透明度說明 了解相關風險與限制。 建議的風險緩解方法是在您的架構中加入一個安全系統，能夠偵測並防止有害行為。Azure AI Content Safety 提供獨立的保護層，能夠偵測應用程式和服務中用戶生成及 AI 生成的有害內容。Azure AI Content Safety 包含文字和影像 API，讓您能夠偵測有害的素材。我們也提供一個互動式的 Content Safety Studio，讓您可以查看、探索並試用跨不同模態偵測有害內容的範例程式碼。以下的快速入門文件會引導您如何向服務發出請求。

另一個需要考慮的面向是整體應用程式的效能。對於多模態和多模型的應用程式，我們認為效能是指系統能如您和使用者所期望地運作，包括不產生有害輸出。評估整體應用程式的效能時，使用生成品質及風險與安全指標是很重要的。

您可以在開發環境中使用prompt flow SDK來評估您的 AI 應用程式。無論是使用測試資料集或目標，您的生成式 AI 應用程式的生成結果都會透過內建評估器或您選擇的自訂評估器進行量化測量。若要開始使用 prompt flow sdk 評估您的系統，您可以參考快速入門指南。執行評估後，您可以在Azure AI Studio 中視覺化結果。

商標

本專案可能包含專案、產品或服務的商標或標誌。授權使用 Microsoft 商標或標誌須遵守並遵循Microsoft 商標與品牌指南。在本專案的修改版本中使用 Microsoft 商標或標誌，不得造成混淆或暗示 Microsoft 贊助。任何第三方商標或標誌的使用均須遵守該第三方的政策。

尋求協助

如果您遇到困難或對建立 AI 應用程式有任何疑問，歡迎加入：

如果您在開發過程中有產品回饋或錯誤，請造訪：

---

免責聲明：
本文件由 AI 翻譯服務 Co-op Translator 進行翻譯。雖然我們致力於確保準確性，但請注意，自動翻譯可能包含錯誤或不準確之處。原始文件的母語版本應被視為權威來源。對於重要資訊，建議採用專業人工翻譯。我們不對因使用本翻譯而引起的任何誤解或誤釋承擔責任。

This site is open source. Improve this page.