docs: README 重構 + i18n UI 規範 + 文件連結整理

README 改動:
- 新增 Docker Run 快速啟動區塊
- 重新編排為 10 個標準區塊
- 加入作業系統資料夾提醒表格
- 精簡進階設定為連結列表
- 減少 emoji 使用

docs 改動:
- i18n.md 新增語言選擇器 UI 規範
- getting-started.md 去重並加入返回連結
- 標題與連結一致化
This commit is contained in:
Your Name 2026-01-20 17:00:21 +08:00
parent bf8784ed82
commit 1a8548ff66
3 changed files with 133 additions and 57 deletions

View file

@ -1,5 +1,9 @@
# 快速開始
> 本文件提供完整部署步驟。若只需最快啟動,請參考 [README](../README.md)。
---
## 系統需求
| 需求 | 最低 | 建議 |
@ -11,26 +15,28 @@
---
## 事前準備(可選)
## 事前準備
如果您想預先建立資料夾結構
建立資料夾(重要)
```bash
mkdir -p data
mkdir -p ~/convertx-cn/data && cd ~/convertx-cn
```
> 💡 Docker 會自動建立 `data` 資料夾,此步驟為可選
> `data` 資料夾是主機上的實體資料夾,用於存放上傳檔案與轉換結果。
---
## 最快方式:一行指令
## 最快方式:Docker Run
```bash
docker run -d \
--name convertx-cn \
--restart unless-stopped \
-p 3000:3000 \
-v ./data:/app/data \
-e TZ=Asia/Taipei \
-e JWT_SECRET=你的隨機字串至少32字元 \
convertx/convertx-cn:latest
```
@ -40,8 +46,6 @@ docker run -d \
2. 輸入 Email 和密碼
3. 完成!開始使用
> ✅ **預設開放註冊**,無需設定環境變數
---
## 推薦方式Docker Compose

View file

@ -213,6 +213,34 @@ bun run dev
---
## 語言選擇器 UI 規範
為確保語言切換體驗一致ConvertX-CN 的語言選擇器遵循以下規範:
### 視覺設計
| 項目 | 規範 |
| ------------ | ----------------------------- |
| 圖示大小 | 與旁邊文字高度一致h-6 w-6 |
| 下拉選單背景 | 完全不透明bg-neutral-800 |
| 捲動條 | 明確可見的 scrollbar 樣式 |
| 最大高度 | 320px超過則顯示捲動條 |
### 行為規範
- Setup / Login / 主頁使用同一套語言選擇器組件
- 語言切換後自動重新載入頁面
- 語言偏好儲存於 Cookie跨頁面保持一致
- 預設根據瀏覽器語言自動偵測
### 已知問題修復v0.1.9
- 語言圖示尺寸過小 → 已修復
- 下拉選單半透明 → 已修復
- 捲動條不明顯 → 已新增 scrollbar 樣式
---
## 翻譯 Fallback
如果某個翻譯鍵缺失,系統會: