docs: README 重構 + i18n UI 規範 + 文件連結整理
README 改動: - 新增 Docker Run 快速啟動區塊 - 重新編排為 10 個標準區塊 - 加入作業系統資料夾提醒表格 - 精簡進階設定為連結列表 - 減少 emoji 使用 docs 改動: - i18n.md 新增語言選擇器 UI 規範 - getting-started.md 去重並加入返回連結 - 標題與連結一致化
This commit is contained in:
parent
bf8784ed82
commit
1a8548ff66
3 changed files with 133 additions and 57 deletions
|
|
@ -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
|
||||
|
|
|
|||
28
docs/i18n.md
28
docs/i18n.md
|
|
@ -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
|
||||
|
||||
如果某個翻譯鍵缺失,系統會:
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue