code: fqa.9front.org

Download patch

ref: a38a66472d5dac17f9d1458d582b7eb2343a43b1
parent: d81c8d9115ece8624804901b602e3ddb80a52fa1
author: sl <sl@9front>
date: Thu Aug 17 23:15:33 EDT 2023

fqa.ms, fqa8.ms: add 8.14 - Keyboard Input (thanks, moody)

--- a/fqa.ms
+++ b/fqa.ms
@@ -1547,6 +1547,26 @@
 8.13.2 - camv
 .ihtml a
 
+.ihtml a <a href="fqa8.html#8.14">
+8.14 - Keyboard Input
+.ihtml a
+
+.ihtml a <a href="fqa8.html#8.14.1">
+8.14.1 - Keyboard Maps
+.ihtml a
+
+.ihtml a <a href="fqa8.html#8.14.2">
+8.14.2 - Ktrans
+.ihtml a
+
+.ihtml a <a href="fqa8.html#8.14.2.1">
+8.14.2.1 - Japanese
+.ihtml a
+
+.ihtml a <a href="fqa8.html#8.14.2.2">
+8.14.2.2 - Chinese Pinyin
+.ihtml a
+
 .ihtml h1 <h1>
 .SH
 9 - Troubleshooting
--- a/fqa8.ms
+++ b/fqa8.ms
@@ -439,20 +439,20 @@
 .R
 .ihtml h3
 
-Part of 9front's bold initiative for modernizing Plan 9's interface (demo day!) while still retaining all of the bits that really annoy people is to implement a keyboard\-controller overlay that provides configurable keyboard shortcuts without actually altering
+Part of 9front's bold initiative for modernizing Plan 9's interface (demo day!) while still retaining all of the bits and bobs that really annoy people (no icons! no buttons! no banners!) is to implement a keyboard\-controller overlay that provides configurable keyboard shortcuts without actually altering
 .CW rio
-itself, representing a negotiated ceasefire somewhere on the spectrum between touching the artwork, Joker\-style, and creating a brand new GUI from scratch. One of the features provided by
+itself, thereby representing a negotiated ceasefire somewhere on the spectrum between touching the artwork, Joker\-style, and creating a brand new GUI from scratch. One of the features provided by
 .CW riow
-is virtual desktops + the ability to navigate through them using only the keyboard, which, to my mind, goes some way towards satisfying the bounty for a
+is the ability to navigate through virtual desktops using only the keyboard, which, to my mind, goes some way towards satisfying the bounty for a
 .CW dwm/i3/sway
 -like
 .CW rio
-replacement.
+replacement. Somebody pay Sigrid.
 
 Read:
 .ihtml a <a href="http://9front.org/1/riow">
 .CW
-rio(1),
+riow(1),
 .R
 .ihtml a
 .I
@@ -2786,6 +2786,85 @@
 .ihtml a <a href="http://man.9front.org/1/camv">
 .CW camv(1),
 .ihtml a
+
+.html - <a name="8.14" />
+.ihtml h2 <h2>
+.SH
+8.14 - Keyboard Input
+.R
+.ihtml h2
+
+.html - <a name="8.14.1" />
+.ihtml h3 <h3>
+.SH
+8.14.1 - Keyboard Maps
+.R
+.ihtml h3
+
+By default, a us keyboard layout is used.
+The system provides many other layouts in
+.CW /sys/lib/kbmap/ .
+To switch between them, a user may write the map
+to the
+.CW /dev/kbmap
+file presented by
+.ihtml a <a href="http://man.9front.org/8/kbdfs">
+.CW kbdfs (8).
+.ihtml a
+.P1
+cat /sys/lib/kbmap/colemak > /dev/kbmap
+.P2
+
+A graphical application,
+.ihtml a <a href="http://man.9front.org/1/kbmap">
+.CW kbmap (1),
+.ihtml a
+is also given to provide a graphical menu in which a user may
+click between the various keyboard maps provided.
+
+.html - <a name="8.14.2" />
+.ihtml h3 <h3>
+.SH
+8.14.2 - Ktrans
+.R
+.ihtml h3
+
+Ktrans is used for language specific input, supporting
+Japanese, Chinese (Wubizixing and Pinyin dictionaries provided),
+Korean Dubeolsik, and Vietnamese Telex input methods. Specific
+usage details may be found in
+.ihtml a <a href="http://man.9front.org/1/ktrans">
+.CW ktrans (1),
+.ihtml a
+and dictionary information may be found in
+.ihtml a <a href="http://man.9front.org/6/ktrans">
+.CW ktrans (6).
+.ihtml a
+
+.html - <a name="8.14.2.1" />
+.ihtml h4 <h3>
+.SH
+8.14.2.1 - Japanese
+.R
+.ihtml h4
+
+.P1
+cat /sys/lib/kbmap/jp > /dev/kbmap
+jisho=/lib/ktrans/kanji.dict #default
+ktrans -l jp /dev/kbdtap
+.P2
+
+.html - <a name="8.14.2.2" />
+.ihtml h4 <h3>
+.SH
+8.14.2.2 - Chinese Pinyin
+.R
+.ihtml h4
+
+.P1
+zidian=/lib/ktrans/pinyin.dict
+ktrans -l zh /dev/kbdtap
+.P2
 
 .html - <hr />
 .html - <a href="fqa.html">FQA INDEX</a> |