convertor/docs/說明文件.md

ConvertX-CN 文件中心

歡迎來到 ConvertX-CN 文件！選擇您的角色快速找到所需資訊。

---

🚀 快速入門

剛開始使用？從這裡開始：

1. 概覽 — 了解 ConvertX-CN 是什麼
2. 快速開始 — 5 分鐘內完成部署
3. 常見問題 — 解決常見問題

---

👤 使用者指南

適合一般使用者：

文件	說明
快速開始	最快部署方式
支援的轉換器	所有可用的轉換格式
OCR 功能	光學字元辨識
翻譯功能	PDF 翻譯（保留公式）
多語言介面	切換介面語言
常見問題	FAQ

---

🛠️ 系統管理員指南

適合部署與維護人員：

部署

文件	說明
Docker 部署	Docker Run & Docker Compose
Lite 版部署	輕量版（較小 Image）
反向代理	Nginx / Traefik / Caddy
範例配置	可直接使用的配置檔

配置

文件	說明
環境變數	所有可用設定
安全性設定	HTTPS、認證、防護
清理與限制	自動清理、資源限制

---

👩‍💻 開發者指南

適合貢獻者與擴充開發：

開發

文件	說明
專案結構	程式碼結構說明
本地開發	開發環境設定
貢獻指南	如何參與專案

API

文件	說明
API 總覽	REST & GraphQL API
API 端點	詳細端點說明

測試

文件	說明
測試策略	測試類型與方法
CI/CD	持續整合設定
E2E 測試	端對端測試

---

📁 文件結構

docs/
├── 說明文件.md                        ← 您在這裡
├── 快速入門/
│   ├── 概覽.md
│   ├── 快速開始.md
│   └── 常見問題.md
├── 部署指南/
│   ├── Docker部署.md
│   └── 反向代理.md
├── 配置設定/
│   ├── 環境變數.md
│   ├── 安全性.md
│   └── 清理與限制.md
├── 功能說明/
│   ├── 轉換器.md
│   ├── 翻譯功能.md
│   ├── OCR.md
│   └── 多語言介面.md
├── API/
│   ├── 總覽.md
│   └── 端點.md
├── 測試/
│   ├── 測試策略.md
│   ├── CI-CD.md
│   └── E2E測試.md
├── 開發指南/
│   ├── 專案結構.md
│   ├── 本地開發.md
│   └── 貢獻指南.md
└── 範例配置/
    ├── compose.minimal.example.yml
    ├── compose.production.example.yml
    ├── traefik.example.yml
    └── nginx.example.conf

---

🔗 快速連結

• 📦 GitHub Repo
• 🐛 Issues
• 💬 Discussions
• 📝 Changelog
• 📄 License

---

📖 閱讀路徑建議

我是新手

1. 概覽
2. 快速開始
3. 支援的轉換器

我要部署到生產環境

1. Docker 部署
2. 反向代理
3. 安全性設定
4. 環境變數

我想參與開發

1. 專案結構
2. 本地開發
3. 貢獻指南
4. 測試策略

---

🌐 多語言文件

此文件以繁體中文為主，我們也提供其他語言版本：

語言	說明	狀態
English	English documentation	🔄 進行中
简体中文	简体中文文档	📋 規劃中
日本語	日本語ドキュメント	📋 規劃中

📝 想幫忙翻譯？ 請參閱 翻譯指南

---

💡 找不到您需要的資訊？ 歡迎到 GitHub Discussions 發問！