da856d89ff
- Create README.md for internationalization (i18n) documentation - Add English translation for main README and quick start guide - Add Japanese translation for main README - Add Simplified Chinese translation for main README - Introduce sample Docker Compose configurations for various deployment scenarios - Implement CI/CD documentation for testing and deployment workflows - Establish end-to-end testing guidelines and strategies - Create test strategy documentation outlining unit, integration, and E2E tests
118 lines
2.3 KiB
Markdown
118 lines
2.3 KiB
Markdown
# 翻譯功能
|
||
|
||
ConvertX-CN 內建 PDFMathTranslate 引擎，可翻譯 PDF 同時保留數學公式與排版。
|
||
|
||
---
|
||
|
||
## 功能特色
|
||
|
||
- 📊 **保留數學公式**：LaTeX 公式完整保留
|
||
- 📈 **保留圖表**：圖片、表格位置不變
|
||
- 📑 **保留目錄**：連結與結構完整
|
||
- 🌐 **多語言支援**：15+ 種目標語言
|
||
|
||
---
|
||
|
||
## 支援的目標語言
|
||
|
||
| 格式代碼 | 目標語言 |
|
||
| ----------- | -------- |
|
||
| `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` | 泰文 |
|
||
|
||
---
|
||
|
||
## 使用方式
|
||
|
||
1. 上傳 PDF 檔案
|
||
2. 在目標格式選擇 `pdf-zh-TW`（或其他語言）
|
||
3. 點擊轉換
|
||
4. 下載翻譯後的 PDF
|
||
|
||
---
|
||
|
||
## 輸出格式
|
||
|
||
所有輸出一律打包為 `.tar` 檔案，包含：
|
||
|
||
```
|
||
output.tar
|
||
├── original.pdf # 原始 PDF
|
||
└── translated-*.pdf # 翻譯後的 PDF
|
||
```
|
||
|
||
---
|
||
|
||
## 環境變數設定
|
||
|
||
### PDFMATHTRANSLATE_SERVICE
|
||
|
||
選擇翻譯服務提供商。
|
||
|
||
| 值 | 說明 |
|
||
| -------- | ------------------- |
|
||
| `google` | Google 翻譯（預設） |
|
||
| `deepl` | DeepL 翻譯 |
|
||
| `openai` | OpenAI API |
|
||
| `azure` | Azure Translator |
|
||
|
||
```yaml
|
||
environment:
|
||
- PDFMATHTRANSLATE_SERVICE=google
|
||
```
|
||
|
||
### 使用付費服務
|
||
|
||
如需使用 DeepL 或 OpenAI 等付費服務，需設定 API Key：
|
||
|
||
```yaml
|
||
environment:
|
||
- PDFMATHTRANSLATE_SERVICE=openai
|
||
- OPENAI_API_KEY=sk-xxxxx
|
||
```
|
||
|
||
---
|
||
|
||
## 適用場景
|
||
|
||
### ✅ 適合
|
||
|
||
- 學術論文翻譯
|
||
- 數學/物理教科書
|
||
- 技術文件翻譯
|
||
- AI/ML 論文
|
||
|
||
### ⚠️ 限制
|
||
|
||
- 掃描版 PDF（需先 OCR）
|
||
- 複雜排版的雜誌
|
||
- 手寫文件
|
||
|
||
---
|
||
|
||
## 注意事項
|
||
|
||
1. **模型已預載**：所需模型已在 Docker build 階段下載
|
||
2. **不會隱式下載**：Runtime 不會下載額外模型
|
||
3. **預設免費服務**：使用 Google 翻譯（免費）
|
||
|
||
---
|
||
|
||
## 相關文件
|
||
|
||
- [支援的轉換器](converters.md)
|
||
- [OCR 功能](ocr.md)
|
||
- [環境變數設定](../configuration/environment-variables.md)
|