為專案貢獻

感謝您對本專案的關注！在開始貢獻之前，請花一些時間閱讀以下指南，以確保您的貢獻能夠順利被接受。

不接受貢獻的類型

1. 文檔國際化/翻譯
2. 與核心基礎設施相關的貢獻，例如 HTTP API 等。
3. 明確標記為「無需幫助」的 Issue（包括 Byaidu/PDFMathTranslate 和 PDFMathTranslate-next/PDFMathTranslate-next 倉庫中的 Issue）。
4. 維護者認為不適當的其他貢獻。
5. 貢獻文檔，但修改非英文語言的文檔。
6. 需要修改 PDF 檔案的 PR。
7. 修改 pdf2zh_next/gui_translation.yaml 檔案的 PR。

請勿提交與上述類型相關的 PR。

建議在提交前透過 Issue 與維護者討論的 PR 類型

對於以下類型的 PR，建議在提交前先與維護者討論：

1. 與多用戶共享功能相關的 PR。（本專案主要設計為單用戶使用，無意引入完整的多用戶系統）。

貢獻流程

1. Fork 此儲存庫並在本地端克隆它。
2. 建立一個新分支：git checkout -b feature/<feature-name>。
3. 進行開發並確保您的程式碼符合要求。
4. 提交您的程式碼：

   git add .
   git commit -m "<semantic commit message>"
   

5. 推送至您的儲存庫：git push origin feature/<feature-name>。
6. 在 GitHub 上建立一個 PR，提供詳細的描述，並向 @awwaawwa 請求審查。
7. 確保所有自動化檢查都通過。

基本要求

1. 工作流程

• 請從 main 分支進行 fork，並在您 fork 的分支上進行開發。
• 提交 Pull Request (PR) 時，請提供您所做更改的詳細說明。
• 如果您的 PR 未通過自動化檢查（顯示為 checks failed 和紅色叉號），請查看對應的 details 並修改您的提交，以確保新的 PR 通過所有檢查。

2. 開發與測試

• 使用命令 pip install -e . 進行開發和測試。

3. 程式碼格式化

• 配置 pre-commit 工具並啟用 black 和 flake8 進行代碼格式化。

4. 依賴更新

• 如果您引入了新的依賴項，請及時更新 pyproject.toml 文件中的依賴項列表。

5. 文檔更新

• 如果您添加了新的命令行選項，請相應地更新所有語言版本的 README.md 文件中的命令行選項列表。

6. 提交訊息

• 使用 Conventional Commits，例如：feat(translator): add openai。

7. 編碼風格

• 確保您提交的程式碼符合基本的編碼風格標準。
• 變數命名請使用 snake_case 或 camelCase。

8. 文檔格式

• 對於 README.md 的格式，請遵循 中文文案排版指北。
• 確保英文和中文文檔始終保持最新；其他語言文檔的更新是可選的。

添加翻譯引擎

1. 在 pdf2zh/config/translate_engine_model.py 檔案中新增一個翻譯器配置類別。
2. 在同一個檔案中，將新的翻譯器配置類別的實例添加到 TRANSLATION_ENGINE_SETTING_TYPE 類型別名中。
3. 在 pdf2zh/translator/translator_impl 資料夾中新增翻譯器的實作類別。

專案結構

• config 資料夾：配置系統。
• translator 資料夾：翻譯器相關實現。
• gui.py：提供 GUI 介面。
• const.py：一些常數。
• main.py：提供命令行工具。
• high_level.py：基於 BabelDOC 的高階介面。
• http_api.py：提供 HTTP API（未啟動）。

向 AI 詢問以了解專案：DeepWiki

聯繫我們

如果您有任何問題，請透過 Issue 提交回饋或加入我們的 Telegram 群組。感謝您的貢獻！