3f1a5e0fbf
- Create 指定版本部署.md to explain fixed version deployment - Create 最新版.md detailing the use of the latest tag - Create 版本選擇指南.md to guide users on version selection - Add Nginx and Traefik configuration examples for reverse proxy - Introduce minimal and production configuration examples - Develop Docker deployment guide with detailed steps - Implement quick start guide for first-time Docker users - Include version update instructions and rollback procedures - Add troubleshooting section for common issues - Enhance overall documentation structure and links for better navigation
4.5 KiB
4.5 KiB
翻譯功能
ConvertX-CN 內建兩個 PDF 翻譯引擎：
| 引擎 | 命令 | 輸出格式 | 特色 |
|---|---|---|---|
| PDFMathTranslate | pdf2zh |
保留數學公式與排版 | |
| BabelDOC | babeldoc |
PDF / Markdown / HTML | 多格式輸出、快速翻譯 |
PDFMathTranslate
適合學術論文、數學/物理教科書等需要保留公式的文件。
功能特色
- 📊 保留數學公式：LaTeX 公式完整保留
- 📈 保留圖表：圖片、表格位置不變
- 📑 保留目錄：連結與結構完整
- 🌐 多語言支援：15+ 種目標語言
使用方式
- 上傳 PDF 檔案
- 在目標格式選擇
pdf-zh-TW（或其他語言代碼） - 點擊轉換
- 下載翻譯後的 PDF（.tar 檔案）
BabelDOC
適合一般文件翻譯，支援多種輸出格式。
功能特色
- 📄 多格式輸出：PDF、Markdown、HTML
- ⚡ 快速翻譯：針對一般文件優化
- 🔄 格式轉換：可同時翻譯並轉換格式
使用方式
- 上傳 PDF 檔案
- 在目標格式選擇：
pdf-zh-TW：翻譯後輸出 PDFmd-zh-TW：翻譯後輸出 Markdownhtml-zh-TW：翻譯後輸出 HTML
- 點擊轉換
- 下載結果（.tar 檔案）
支援的目標語言
兩個引擎都支援以下語言：
| 格式代碼 | 目標語言 |
|---|---|
pdf-en |
英文 |
pdf-zh |
簡體中文 |
pdf-zh-TW |
繁體中文 |
pdf-ja |
日文 |
pdf-ko |
韓文 |
pdf-de |
德文 |
pdf-fr |
法文 |
pdf-es |
西班牙文 |
pdf-it |
義大利文 |
pdf-pt |
葡萄牙文 |
pdf-ru |
俄文 |
pdf-ar |
阿拉伯文 |
pdf-hi |
印地文 |
pdf-vi |
越南文 |
pdf-th |
泰文 |
💡 BabelDOC 額外支援
md-<lang>和html-<lang>格式
輸出格式
所有輸出一律打包為 .tar 檔案：
PDFMathTranslate 輸出
output.tar
├── original.pdf # 原始 PDF
└── translated-*.pdf # 翻譯後的 PDF
BabelDOC 輸出
output.tar
├── translated-*.pdf # 翻譯後的 PDF（如果選擇 pdf-*）
├── translated-*.md # 翻譯後的 Markdown（如果選擇 md-*）
└── translated-*.html # 翻譯後的 HTML（如果選擇 html-*）
環境變數設定
翻譯服務（PDFMathTranslate）
💡
PDFMATHTRANSLATE_SERVICE可選值：bing、deepl、openai、azure
environment:
- PDFMATHTRANSLATE_SERVICE=google
| 服務 | 說明 | 需要 API Key |
|---|---|---|
google |
Google 翻譯 | ❌ 免費 |
bing |
Bing 翻譯 | ❌ 免費 |
deepl |
DeepL 翻譯 | ✅ |
openai |
OpenAI API | ✅ |
azure |
Azure Translator | ✅ |
使用付費服務
如需使用付費服務，需設定對應的 API Key：
environment:
- PDFMATHTRANSLATE_SERVICE=openai
- OPENAI_API_KEY=sk-xxxxx
# 或
- PDFMATHTRANSLATE_SERVICE=deepl
- DEEPL_API_KEY=xxxxx
適用場景
PDFMathTranslate 適合
- ✅ 學術論文翻譯
- ✅ 數學/物理教科書
- ✅ 包含 LaTeX 公式的文件
- ✅ AI/ML 論文
BabelDOC 適合
- ✅ 一般文件翻譯
- ✅ 需要 Markdown 輸出（方便後續編輯）
- ✅ 需要 HTML 輸出（網頁展示）
- ✅ 快速翻譯大量文件
⚠️ 共同限制
- 掃描版 PDF（系統會自動偵測並使用 OCR 處理）
- 複雜排版的雜誌
- 手寫文件
如何選擇引擎？
| 需求 | 推薦引擎 |
|---|---|
| 有數學公式 | PDFMathTranslate |
| 需要 Markdown 輸出 | BabelDOC |
| 需要 HTML 輸出 | BabelDOC |
| 一般商業文件 | 兩者皆可 |
| 追求翻譯品質 | PDFMathTranslate |
| 追求翻譯速度 | BabelDOC |
注意事項
- 模型已預載：所需模型已在 Docker build 階段下載
- 不會隱式下載：Runtime 不會下載額外模型
- 預設免費服務：使用 Google/Bing 翻譯（免費）
- 離線模式：可設定
HF_HUB_OFFLINE=1確保完全離線