diff --git a/Chinese-keyboard.md b/Chinese-keyboard.md new file mode 100644 index 0000000..2e6ecd5 --- /dev/null +++ b/Chinese-keyboard.md @@ -0,0 +1,40 @@ +Chinese version: [笔画输入法](https://github.com/koreader/koreader/wiki/笔画输入法) + +Starting from version 2022-10 (to be released), KOReader integrates the Chinese stroke keyboard for inputting simplified and traditional Chinese characters. + +### Choosing keyboard +Long press the global key on other keyboard or choose 中文(zh) from Settings->Device->Keyboard->Keyboard layouts then single tap the global key to switch to Chinese keyboard. + +### Input method +The stroke input method groups character strokes into five categories. Then any character is typed by its stroke order. +| Key | Stroke type | +| ------ | ------ | +| `一` | Horizontal or rising stroke | +| `丨` | Vertical or vertical with hook | +| `丿` | Falling left | +| `丶` | Dot or falling right | +| `𠃋` | Turning | + +For example, to input 大, keys `一丿丶` are used. + +Note all turning strokes are input with a single `𠃋` key as long as they are written in one go. So 马 is input with `𠃋𠃋一`. + +After getting the intended character, a `分隔`(Separate) or `空格`(Space) key should be used to finish the input. Otherwise, strokes of the next character will be appended to that of the current one thus changing the character. + +Besides, the keyboard layout contains a wildcard key `*` to use in place of any uncertain stroke. + +Swipe north on the `分隔`(Separate) key for quick deletion of unfinished strokes. + +### Character candidates +When two or more characters share the same stroke composition, the `下一字`(Next character) key is used to iterate them. + +The character 〇 is input by key `𠃋` + `下一字`. + +To turn off showing candidates in the input box, go to Settings->Device->Keyboard->Layout-specific keyboard settings. the `下一字`(Next character) key is still used to change character when candidates exist. + +### Punctuation marks +Commonly used punctuation marks can be input from the `,` and `。` keys. Long press on them to reveal more marks. Swipe to specific directions on them to input corresponding marks. + +Mark "、" is input by swiping north the `丶` key, mark "——" the `一` key. + +More marks can be input from the number pad by tapping `123` key or by switching to other keyboards. \ No newline at end of file