# 拍台文快速上手小卡

這張小卡給第一次安裝、第一次打台文的人。先照這張打得出來，再看[完整使用說明](user-guide.md)。

---

## 先裝起來

一般使用者：Windows 下載安裝包；macOS／Linux 用指令。

| 系統 | 安裝拍台文 | 需要先有 |
|------|------------|----------|
| Windows | 下載 `PhahTaiBunSetup.exe`，雙擊安裝 | 小狼毫 Weasel |
| macOS | `curl -fsSL https://raw.githubusercontent.com/soanseng/rime-phah-taibun/main/scripts/install_macos.sh \| bash` | 鼠鬚管 Squirrel |
| Linux | `git clone https://github.com/soanseng/rime-phah-taibun.git && cd rime-phah-taibun && ./install.sh` | fcitx5-rime 或 ibus-rime |
| Android | 下載 Releases 的 `PhahTaiBun-Trime.zip`（拍台文＋注音；要嘸蝦米改抓 `PhahTaiBun-Trime-liur.zip`）解壓到 Rime 使用者資料夾後重新部署，見[Android 部署](android.md) | 同文 Trime，或小企鵝 + RIME 外掛 |

裝好後先把系統輸入法切到小狼毫（Windows，圖示【中】）或鼠鬚管（macOS，圖示【ㄓ】），重新部署 Rime，再按 `F4` 或 `` Ctrl+` `` 選「拍台文(台)」；熟台羅想用調鍵連續輸入的人可改選「拍台文(Telex)」。`F4` 不是系統輸入法切換鍵；還沒進入小狼毫／鼠鬚管時按了不會有反應。詳見[使用說明的安裝完成步驟](user-guide.md#一般使用者windows-安裝包macos-指令)。

進階使用者也可以用指令安裝：macOS 執行 `curl -fsSL https://raw.githubusercontent.com/soanseng/rime-phah-taibun/main/scripts/install_macos.sh | bash`；Windows PowerShell 執行 `irm https://raw.githubusercontent.com/soanseng/rime-phah-taibun/main/install_windows.ps1 | iex`。Windows 這行指令是互動式的：可選裝拍台文、嘸蝦米（`rime-liur`）或兩者；改設定前會先做時間戳備份，並詢問要保留哪些既有輸入法（含注音）。

## 更新拍台文

Windows 到 [Releases](https://github.com/soanseng/rime-phah-taibun/releases) 下載最新版 `PhahTaiBunSetup.exe` 覆蓋安裝。macOS 重跑 `curl .../scripts/install_macos.sh | bash`，或 clone 裡 `git pull --ff-only && ./install.sh`。Linux 在既有 clone 執行 `git pull --ff-only && ./install.sh`。Android 用最新 `PhahTaiBun-Trime.zip` 覆蓋後重新部署，步驟見[Android 部署](android.md)。自訂詞庫和其他 Rime 方案會保留；詳見[完整更新說明](user-guide.md#更新拍台文)。

---


## 第一分鐘：直接打

| 想打 | 輸入 | 會看到 |
|------|------|--------|
| 我 beh 去 tshit-thô | `gua beh khi tshit tho` | 我 beh 去 tshit-thô |
| 食飯 | `tsiah png` | 食飯 |
| 食飯 | `chiah png` | 食飯 |
| 台灣 / 臺灣 | `tai uan` | 臺灣、台灣 |
| 好 | `ho` 或 `ho2` | 好 |
| 橋鼎（字典沒有的詞） | `kio` `Tab` `d`，再 `tiann` `Tab` `d` | 橋鼎（逐音節選字） |

不用先背聲調。想縮小候選範圍時，再補數字調：`ho2`、`tsiah8 png7`。調號口訣：**君滾棍骨、群郡滑**＝1 2 3 4、5 7 8（台灣通行腔沒有獨立第 6 調）。

### 拍台文(Telex)：字母列補調（可選）

`F4` 選 **「拍台文(Telex)」**。主方案「拍台文(台)」不變；兩個方案詞典、輸出相同。

| 你打 | 等於 | 調／用途 |
|------|------|----------|
| `v` | 2 或 8 | 舒聲 2；音節收 `-p/-t/-k/-h` 時為入聲 8 |
| `y` | 3 | 第 3 調 |
| `d` | 5 | 第 5 調 |
| `w` | 7 | 第 7 調 |
| `q` | 9 | 第 9 調 |
| （不打） | 1／4 | 陰平／陰入，沿用省略 |
| `z` / `zh` | `ts` / `tsh` | 聲母少一鍵 |
| `f` | `-` | 音節連字符 |

記法一（位置）：**五在家 `d`、二八勾 `v`、三叉右 `y`、七在外 `w`、九像 Q。**
記法二（字形／字母）：`q` 像 9；`y` 三叉＝3；`v` 一分為二＝2，入聲同一鍵＝8；`d`＝第／D＝5；剩下 `w`＝7。不要把羅馬數字 V 當成 5。

| 想打 | 輸入 | 會看到 |
|------|------|--------|
| 臺／台 | `taid` | 臺、台 [tâi] |
| 臺語 | `taidfgiv` 或 `taid-giv` | 臺語 [tâi-gí] |
| 食 | `ziahv` 或 `tsiahv` | 食 [tsia̍h] |
| 斜 | `zhiahv` | 斜 [tshia̍h] |
| 食飯 | `ziahv pngw` | 食飯 |

數字調在 Telex 方案同樣有效：`tai5` ≡ `taid`。第 1／4 調不必按。歷史與鍵位理由見[完整使用說明](user-guide.md#進階拍台文telex-調鍵輸入)。

---

## 拼音規則：TL / POJ 都會通

| 差異 | TL 鍵盤輸入 | POJ 鍵盤輸入 | 正式輸出（TL / POJ） |
|------|-------------|--------------|-----------------------|
| 聲母 | `ts` | `ch` | `tsia̍h` / `chia̍h` |
| 送氣聲母 | `tsh` | `chh` | `tshut` / `chhut` |
| 韻母 | `ing` | `eng` | `ping` / `peng` |
| 韻母 | `ik` | `ek` | `sik` / `sek` |
| 元音 | `ua` | `oa` | `guá` / `góa` |
| 元音 | `ue` | `oe` | `uē` / `oē` |
| 元音 | `oo` | `ou` | `oo` / `o͘` |
| 鼻化音 | `nn` | `nn` | `ann` / `aⁿ` |

鍵盤輸入使用 ASCII：POJ 的點右音 `o͘` 請打 `ou`，上標鼻音 `ⁿ` 請打 `nn`；正式輸出仍會顯示 `o͘`、`ⁿ`。

可以混打，例如 `goa beh khi` 一樣能找到「我 beh 去」。

連字符可以直接打：`tsng-kio5` 會保留音節連字符，`kio3--i` 會保留輕聲標記 `--`。

---

## 常用按鍵

| 按鍵 | 用途 |
|------|------|
| `Space` | 確認目前候選 |
| `Tab` | 有候選時進入 asdf 選字；打拼音時跳下一音節 |
| `a s d f g h j k l ;` | Tab 選字模式中的第 1-10 候選 |
| `F4` / `` Ctrl+` `` | 開 Rime 方案選單：拍台文(台)／拍台文(Telex)，漢羅/全羅、TL/POJ（選過就會記住） |
| `Ctrl+Space` | 台文/英文模式 |
| `Shift+字母` | 打大寫字母，不切英文模式 |
| `~` | 注音反查華語，再轉台語候選 |
| `?` | 萬用查字，例如 `?iah` |
| `` ` `` | 台羅調號、POJ 特殊字母、台文標點 |
| `[` / `]` | 取候選詞首字/尾字 |
| `\` | 目前候選改用另一種輸出形式 |
| `Enter` | 全羅模式下照目前輸入音直接送出 |
| `vvh` | 在候選區顯示按鍵說明 |
| `vvjit` | 台語日期 |
| `vvsp` | 簡拼對照 |

> 拍台文的數字鍵專心用來打聲調；選字請按 `Tab` 後用 `asdfghjkl;`。這和教育部輸入法以數字選字的習慣不同。

---

## 好用情境

### 不知道台語怎麼講

按 `~` 進入注音反查：

```text
~ㄔ → 選「吃」→ 回到台語候選「食」
```

### 忘記聲母

用 `?` 查音節：

```text
?iah → 選 tsiah → 食、炸、即、脊...
```

### 想選單字

先打詞，再用 `[` / `]` 取字：

```text
tsiah png → 食飯
按 [ → 食
按 ] → 飯
```

---

## 出問題先看這裡

| 狀況 | 先檢查 |
|------|--------|
| 找不到「拍台文(台)」／「拍台文(Telex)」／按 F4 沒反應 | 先確認系統輸入法是小狼毫或鼠鬚管，重新部署，再按 `F4` 或 `` Ctrl+` `` |
| 沒有拼音註解 | 確認 `lua/phah_taibun_*.lua` 已安裝到 Rime 使用者資料夾 |
| `~` 注音反查沒反應 | 確認有 `bopomofo_tw` 方案 |
| emoji / 英文候選沒有出現 | 未內建這兩類候選；英文請按 `Ctrl+Space`，常用 emoji 可加到 `custom_phrase` |

完整排錯看[使用說明的疑難排解](user-guide.md#十七疑難排解)。