Reflow the document

This commit is contained in:
Tom Willemse 2020-05-07 18:34:38 -07:00
parent 64929e58ef
commit 50286406e7

View file

@ -3,40 +3,36 @@
* Introduction * Introduction
I've been using [[http://colemak.com][colemak]] for quite a while now and I really like it. I've been using [[http://colemak.com][colemak]] for quite a while now and I really like it. The fact
The fact that basically only the letters change position (aside from that basically only the letters change position (aside from ~;~ and ~:~) really
~;~ and ~:~) really makes learning it easier than some alternatives makes learning it easier than some alternatives would.
would.
I came across [[http://www.kaufmann.no/roland/dvorak/index.html][Programmer Dvorak]] a little while ago, and found the I came across [[http://www.kaufmann.no/roland/dvorak/index.html][Programmer Dvorak]] a little while ago, and found the idea of
idea of having symbols on the keyboard without needing the Shift key having symbols on the keyboard without needing the Shift key very enticing. It
very enticing. It made me think real hard about maybe learning made me think real hard about maybe learning Dvorak after all, even though I'd
Dvorak after all, even though I'd previously chosen colemak previously chosen colemak *because* it didn't change the places of any symbols
*because* it didn't change the places of any symbols and such. and such.
I decided against it, though. I've invested quite a few hours I decided against it, though. I've invested quite a few hours getting
getting proficient with colemak, and I'd hate for that to have been proficient with colemak, and I'd hate for that to have been in vain. So I
in vain. So I decided to try and change colemak's symbol positions, decided to try and change colemak's symbol positions, or some of them anyway.
or some of them anyway.
I didn't change the order of the number keys, though Shift is now I didn't change the order of the number keys, though Shift is now required to
required to use them, because I didn't like the idea. These numbers use them, because I didn't like the idea. These numbers have been ingrained
have been ingrained into my brain since the beginning of time, or into my brain since the beginning of time, or at least ever since I first sat
at least ever since I first sat behind a PC. Reading the Programmer behind a PC. Reading the Programmer Dvorak page makes me believe that there is
Dvorak page makes me believe that there is good reason to change good reason to change their order, but I thought that any benefits gained
their order, but I thought that any benefits gained would not would not outweigh the benefit of blindly knowing where they are. However, it
outweigh the benefit of blindly knowing where they are. However, it is of course possible that this may change in the future, since I also thought
is of course possible that this may change in the future, since I something similar when I first switched to colemak, but then about symbol keys
also thought something similar when I first switched to colemak, but in general.
then about symbol keys in general.
I also didn't shift the number keys one place to the right, as I also didn't shift the number keys one place to the right, as Programmer
Programmer Dvorak does. This is because even though I'm sure that Dvorak does. This is because even though I'm sure that that would work very
that would work very well on a standard keyboard layout, it would well on a standard keyboard layout, it would ruin the symmetric properties of
ruin the symmetric properties of my [[https://www.trulyergonomic.com/store/index.php][Truly Ergonomic Keyboard]]. Right my [[https://www.trulyergonomic.com/store/index.php][Truly Ergonomic Keyboard]]. Right now the ~(~ and ~)~ are both placed directly
now the ~(~ and ~)~ are both placed directly above my index fingers, above my index fingers, and since I spend quite a bit of my free time writing
and since I spend quite a bit of my free time writing various forms various forms of Lisp code that is extra cool.
of Lisp code that is extra cool.
#+CAPTION: Ryuk on a Truly Ergonomic Keyboard #+CAPTION: Ryuk on a Truly Ergonomic Keyboard
#+ATTR_HTML: :align center #+ATTR_HTML: :align center
@ -54,11 +50,11 @@
*** X11 *** X11
To install and use the X11 keyboard, copy the ~xkb/ryuk~ file to where To install and use the X11 keyboard, copy the ~xkb/ryuk~ file to where XKB
XKB looks for these files. In my case this is looks for these files. In my case this is ~/usr/share/X11/xkb/symbols~. Once
~/usr/share/X11/xkb/symbols~. Once put in the proper place, next to, put in the proper place, next to, for example, ~us~, set your =XkbVariant= to
for example, ~us~, set your =XkbVariant= to ~ryuk~. For example, I have in ~ryuk~. For example, I have in my ~/etc/X11/xorg.conf.d/10-evdev.conf~ file the
my ~/etc/X11/xorg.conf.d/10-evdev.conf~ file the following: following:
#+BEGIN_SRC conf #+BEGIN_SRC conf
# ... # ...
@ -74,29 +70,27 @@
# ... # ...
#+END_SRC #+END_SRC
Since your distribution may have Xorg configured differently, you Since your distribution may have Xorg configured differently, you may have
may have to specify it in a different file or a different section, to specify it in a different file or a different section, but please note
but please note that only the line starting with ~Option~ was put that only the line starting with ~Option~ was put there by me.
there by me.
*** TTY *** TTY
To install the TTY keyboard layout you should gzip the To install the TTY keyboard layout you should gzip the ~kbd/ryuk.map~ file,
~kbd/ryuk.map~ file, which can be achieved by running ~make~ from the which can be achieved by running ~make~ from the ~kbd~ map, and put the
~kbd~ map, and put the resulting file where the kbd utilities can find resulting file where the kbd utilities can find them. In my case this is
them. In my case this is ~/usr/share/kbd/keymaps/i386/colemak/~, and I ~/usr/share/kbd/keymaps/i386/colemak/~, and I choose the ~colemak~ directory
choose the ~colemak~ directory because the ~ryuk~ files are based because the ~ryuk~ files are based directly off the colemak files.
directly off the colemak files.
Once put in the proper place you should specify that the TTY should Once put in the proper place you should specify that the TTY should use your
use your keymap by putting the following in your ~/etc/vconsole.conf~: keymap by putting the following in your ~/etc/vconsole.conf~:
#+BEGIN_SRC sh #+BEGIN_SRC sh
KEYMAP=ryuk KEYMAP=ryuk
#+END_SRC #+END_SRC
This should work at least on systems that use systemd. I don't know This should work at least on systems that use systemd. I don't know how
how other init systems set it. other init systems set it.
** Windows ** Windows