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
2.5 KiB
2.5 KiB
本地開發
本文件說明如何在本地環境進行 ConvertX-CN 開發。
環境需求
- Node.js 20+ 或 Bun 1.0+
- Docker（用於測試）
- Git
可選
- Rust 1.75+（開發 API Server）
- 轉換工具（FFmpeg、ImageMagick 等）
快速開始
1. Clone 專案
git clone https://github.com/pi-docket/ConvertX-CN.git
cd ConvertX-CN
2. 安裝依賴
# 使用 Bun（推薦）
bun install
# 或使用 npm
npm install
3. 啟動開發伺服器
bun run dev
開啟 http://localhost:3000
開發工具
程式碼格式化
# Prettier
bun run format
# ESLint
bun run lint
類型檢查
bun run typecheck
建構
bun run build
目錄說明
| 目錄 | 說明 |
|---|---|
src/ |
前端原始碼 |
public/ |
靜態資源 |
api-server/ |
API Server |
tests/ |
測試檔案 |
docs/ |
文件 |
scripts/ |
腳本 |
常見開發任務
新增轉換器
- 在
src/converters/建立新檔案 - 定義輸入/輸出格式
- 在
src/converters/main.ts註冊
// src/converters/myconverter.ts
export const myConverter: Converter = {
id: "myconverter",
name: "My Converter",
inputFormats: ["abc", "xyz"],
outputFormats: ["pdf", "txt"],
convert: async (input, output, format) => {
// 轉換邏輯
},
};
新增翻譯
- 在
src/locales/新增或修改翻譯檔 - 在
src/i18n/index.ts註冊（如果是新語言）
// src/locales/xx.json
{
"title": "ConvertX-CN",
"upload": "上傳",
...
}
修改樣式
TailwindCSS 設定在 tailwind.config.js。
# 重新生成 CSS
bun run build:css
API Server 開發
環境設定
cd api-server
建構
cargo build
執行
cargo run
測試
cargo test
Docker 開發
建構本地映像
docker build -t convertx-cn-dev .
使用本地映像
# docker-compose.yml
services:
convertx:
image: convertx-cn-dev
# ...
偵錯
前端偵錯
使用瀏覽器開發者工具（F12）。
後端偵錯
# 詳細日誌
DEBUG=* bun run dev
API Server 偵錯
RUST_LOG=debug cargo run