|
2 | 2 |
|
3 | 3 | Some frequently asked questions. |
4 | 4 |
|
| 5 | +## How to import table |
| 6 | + |
| 7 | +[fcitx5-android#175](https://github.com/fcitx5-android/fcitx5-android/pull/175) adds the support of importing table based input method, so after `0.0.3-43`, you can import table using following steps: |
| 8 | + |
| 9 | +1. Obtain the configuration file of the input method (the filename extension should be `.conf` or `.conf.in`) and table dictionary (the filename extension should be `.dict` or `.txt`) to be imported. Take "zhengma" as an example, you can download `zhengma.conf.in` and `zhengma.txt` at [fcitx/fcitx5-table-extra](https://github.com/fcitx/fcitx5-table-extra). |
| 10 | +2. Open the App, navigate to Addons → Table (click the gear button on the right) → Manage Table Input Methods, and click the plus button in the lower right corner. Select the second term, i.e. "From separate files", in the dialog that pops up. |
| 11 | +3. In the new dialog, click "Input method configuration file" and select `zhengma.conf.in` obtained in step 1; click "Table dictionary" and select `zhengma.txt` obtained in step 1; and click OK button. |
| 12 | +4. A notification of "Importing zheng,a.conf.in" should be created by the App. If the file are correct, the operation may take a few seconds. Then, you will see "Zhengma" in the list. |
| 13 | + |
5 | 14 | ## How to import table manually |
6 | 15 |
|
7 | | -Take importing [zhengma](https://github.com/fcitx/fcitx5-table-extra) as an example: |
| 16 | +In order to import a table manually, you need to have a correct input method configuration file `.conf` and convert the table dictionary in `.txt` form into `.dict` form using `libime_tabledict` command line tool. |
| 17 | + |
8 | 18 |
|
9 | | -1. Obtain `zhengma.conf` and `zhengma.dict` |
10 | | -2. Copy `zhengma.dict` to `/Android/data/org.fcitx.fcitx5.android/files/data/table/` |
11 | | -3. In `zhengma.conf`, change the path specified after `[Table] File=` to `table/zhengma.dict` |
12 | | -4. Copy modified `zhengma.conf` to `/Android/data/org.fcitx.fcitx5.android/files/data/inputmethod/` |
| 19 | +1. Obtain the configuration file of the input method (the filename extension should be `.conf` or `.conf.in`) and table dictionary (the filename extension should be `.dict` or `.txt`) to be imported. Take "zhengma" as an example, you can download `zhengma.conf.in` and `zhengma.txt` at [fcitx/fcitx5-table-extra](https://github.com/fcitx/fcitx5-table-extra). |
| 20 | +2. Open `zhengma.conf.in` with your favorite editor and modify the path specified after `[Table] File=` to `table/zhengma.dict`. |
| 21 | +3. Run command `libime_tabledict zhengma.txt zhengma.dict` to convert the table dictionary. This tool is usually provided by package called `libime` or `libime-bin` among Linux distributions. |
| 22 | +4. Copy modified `zhengma.conf` in step 2 to `/sdcard/Android/data/org.fcitx.fcitx5.android/files/data/inputmethod/`. |
| 23 | +5. Copy converted `zhengma.dict` in step 3 to `/sdcard/Android/data/org.fcitx.fcitx5.android/files/data/table/`. |
| 24 | +6. Restart the App (remove the task or just use force stop) |
13 | 25 |
|
14 | 26 | !!! warning |
15 | 27 |
|
16 | 28 | Above absolute paths may not apply if you configured [work profile](https://developer.android.com/work/versions/android-11#work). |
17 | 29 | We recommend using the builtin file manager (via DocumentsUI) to manage the data of Fcitx5 for Android. |
| 30 | + You can access the files in `/sdcard/Android/data/org.fcitx.fcitx5.android/files/` by selecting "Fcitx 5 for Android" in the sidebar of DocumentsUI. No third-party file manager/adb/root permission are required. |
18 | 31 |
|
19 | 32 | !!! note |
20 | 33 |
|
21 | | - Create directories if they don't exist. |
| 34 | + Create `inputmethod` and `table` if they don't exist. |
22 | 35 |
|
23 | 36 | ## How to remove input method entry |
24 | 37 |
|
25 | 38 | Swipe left on the entry until the backgournd changes to red with a trash can icon. |
26 | 39 |
|
| 40 | +[fcitx5-android#170](https://github.com/fcitx5-android/fcitx5-android/pull/170) adds multi-selecting deletion, so after `0.0.3-37`, |
| 41 | +you can click the edit (pencil) button in top right corner of the input method list to enter the multi-selecting mode, |
| 42 | +where checkbox will appear in the front of the input method name. You can check the input methods to be deleted, |
| 43 | +and click the delete (trash can) button in the top right corner. |
| 44 | + |
27 | 45 | !!! hint |
28 | 46 |
|
29 | 47 | The same operation applies to other list-like UI, such as pinyin dictionary, punctuation mapping, etc. |
@@ -57,9 +75,9 @@ The input history and user dinctionary for Pinyin/Shuangpin are at `data/pinyin/ |
57 | 75 |
|
58 | 76 | !!! warning |
59 | 77 |
|
60 | | - Abosolute path above may not apply if you configured [work profile](https://developer.android.com/work/versions/android-11#work). |
| 78 | + Above absolute paths may not apply if you configured [work profile](https://developer.android.com/work/versions/android-11#work). |
61 | 79 | We recommend using the builtin file manager (via DocumentsUI) to manage the data of Fcitx5 for Android. |
62 | | - |
| 80 | + You can access the files in `/sdcard/Android/data/org.fcitx.fcitx5.android/files/` by selecting "Fcitx 5 for Android" in the sidebar of DocumentsUI. No third-party file manager/adb/root permission are required. |
63 | 81 |
|
64 | 82 | ## How to import Pinyin dictionary |
65 | 83 |
|
|
0 commit comments