path: root/keyboards/thevankeyboards/minivan/keymaps/josjoha/readme.md

# Minivan keyboard layout _Minifan_
A 40% keyboard made first by TheVan Keyboards
_https://thevankeyboards.com_ now taken over by TKC
_https://thekey.company_

![Minivan layout all](http://socialism.nl/misc/minivan/minivan-all-layers-visualization_vc.jpg)

Table of Contents
=================

      1  Overview
          1.1 Hardware compatibility
          1.2 Software compatibility
      2  'make' example
      3  Base layouts
          3.1  Normal layouts
                3.1.1 Qwerty
                3.1.2 Qwerty with arrows on Base
                3.1.3 Dvorak
                3.1.4 Dvorak² 
                3.1.5 Colemak
                3.1.6 Workman
          3.2 Special layouts
                3.2.1 Numbers pad
      4 The common system
          4.1 Layer access
          4.2 Layout in graphics
          4.3 Layout in text
          4.4 Movement layer options
          4.5 Numbers pad layer options
      5 Led colors for layers
      6 Compile options
      7 Language support
          7.1 Input methods
          7.2 Unicode symbols
      8 Speed measuring
          8.1 Speed Led color compilation assist
      9 Text size measuring
          9.1 Text size Usage
     10 Making your own base layer(s)
     11 Evisceration
     12 Key associations
          12.1 Compared to regular keyboard
     13 Trouble shooting
        • Compiling
        • Unicode
        • Leds
        • Weird layer jumping
        • Difficult/impossible key combinations ?
     14 Why you want this layout
     15 BUGS
     16 Resources
     17 Author(s)

1 Overview
==========

☑ _Intuitive:_ Key placement follows what a 10 finger typist is used
  to on a regular keyboard. Similar keys meanings are on the same
  key in different layers, or the same finger, etc. See also chapter
  12, _Key associations._ Thumbs control the most used layer access.

☑ _Feature rich:_ Dual layout, with several standard layouts to choose
  from. Expanded character set. Measure typing speed and/or amount of text
  typed. Mouse control, media control, power control, Unicode encoding for
  several platforms. In total there are about 4 times as many key functions
  than on a regular keyboard.

☑ _Configurable:_ Choose between standard layouts (Qwerty, Dvorak, etc);
  additional hardware keys ‛command/south-paw’ and/or ‛arrow’; movement
  layer WASD or flat arrows/mouse; numbers pad similar to regular numbers
  and/or like a regular numbers pad; and other settings. Easy to add your
  own layers. See ![./user_config.h](./user_config.h)

☒ What it does *not* do: work on a computer set to a non-English language,
  such as German or French. (To add such functionality requires some work,
  but it seems it should be possible. See ![./todo.md](./todo.md).)

![Minivan illustration Overview layers](http://socialism.nl/misc/minivan/minivan-all-layers-clear-visualization_1500_vg.jpg)

By key view:

![Minivan illustration Overview layers by key](http://socialism.nl/misc/minivan/minivan-all-layers-clear-visualization-by-key_2000_vi.jpg)

1.1 Hardware compatibility
==========================
This keymap functions on _Minivan_ hardware variants with 44, 45 and
46 keys.

It may be fairly easily ported to 12x12x12x[11|12|13] keyboards.

1.2 Software compatibility
==========================
This keymap relies on Unicode, in an attempt to avoid the 
“dead key” system for accented characters on many non-English keyboards.
You need to have Unicode input working on your computer.

On a Linux computer operating system, this keymap is designed to work
with this keyboard/language setting:

        > setxkbmap -layout us
        > echo $LANG
        `en_US.UTF-8`

If that works for you, you can type the most important characters in
the western European group of languages, native from the keyboard.

This keymap might not function as expected if you want to use a
different keyboard language setting in your operating system.

See also chapter 6 _Language support_.

2 'make' example
================
     … Download the repository, resolve software dependencies etc..
     … To change compile options: edit ./user_config.h (or `./minifan_config_compact.h`)
     > cd […]/qmk_firmware
     > make thevankeyboards/minivan:josjoha
     > su
     # dfu-programmer atmega32u4 erase
     # dfu-programmer atmega32u4 flash thevankeyboards_minivan_josjoha.hex
     # dfu-programmer atmega32u4 start

This “Mini*fan*” layout is explained in several readme files, with
links to the others files in this readme. The common system is explained
in this readme.md file. The options for the letters and number/symbol
layer pairs (two pairs in the dual layout) are explained in their
separate readme file, see immediately below. Compile options are detailed
in ![./user_config.h](./user_config.h)

3 Base layouts
==============
Layouts are presented here in a sort of simplified key caps view.  If a
base layer pair has its own user configuration options, they are located
in `./base_NAME.h`.

3.1 Normal layouts
------------------
These are layouts for commonly used configurations, such as Qwerty or Dvorak.

3.1.1 Qwerty
------------

![Minivan layout impression](http://socialism.nl/misc/minivan/minivan_keycapview_qwerty_vc.jpg)

For the readme about the Qwerty version, see ➡ ![base_qwerty.md](./base_qwerty.md) ⬅

3.1.2 Qwerty with arrows on Base
--------------------------------

![Minivan layout impression](http://socialism.nl/misc/minivan/minivan_keycapview_qwerty_basearrow_ve.jpg)

For the readme about this Qwerty variation, see ➡ ![base_qwerty_basearrow.md](./base_qwerty_basearrow.md) ⬅

3.1.3 Dvorak
-------------

![Minivan layout impression](http://socialism.nl/misc/minivan/minivan_keycapview_dvorak_vc.jpg)

For the readme about the Dvorak version, see ➡ ![base_dvorak.md](./base_dvorak.md) ⬅

3.1.4 Dvorak² 
-------------

![Minivan layout impression](http://socialism.nl/misc/minivan/minivan_keycapview_dvorak_descramble_vb.jpg)

Regular Dvorak for a computer already set to Dvorak.

For the readme about the Dvorak² version, see ➡ ![base_dvorak_descramble.md](./base_dvorak_descramble.md) ⬅

3.1.5 Colemak
-------------

![Minivan layout impression](http://socialism.nl/misc/minivan/minivan_keycapview_colemak_vc.jpg)

For the readme about the Colemak version, see ➡ ![base_colemak.md](./base_colemak.md) ⬅

3.1.6 Workman
-------------

![Minivan layout impression](http://socialism.nl/misc/minivan/minivan_keycapview_workman_va.jpg)

For the readme about the Workman version, see ➡ ![base_workman.md](./base_workman.md) ⬅

3.2 Special layouts
===================
These are unusual layouts. Most people will probably only want one of these on the ‛Alternate’ layout,
with a normal layout on ‛Default’. How this works is explained below.

3.2.1 Numbers pad
-----------------

![Minivan layout impression](http://socialism.nl/misc/minivan/minivan_keycapview_numpad_single_va.jpg)

For the readme about the Numpad version, see ➡ ![base_numpad.md](./base_numpad.md) ⬅


4 The common system
===================

![Minivan layout impression](http://socialism.nl/misc/minivan/minivan_keycapview_common_vc.jpg)

4.1 Layer access
----------------
The graphic below shows how layers are reached from the ‛Default base’ layer.

This seems to be the place where one is supposed to say: “This is simple”. 
It may look more confusing than it is. If you write down an alphabet A,B, ➡ Z,
made arrows from every key on a keyboard picture to one of the letters, it could
look just as confusing. When switching to a layer, you only think about where you
want to go.

![Minivan layout Image associations](http://socialism.nl/misc/minivan/minivan-default-base-layer-activation_2000_vi.jpg)

Each of the two base layers comes with its own second layer, typically
numbers-symbols. The other layers are used common between the default and
alternate base layers.  You can switch between the default base layer
(typically letters), and another base layer, the alternate base layer
(also typically letters), on the `_RAR` layer with key ‛Other Base’.

                   Layer overview:                    Defined in:

        • Default Letters / Base                   ┓
        • Default Numbers-symbols                  ┃
                                                   ┣ ./base_….c/md files
              • Alternate Letters / Base           ┃
              • Alternate numbers-symbols layout   ┛

           • Numbers pad                           ┓
           • Accented characters                   ┃
           • Additional Unicode characters         ┃
           • More Additional Unicode characters    ┣ ./keymap.c(etc)/readme.md
           • Movement arrows/mouse                 ┃   “The common system”
           • Function keys / layer toggles         ┃
           • Power, media, Speed, Text size, etc.  ┛

4.2 Layout in graphics
----------------------

![Minivan layout Image BASEdef](http://socialism.nl/misc/minivan/minivan_base_layer_hide_def_base_ve.jpg)
Layer: `DEF_BASE`

![Minivan layout Image NSYdef](http://socialism.nl/misc/minivan/minivan_nsy_layer_hide_def_base_vc.jpg)
Layer: `DEF_NSY`

![Minivan layout Image BASEalt](http://socialism.nl/misc/minivan/minivan_base_layer_hide_alt_base_ve.jpg)
Layer: `ALT_BASE`

![Minivan layout Image NSYalt](http://socialism.nl/misc/minivan/minivan_nsy_layer_hide_alt_base_vc.jpg)
Layer: `ALT_NSY`

![Minivan layout Image PAD](http://socialism.nl/misc/minivan/minivan_pad_layer_vc.jpg)
Layer: `_PAD`

^ See below for a different configuration of the numbers pad keys. See above for a Base layout for a numbers pad.

![Minivan layout Image ACC](http://socialism.nl/misc/minivan/minivan_acc_layer_vd.jpg)
Layer: `_ACC`

![Minivan layout Image DRA](http://socialism.nl/misc/minivan/minivan_dra_layer_vd.jpg)
Layer: `_DRA`

![Minivan layout Image BON](http://socialism.nl/misc/minivan/minivan_bon_layer_vc.jpg)
Layer: `_BON`

![Minivan layout Image FUN](http://socialism.nl/misc/minivan/minivan_fun_layer_vb.jpg)
Layer: `_FUN`

![Minivan layout Image MOV](http://socialism.nl/misc/minivan/minivan_mov_layer_triangle_hw-basic-and-allkeys_vb.jpg)
Layer: `_MOV`

^ There is an alternative flat arrow configuration for this layer (see below),
and options to compile with the 'arrow' hardware layout.

![Minivan layout Image RAR](http://socialism.nl/misc/minivan/minivan_rar_layer_vc.jpg)
Layer: `_RAR`

4.3 Layout in text
------------------
     What comes on “___” is to be defined by the Base layers choice.

         Layer _DEF_BASE (Letters layer, see ./base* files for what comes on ‛__’)
                                                  | Right hand
         <pink2     <pinky<ring <middl<index<indx2| indx2>index>middl>ring> pinky>pinky2>   // Keys by finger
         -o-                                     <|>                                    ... //-o- Base access
         Esc        __    __    __    __    __    | __    __    __    __    __         Bksp
         Tab+LCtl   __    __    __    __    __    | __    __    __    __    __           __
         LSht+_PAD  __    __    __    __    __    | __    __    __    __    __    RSht+_FUN 
             +_MOV⁵                               |                                   +_RAR⁶
     ---------------------------------------------------------------------------------------
     Left+LAlt Del;_ACC _..._NSY(_DRA)  Enter+_MOV| Space  _..._NSY(_DRA) RGUI    Right;_RAR 
               hold     hold₍₁,₂٭₎      hold      |        hold₍₁,₂٭₎             hold     // switch type
               hold₍₂₎  ^-┃-----------------------+--------^ ┃                          // ₁₎ both = _DRA
               ┗━━━_BON━━━╋┅───────────┄┄┄«or»┄┄┄─+─────────┅┛                          // ₂₎ both = _BON
     <1   ±    <2       <3              <4        | 4>     3>             2>   ±  1>    // Keys by number
          ^³                                                                   ^⁴   // Optional more keys
        (LGUI)                                                               (_MOV)
     
     ₁) Dual hold for _DRA, single hold for _..._NSY. Marked by: ^--…--^
     ₂) Hold key “<2” with either٭ key “<3” or “3>” for _BON, single hold “<2” for _ACC. Marked: ┗━━…━━┛
     ³) 'South paw' hardware configuration. Configurable, default shown.
     ⁴) 'Arrow' hardware configuration  Configurable, default shown.
     ³ ⁴) There are two more optional hardware keys, to make it easier to compile for
          a 12x12x12x11 or 12x12x12x12 layouts.
     ⁵) Left Shift when pressed with another key. Medium long: to toggle _PAD. Long: toggle _MOV.
     ⁶) Right shift when pressed with another key. medium long: to toggle _FUN. Long: toggle _RAR.

Remarks: The left modifiers have a slight delay in combination with an outside pointer device (mouse, stylus).
It seems this will be difficult to fix, because it is spread over two devices. To avoid the
±0.2 second delay, activate a layer where the modifiers are direct (`_PAD`, `_MOV`), using the layer toggle on
left shift. 

The two keys with ';' (Del;`_ACC`, Right;`_RAR`) do not auto-repeat on double tap, like QMK normal layer-tap keys.

There is an uncluttered _Delete_ on `_PAD`, an uncluttered _Right_ arrow on the `_MOV` layer.

There is an uncluttered _Tab_ on both the `_DRA` and `_ACC` layers. They can be modified with _Control_ there.

Holding both `_..._NSY` keys left and right of the "split space bar" (enter, space) results in layer `_DRA`.

Holding either one of the just above mentioned `_..._NSY` layer keys (<3 and 3>), with the `_ACC` layer key
(on <2) results in layer `_BON`.

- - -

     Layer _..._NSY (Numbers and SYmbols, ./base* files for what comes on ‛__’)
    
     <pink2   <pinky<ring <middl<index<indx2| indx2>index>middl>ring>pin>pink2>
              -*-                          <|>                                  //(toggle) Access on _FUN
     BASE     __    __    __    __    __    | __    __    __    __   __     Bspc
     Tab+LCtl __    __    __    __    __    | __    __    __    __   __  __+RCtl
     -+LSht   __    __    __    __    __    | __    __    __    __   __  __+RSht 
     ---------------------------------------------------------------------------
                 Left+LAlt ___   ___   Ent  | .   ___   RGUI  Right+RAlt
                                 -*-       <|>    -*-                        //(hold) Access on _DEF_BASE
                   <1   ±  <2    <3    <4   | 4>  3>    2>  ± 1>  
                        ^                                   ^
                      (LGUI)                              (_MOV)

- - -
     
     Layer _FUN (F-keys, Layer access)
    
     <pink2<pinky<ring <middl<index<indx2| indx2>index>middl>ring> pinky>pink2>
     toggl toggl set   toggl toggl toggl | toggl toggl                            // Type of layer switch
                                        <|>                                       
     BASE: NUMS: _PAD  _ACC  _DRA  _BON  | _MOV  _RAR  xxx   xxx   xxx   Bspc       //':' are dynamic ...
     LCtl  F1    F2    F3    F4    F5    | F6    F7    F8    F9    F10   RCtl
     LSht  F11   F12   F13   F14   F15   | F16   F17   F18   F19   F20   RSht     
     ---------------------------------------------------------------------*--       //-*-  toggle on Base
              LAlt  LCtl&  LCtl&  LSht&  | FUN< +LCtl&LSht RGUI   RAlt              //... < toggle 'stay'
                    LSht   LAlt   LAlt   |      &LAlt                                    
                    +xxx   +xxx   +xxx   |      +xxx
                                        <|>
              <1  ± <2     <3     <4     | 4>   3>         2>  ±  1>                
                  ^                                            ^
                (LGUI)                                       (_MOV)

Remarks.  FUN< toggles an immediate return to the Base layer after pressing an F-key, 
or staying on the `_FUN` layer. Right led yellow indicates F-layer stays active.

- - -
    
This is the _triangle_ configuration for arrows, arrow are on left hand (WASD):

     Layer _MOV (MOVement, mouse movement on right hand)
    
     <pinky2<pinky<ring <middl<index<indx2| indx2>index>middl>ring> pinky>pink2>
                                         <|>-*-                                
     Base   PgDn  Up    PgUp  Home  Btn3  | xxx   WhDn  MsUp  WhU   WhLft Bksp
     LCtl   Left  Down  Right End   Btn1  | Btn1  MsLft MsDn  MsRht WhRht RCtl
     LSht   xxx   Acc2  Acc1  Acc0  Btn2  | Btn2  Btn3  Btn4  Btn5  xxx   RSht
     -------------------------------------------------------------------------
                     LAlt Del   Ent   ___ | PgUp  PgDn  RGUI  RAlt
                                      -*-<|>                                                 
                     <1 ± <2    <3    <4  | 4>    3>    2>  ± 1>  
                        ^                                   ^
                      (LGUI)                              (DOWN)


Remarks. For the Minivan _arrow_ hardware layout with arrow cluster, you get this on ‛Base’:

     (…)
     LSht+_PAD ;:    qQ    jJ    kK    xX    | bB    mM    wW    vV    zZ    RSht+_FUN
     -------------------------------------------------------------------------------
     Left+LAlt Del;_ACC _..._NSY(_DRA) Enter+_MOV| Space  _..._NSY(_DRA) RGUI  _MOV  Right;_RAR 
                                                                               ^^^^     // new key (toggle)

… and this on `_MOV` for the _triangle_ configuration:

     (…)
     LSht*- xxx   Acc2  Acc1  Acc0  Btn2  | Btn2  Btn3  Btn4  Btn5  _Up_  RSht
     ---------------------------------------------------------------------------
                     LAlt Del   Ent   ___ | PgUp       PgDn  _Left__Down__Right_
                                      -*-<|>                                 
                     <1 ± <2    <3    <4  | 4>         3>     2>   _±_    1>  
                        ^
                      (LGUI)

… or this on `_MOV` for the _triangle_ arrow configuration with additional _navigation_ keys:

     BASE   PgDn  Up    PgUp  Home _Btn4_ | xxx   WhDn  MsUp  WhU   WhLft Bksp
     LCtl   Left  Down  Right End   Btn1  | Btn1  MsLft MsDn  MsRht WhRht RCtl
     LSht*- xxx   Acc2  Acc1  Acc0 _Btn5_ | Btn2  Btn3 _Home__PgUp_ _Up_ _PgDn_
     ---------------------------------------------------------------------------
                     LAlt Del   Ent   ___ | PgUp      _End_  _Left__Down__Right_
                                      -*-<|>                                  
                     <1 ± <2    <3    <4  | 4>         3>     2>   _±_    1>  
                        ^
                      (LGUI)


This is the _flat_ configuration for arrows, arrow are on right hand:

     <pinky2<pinky<ring <middl<index<indx2| indx2>index>middl>ring> pinky>pink2>
                                         <|>-*-                              
     BASE   WLft  WDn   WUp   WRht  xxx   | Btn3  PgUp  Home  End   PgDn  Bksp
     LCtl   MLft  MDn   MUp   MRht  Btn1  | Btn1  Left  Up    Down  Right RCtl
     LSht*- Btn5  Btn4  Btn3  Butn2 xxx   | Btn2  Acc0  Acc1  Acc2  xxx   RSht
     -------------------------------------------------------------------------
                     LAlt Del   Ent   ___ | PgUp  PgDn  RGUI  RAlt
                                      -*-<|>                                                
                     <1 ± <2    <3    <4  | 4>    3>    2>  ± 1>  
                        ^                                   ^
                      (LGUI)                              (DOWN)

For the Minivan _arrow_ hardware layout with _flat_ arrow cluster, you get this on `_MOV`:

     (…)
     BASE   WLft  WDn   WUp   WRht  xxx   | Btn3  PgUp  Home  End   PgDn  Bksp
     LCtl   MLft  MDn   MUp   MRht  Btn1  | Btn1  Left  Up    Down  Right RCtl
     LSht*- Btn5  Btn4  Btn3  Butn2 xxx   | Btn2  Acc0  Acc1  Acc2  xxx   RSht
     ---------------------------------------------------------------------------
                     LAlt Del   Ent   ___ | PgUp      _Left_ _UP_  _Down__Right_
                                      -*-<|>                                 
                     <1 ± <2    <3    <4  | 4>         3>     2>   _±_    1>  
                        ^   
                      (LGUI)

… or this on `_MOV` for the _flat_ arrow configuration with additional _navigation_ keys:

     BASE   WLft  WDn   WUp   WRht  xxx   |_Acc2_ PgUp  Home  End   PgDn  Bksp
     LCtl   MLft  MDn   MUp   MRht  Btn1  | Btn1  Left  Up    Down  Right RCtl
     LSht*- Btn5  Btn4  Btn3  Butn2 xxx   |_Acc1_ Acc0 _PgUp__Home__End_ _PgDn_
     ---------------------------------------------------------------------------
                     LAlt Del   Ent   ___ | PgUp      _Left_ _UP_  _Down__Right_
                                      -*-<|>                                  
                     <1 ± <2    <3    <4  | 4>         3>     2>   _±_    1>  
                        ^ 
                      (LGUI)

… or this on `_MOV` for the _flat_ arrow configuration, […], and vi(1) layout:

     <pinky2<pinky<ring <middl<index<indx2| indx2>index>middl>ring> pinky>pink2>
                                         <|>-*-                                 
     BASE   WLft  WDn   WUp   WRht  xxx   |_Acc2_ PgUp  Home  End   PgDn  Bksp
     LCtl   MLft  MDn   MUp   MRht  Btn1  | Left  Down  Up    Right Btn1  RCtl         // vi as in Qwerty
     LSht*- Btn5  Btn4  Btn3  Butn2 xxx   |_Acc1_ Acc0 _PgUp__Home__End_ _PgDn_
     ---------------------------------------------------------------------------
                     LAlt Del   Ent   ___ | PgUp      _Left_ _Down__Up_  _Right_       // vi as in Qwerty
                                      -*-<|>                                  
                     <1 ± <2    <3    <4  | 4>         3>     2>   _±_    1>  
                        ^
                      (LGUI)

For the 'arrow' hardware layout (additional key on the right), keys on the first
row are sacrificed and lost. The right most key on the second row is also lost.
The two keys on places 3 and 4 when counting from the right on the second row,
are being moved to the spots for Btn2 and Btn3 on the hand that also has the 
arrows (those keys are otherwise twice defined for left and right hand).

- - -
    
     _RAR (RARe keys. Power keys, Unicode mode, Alternate Base, Media, Brightness, Speed, Size, leds, …)
    
     <pink2<pinky <ring <middl <indexx<indx2| indx2>index>middl>ring> pinky> pink2>
                                           <|>      -*-                                //(toggle) on _FUN
     BASE  Cnt/Mx Cnull CWmin  CRprt  Speed | SRprt Play  Next  Prev  Stop RSht(•)   
     CapsL Power• Wake• Sleep• Pause• ScrLk | PrtSc xxx   Vol+  Vol-  Mute Insert     // • requires Shift
     ☑     uLNX   uBSD  uOSX   uWIN   uWNC  | xxx   xxx   Bri+  Bri-  xxx     APP     // Ü(nicode) tester
     ----------------------------------------------------------------------------
                     SLed  MLeds LGUI  xxx  | !Alter  xxx   RGUI  ___   // Mid-led, Side-leds, !Alternate
                                           <|>                    -*-                   // (Hold) on Base
                     <1  ± <2    <3    <4   | 4>      3>    2>  ± 1>  
                         ^                                      ^
                       (LGUI)                                 (_MOV)

Remarks. !Alter switches between normal and alternate Base layer.

☑ is a Unicode tester key. uLNX for Linux Unicode input encoding, uBSD
for BSD Unix, uWIN for Windos, uWNC for another Windos encoding. The
change is retained between on/off power cycles.

MLed switches on/off the middle led, SLeds switches on/off the side leds.

The keys marked with • require Shift to be activated, as a means of
preventing accidents. Shift here is on (Base) 'Backspace' (upper/right key)
which also reduces accidents (combinations which are never pressed
normally). If you press these keys without 'shift' they print their own
name between angled brackets. Example: pressing the 2nd key on the 3rd
row prints `“<POWER>”`.

Bri+, Bri-: screen brightness (if your system supports it.)

Speed: toggles speed measuring on/off. SRprt: writes your speed.
See topic about Speed measuring.

Cnt/Mx, Cnull CWmin, CRprt: text size measuring. See topic.

- - -
    
    
     Layer _PAD Numbers Pad (special symbol versions; regular '1' is not the same as this numpad '1', etc)
    
     <pink2   <pinky<ring <middl<index<indx2| indx2>index>middl>ring> pinky>pink2>
                    -*-                    <|>                                         //(toggle) on _FUN
     BASE     xxx   xxx   .DEL  4LEFT 2DOWN | 8UP   6RGHT *     xxx   xxx   Bspc
     LCtl     1END  2DOWN 3PGDN 4LEFT 5     | 6RGHT 7HOME 8UP   9PGUP 0INS     -
     LSht     xxx   xxx   /     xxx   =     | +     3PGDN 1END  7HOME 9PGUP RSht
     -*-------------------------------------------------------------------------    //-*-  toggle on Base
                  LAlt     Del   Tab   ENT  |  NUML  xxx   RGUI  RAlt
                                           <|>
                  <1   ±   <2    <3    <4   | 4>     3>    2>  ± 1>  
                       ^                                       ^
                     (LGUI)                                  (_MOV)

Remarks: The keys between `.DEL` and `*`, `+` and `RSht` constitute sort of
navigation clusters, to make it easier to find the number pad versions thereof.

This is the variety for `_PAD` layer, which resembles a numerical keypad:

     Layer _PAD (Number pad, square layout)
    
     <pink2   <pinky<ring <middl<index<indx2| indx2>index>middl>ring>pin>pink2>
                                           <|>
     BASE     xxx   xxx   xxx   xxx   xxx   | =     7HOME 8UP   9PGUP -   Bspc
     LCtl     xxx   xxx   xxx   xxx   xxx   | *     4LEFT 5     6RGHT +   RCtl
     LSht     xxx   xxx   xxx   xxx   xxx   | /     1END  2DOWN 3PGDN ,   RSht  
     ------------------------------------------------------------------------
                   LAlt   Del    Tab   ENT  | NUML  0INS  .DEL  RAlt      
                                           <|>           
                   <1   ±  <2    <3    <4   | 4>    3>  ± 2>    1>  
                        ^                               ^ 
                      (LGUI)                          (RGUI)¹

     ₁) Note anomaly, see Base Numpad for details `./base_numpad.md`.
        Different placement and different meaning, compared to the usual common layers.

- - -
    
    
     Layer _ACC (ACCented characters, see _RAR layer for input modes)
    
     <pink2    <pinky<ring <middl<index<indx2| indx2>index>middl>ring> pinky>pink2>
                       -*-              <|>                                            //(toggle) on _FUN
     BASE      áÁ    óÓ    éÉ    úÚ    íÍ    | ýÝ    ijIJ    çÇ    øØ    åÅ    Bksp
     LCTL(Tab) äÄ    öÖ    ëË    üÜ    ïÏ    | ÿŸ    œŒ    æÆ    ñÑ     ß       μ
     LSht      àÀ    òÒ    èÈ    ùÙ    ìÌ    | îÎ    ûÛ    êÊ    ôÔ    â    RSht
     ----------------------------------------------------------------------------
                       LAlt ___   ___   Ent  | Spc   ___   ___   RAlt 
                            -*-             <|>                                        //(hold) on Base
                       <1 ± <2    <3    <4   | 4>    3>    2>  ± 1>  
                          …                                    …

- - -
    
    
     Layer _DRA (DRAwings, whatever else (rendering width might vary in different applications))

     <pink2<pinky<ring <middl<index<indx2| indx2>index>middl>ring> pinky>pink2>
                             -*-        <|>                                            //(toggle) on _FUN
     BASE  “„    ”≤    £≥    ∅ ¢   ±ƒ    | ❦♥    🙂🙁  👍👎   ⁽₍    ⁾₎    Bspc 
     Tab   ¹₁    ²₂    ³₃    ⁴₄    ⁵₅    | ⁶₆    ⁷₇    ⁸₈     ⁹₉    ⁰₀    RCTL
     LSht 「━    」─   °〇   •§    …·    | ☐☒   ☑🗹     ¿¡    《┄    》┅   RSht     //  ☐ ☒ ☑ 🗹 or ⮘ ⮙ ⮚ ⮛
     -------------------------------------------------------------------------
                   LAlt ___   ___   Ent  | Spc   ___   ___   RAlt 
                              -*-       <|>      -*-                                     //(hold) on Base
                   <1 ± <2    <3    <4   | 4>    3>    2>  ± 1>  
                      ^                                    ^
                    (LGUI)                               (_MOV)

Remarks. ☐ ☒ ☑ 🗹 or ⮘ ⮙ ⮚ ⮛
- - -

     Layer _BON (Bonus layer, a variety of more stuffs.)

     <pink2<pinky<ring <middl<index<indx2| indx2>index>middl>ring> pinky>pink2>
                                   -*-  <|>                                            //(toggle) on _FUN
     BASE  ‛ 🛠  ’ ⬆   ¤ 🄯   ∑ ©   ‰ ‱   | ★ ٭   😊 ⍨  ×  ⃰   √     ⁻ ⁺    Bksp
     `~    ① ⬅   ② ⬇   ③ ➡   ④ ┏   ⑤  ┓  | ⑥ ┃   ⑦ ┇   ⑧ ╋   ⑨     ⓪ ∞    — ≈     // — is a dash (larger)
     LSht  ‹     ›     ÷     ☞ ┗   ≠  ┛  | ✗ ┣   ✓ ┫   ⚠     «     »      RSht
     -------------------------------------------------------------------------
                  Left  ___   ___   Ent  | Spc   ___   ___   Right
                        -*-   -*-       <|>      -*-                                // Activation on Base
                  <1  ± <2    <3    <4   | 4>    3>    2>  ± 1>  
                      ^                                    ^
                    (LGUI)                               (_MOV)
    
- - -

4.4 Movement layer options
--------------------------
The movement layer (`_MOV`) has several configuration options. You
can either have _triangle_ configuration arrows on the _left_ hand
(with navigation keys around it), or a _flat_ arrow configuration on
the _right_ hand (with navigation above it).

You can configure for the _arrow_ hardware layout (one additional hardware
key on the right). The additional key on the Base layer can toggle to the
movement layer, and than becomes part of the arrow cluster. For both
versions (_triangle_ arrows left hand or _flat_ arrows right hand) you
can compile this second arrow cluster to be completed with navigation keys
(Home, End, PageUp, PageDown).

![Minivan layout Image MOV 3 defaultf](http://socialism.nl/misc/minivan/minivan_mov_layer_flat_hw-basic_vb.jpg)

![Minivan layout Image MOV 3b default](http://socialism.nl/misc/minivan/minivan_mov_layer_triangle_hw-basic_vb.jpg)

^ `#define ARROWS_TRIANGLE`

![Minivan illustration BASE towards 3](http://socialism.nl/misc/minivan/minivan_layer_illustration_base_mov_hw-arrow_vb.jpg)

^ Illustration of accessing the arrows/navigation with a key on the Base layer

![Minivan layout Image MOV 3b + arrow](http://socialism.nl/misc/minivan/minivan_mov_layer_hardw-arrow_triangle_vb.jpg)

^ `#define ARROWS_TRIANGLE`, `MORE_KEY__ARROW`, `MOREKEY2_ARROW_CLUSTER`, `MORE_key2 _MOV_UP`

![Minivan layout Image MOV 3b + navig](http://socialism.nl/misc/minivan/minivan_mov_layer_hardw-arrow_triangle_addnav_vb.jpg)

^ `#define ARROWS_TRIANGLE`, `MORE_KEY__ARROW`, `MOREKEY2_ARROW_CLUSTER`, `MOREKEY2_ADD_NAVIGATION`, `MORE_key2 _MOV_UP` (note change on previously BTN2/3)

![Minivan layout Image MOV 3 + arrows](http://socialism.nl/misc/minivan/minivan_mov_layer_hardw-arrow_flat_vb.jpg)

^ `#define MORE_KEY__ARROW`, `MOREKEY2_ARROW_CLUSTER`, `MORE_key2 _MOV_UP`

![Minivan layout Image MOV 3 + naviga](http://socialism.nl/misc/minivan/minivan_mov_layer_hardw-arrow_flat_addnav_vb.jpg)

^ `#define MORE_KEY__ARROW`, `MOREKEY2_ARROW_CLUSTER`, `MOREKEY2_ADD_NAVIGATION`, `MORE_key2 _MOV_UP` (note change on previously BTN2/3)

![Minivan layout Image MOV 3 vi arrow](http://socialism.nl/misc/minivan/minivan_mov_layer_vi_vb.jpg)

^ `#define` \[`MORE_KEY__ARROW`, `MOREKEY2_ARROW_CLUSTER`\] `VI_SWITCHERYDOO`, `#undef ARROWS_TRIANGLE`

4.5 Numbers pad layer options
-----------------------------
This concerns the numbers pad layer, the one that is part of the common layers.

![Minivan layout Image PAD](http://socialism.nl/misc/minivan/minivan_pad_layer_vc.jpg)

![Minivan layout Image PAD squared](http://socialism.nl/misc/minivan/minivan_pad_layer_squared_vb.jpg)

^ `#define NUMPAD_COMMON_SQUARE`

5 Led colors for layers
=======================
      • letters                          Led: low-white/teal/off⁽¹⁾          _DEF_BASE "Default base"
        • letters (alternate)              Led: off/teal/low-white           _ALT_BASE "Alternate base"
      • numbers                          Led: blue/blue/blue                 _DEF_NSY "Default Numbers SYmbols"
        • numbers (alternate)              Led: blue/blue/low-white          _ALT_NSY "Alternate Numbers SYmbols"
      • number pad symbol versions       Led: green/low-white/blue ⁽²⁾       _PAD "numbers PAD"
      • accented characters é, ø, ß …    Led: cyan/cyan/cyan                 _ACC "ACCented"
      • Unicode symbols, ¹, ±, ° …       Led: yellow/yellow/yellow           _DRA "DRAwings"
      • Unicode symbols, ①, ‰, ÷ …       Led: off/yellow/off                 _BON "Bonus"
      • function keys,                   Led: red/red/orange ⁽³⁾             _FUN "FUNction keys"
      • and a movement layer             Led: green/green/green              _MOV "MOVement"
      • keys like Power, Play,           Led: white/purple/purple ⁽⁴⁾        _RAR "RARe keys"

      Leds:
            • ⁽¹⁾ The low-white led is bright-white when capslock is on. Optionally the middle led (cyan) can
                  show the color of the last layer that was active.
            • ⁽²⁾ The colors are reversed blue/low-white/green when numlock is on. 
                  Left led color memory aid: same as either numbers or movement layer for numlock on/off.
            • ⁽³⁾ The colors are reversed to orange/red/red when set to deactivate after one F-key press.
            • ⁽⁴⁾ The colors are reversed purple/purple/white, indicating which of the two base layers
                  is active (see below).
            • Middle led: Breathing effect. When not breathing, keyboard is not working normally with the computer.
                        - When speed measurement is active, the middle led color indicates the speed, unless
                          text size counting set to a maximum is active.
                        - When text size counting is active and set to a maximum amount, the middle led color 
                          indicates progress to the limit from green to red, flipping white/red on the limit.
                        - When on Base layer it shows a teal color, or (compile option) the layer most recently active.
                        - When the left/right leds are off, when on Base, it shows a teal color (not last active), even
                          if so compiled.
            • Leds can be switched on/off on the _RAR layer (SLeds, MLed).


6 Compile options
=================
         Layout

 • Several layouts to choose from: Qwerty, Dvorak, Colemak, Workman, Numpad.

 • You can use the keyboard with two different letters/number-symbols layouts.

         Hardware

 • Hardware key configurations: _default_ (44), _arrow_ (45), _south paw_ (45), _arrow_ + _south paw_ (46).

![Minivan illustration 0](http://socialism.nl/misc/minivan/minivan_illustration_arrow_southpaw.jpg)
   (On the `_RAR` layer, the additional _south paw_ key is more to the right.)

 • What the additional hardware keys for _arrow,_ _south paw_ should be.

         Navigation cluster

 • An arrow cluster for _arrow_ hardware configuration, on the `_MOV` layer.

 • All navigation keys around _arrow_ hardware configuration arrow cluster on `_MOV` layer.

 • Navigation cluster in a triangle (WASD) (left hand), or flat layout with optional vi(1) layout.

         Numpad (in common layers)
 
 • Numpad with numbers in a row.

 • Numpad with layers in a block form.

         Special functions

 • Set speed measuring on/off at keyboard startup.

 • Set text size measuring on/off at keyboard startup.

         Changing symbols

 • Switching the GUIs left/right, and some other specific key changes.  

 • Reduce firmware size/bloat: remove or eviscerate Unicode layer(s).

 For the complete list, see ![./user_config.h](./user_config.h)

7 Language support
==================

7.1 Input methods
=================
There seem to generally be two ways in QMK for typing a language other than English.
One is to use a language specific remapping on the computer operating side, and
to use the QMK supplied symbols in the keymaps. This may include the use of a “dead key”.
Presumably you can also still use the Unicode symbols. 

⚠ *There are currently no such Base pair layouts available. If this is the method you want,
you may want to look elsewhere.*

The other way is to type the additional symbols in Unicode. _The computer
operating must understand these special sequences._  Several Unicode
input modes are available, which can be changed while the keyboard is
running. There is no need for a “dead key”.  The language setting
in the computer operating system can be set to English. This layout is
designed for this method, to avoid the dead key problem.

7.2 Unicode symbols
===================
For the remainder of this chapter the Unicode input method is assumed.

You may be able to type your language, with the help of some of the Unicode
layers and one of these layouts: Qwerty, Dvorak, Coleman, Workman. The following
languages might work for you this way. 

     • Dutch (éëèïijí)
     • English (—“”‛’)
     • French (çœæéèàòùîûêôâëïüÿ)
     • German (äöüß)
     • Norwegian, Danish (œæøå, éêèëóêò, üáà …)
     • Spanish (¿¡ñ)
     • Swedish (äåö …)

The following quotation marks are available, which seems it would cover these languages: 

     'test' "test" “test” „test” ‛test’ ,test’¹ «test» ‹test› 《test》 「test」 — test

     ¹) Left side is a basic comma.

See the `_ACC` _accented characters_ layer for all characters with diacritic markings.
If you miss a symbol, you could replace one you don't use and add it yourself (by
reprogramming the source code).

8 Speed measuring
=================
      ‛Speed’ starts speed measuring.
      ‛SRprt’ stands for ‛Speed Report’:
                • Tap to get your speed report.
                • Hold for a while for led color compilation (see below).
      ☞ Text size counting (see below) middle led colors take precedence,
        when a maximum is set, over layer colors or speed measurement.

With the key ‛Speed’ on the `_RAR` layer, the speed of your latest
completed batch of 25 key presses is computed, as well as the average of
all your batches of 25 keys. The speed is displayed as the color of the
middle led, which otherwise shows the layer color. A bright white middle
led indicates ‛Speed’ has just been activated.

With the key ‛SRprt’ (short for ‛Speed Report’), the keyboard
will write your typing speed either in keystrokes per second (k/s)
or words-per-minute (wpm), depending on your compilation configuration.

“Keystrokes per second” uses the following format: `<A k/s B.B k/s
Cx25keys>`. A is the amount of key presses per second (k/s) of your
last batch, B.B is your average over the last C batches of keys.
When using “Words per minute”, A is in word-per-minute, B is also
in words-per-minute: `<A wpm B wpm Cx25keys>`, no decimal precision.
Example: <150wpm;108wpm20x25keys>

Batches with 0 k/s are not counted to the average. You can take a
longer break without it affecting your average.

8.1 Speed Led color compilation assist
--------------------------------------
If you hold the ‛Speed Report’ key for one second, it will increment the
speed, and led color accordingly. This can be helpful when configuring
your speed measuring compile settings. This works best with speed
measuring set off.

9 Text size measuring
=====================
      ‛Cnt/Mx’ stands for ‛Count/Maximum’: 
                • Tap to start counting, tap again to suspend.
                • Hold > 0.5 seconds for maximum menu.
      ‛Cnull’ stands for ‛Count null’:
                • Tap to set the counts to zero.
      ‛CWmin’ stands for ‛Count Word minus’:
                • Tap to detract one word from the word count. 
                • Hold > 0.5 seconds to detract 10 words.
      ‛CRprt’ stands for ‛Count Report’:
                • Tap to get a counting report. 
      ☞ ‛Count’ and ‛Speed’ (see above) reports get added to the
        character count, but not to the word count.
      ☞ Auto-repeating keys do not get counted as characters.

You can count your text by character and word, by activating the key
‛Count’ on the `_RAR` layer. Pressing ‛Count’ again will suspend
counting, pressing it yet again resumes where the count left off earlier.
The middle led turns cyan when no maximum is set (see below),
or to green when it is set.

You can set a maximum to type, with the ‛Cnt/Mx’ key.  In your
editor (or wherever typing these characters is harmless) you will get
the following menu by pressing the ‛Cnt/MX’ key for at least half
a second: `<Nc|w>`. In here: *N* stands for your numerical input, *c*
for a maximum count in *characters* or *w* for a maximum in *words.*

Start typing a number, finish with either *c* or *w* to make the maximum
be counted in either characters or words. If you want to leave the
menu before giving *c* or *w*, enter a *dot* ‛.’ or ‛Escape’,
which will leave the maximum value at 0 (zero). A maximum value of zero
implies there is no maximum.

Setting a maximum of 1000 characters looks like so:

        Hold ‛Cnt/MX’ results in: `<Nc|w>` 
        Then type “1000” results in: `<Nc|w>1000`
        Then type “c” results in: `<Nc|w>1000->1000c`
        At this point the keyboard is out of this special input menu.

        The keyboard indicates what it accepted as your input, by 
        repeating the number, just before your last input is being printed.

With a maximum established, the middle led color goes from green to red,
as you type. When the maximum is reached, the keyboard will output a
Backspace character for every key you subsequently press, making it
impossible to go any further, until text size counting has been disabled,
or the count is reduced. The middle led changes color between red and 
white while at the maximum set size, for every new input character.

To get your word count report, press ‛CReport’ short for: ‛Count
Report’.  It comes in the form: `<Ac;Bw>`, where A is your character
count, and B is your word count. Example: `<5420c;547w>`. 

When a maximum is established, the report will only be given in
either characters or words, and the maximum is given with it, like so:
`<66w>[200w]`. 66 words have been written, a maximum of 200 words has
been set.

If you have a maximum established and use it across different articles,
you no longer have the total count. You can activate speed measuring,
which in its report includes the total characters pressed.

9.1 Text size Usage
-------------------
It is assumed that you will take the report in the document you are
editing, and then delete it. If you do character counting, the value of 
the report itself is added to the character count. Therefore you should
delete that without using an auto-repeating on the deletion key. That
way the characters are subtracted again.

If you count in words, the report is not added to the word count. You
can delete it however you want.

This works the same for a ‛*Speed* Report’ you might like to take.
You can take it in the document, and then delete it in the same,
without affecting the text size counting in characters or words.
When deleting keys with Backspace or Delete, the character count goes down
accordingly, the word count does not.

Words are counted by counting Space and Enter key presses. Immediately
repeating blanks do not add to the word count.  You can only manually
subtract from the word count, using the key ‛CWmin’ short for ‛Count
Word minus’. This means that if you delete sections in your document,
you need to manually subtract the same words.

Example: after typing something and then typing `<Enter>` twice to start a
new paragraph, counts for one word. When deleting three words with their
three blank areas, then tapping ‛Count Word minus’ three times,
should result in an accurate word count. To add words to the count,
type mock ones and then delete them: “x x x x” adds *three* words,
“y y  y ” also adds three words (three separate blank spaces).

Layer changes, shift and unusual/complex keys do not get counted.
Navigation, arrow and mouse keys do not get counted. Auto-repeating
of keys does not affect the *character* count, therefore should be avoided
if you want to count in characters.

10 Making your own base layer(s)
================================
You can insert your own `_DEF_BASE`, `_DEF_NSY` and/or `_ALT_BASE`, `_ALT_NSY`
Base plus number/symbols layer pairs, integrate it nicely with the rest 
of the code, and re-define a special characters layer to go with it if
you want (etc). The idea is to make it easy to change the alphanumerical
keys, while leaving the modifiers, layer switch keys etc. the same. 
`YOUR_KEYMAP` stands for a name you choose.

First we will look at a simple keymap, without its own configuration
options or header file.

     ① Make a file named: `./base_YOUR_KEYMAP.c`), with at least 
       those two layers: _..._BASE and _..._NSY. It is probably best to
       copy one of the existing `./base_....c` files, and edit that.

     ② Add a #define to `./user_config.h`:
       #define BASE_YOUR_KEYMAP__DEF_BASE
       #define BASE_YOUR_KEYMAP__ALT_BASE
       Under the topic ‛Base layers’ there is a comment to help you.

     ③ Edit ./keymap.c to have your new file #included, using your just defined
       preprocessor element. Close to the other #includes is a comment there to
       help you. Look just under the line with this, in ./keymap.c:

       const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
       (…)
       // // ⬇ insert your ./base_YOUR_KEYMAP.c #include here:

       // # if defined(BASE_YOUR_KEYMAP__DEF_BASE) || defined(BASE_YOUR_KEYMAP__ALT_BASE)
       // #     include "./base_YOUR_KEYMAP.c" // Your Keymap.
       // # endif

Now you have integrated your base layers alternative. To compile it:

     ④ _Activate_ your #define BASES_YOUR_KEYMAP__DEF_BASE or 
       BASES_YOUR_KEYMAP__ALT_BASE in `./user_config.h`,
       _Remove_ any other base layers from being defined on the
       same spot _DEF_BASE or _ALT_BASE to prevent a conflict.

     ⑤ Check Preprocessing with:
       > gcc -E keymap.c | less

     ⑥ Compile and flash to your keyboard.

You can redefine any layer in your new `./base_YOUR_KEYMAP.c`
You can do that by setting one or more of the `BASESFILE_LAYER_...` defines in 
your own `./base_YOUR_KEYMAP.c` file. See near the top of an existing 
`./base_....c` file for clues.
`_ACC` in particular is a layer meant to augment a keymap with special 
characters for a given language/layout in the base layer(s). Perhaps you
want to redefine it, for example.

Example: Having done the above points ① ➡ ④ for a `./base_YOUR_KEYMAP.c` file. 
Let's say you re-arranged keys on `_ACC` to suit ... French.

     ⑦ In your `./base_YOUR_KEYMAP.c`:
       #define `BASESFILE_LAYER_ACC`
       The `_ACC` in ./keymap.c will now be ignored.

You can re-define `_ACC` in your own file. 

     ⑧ Copy an existing `_ACC` layer into `./base_YOUR_KEYMAP.c` 
       Edit it so that French characters like ‛Ç’ ‛«»’, ‛œ’, ‛æ’,
       ‛ô’, ‛é’ etc. are in positions that work best. You can look in
       `unicode_weurope.h` to find some Unicode points already defined.

     ⑨ Compile and flash to your keyboard.

Now we will look at a more complicated keymap, where you are also altering
preprocessor constants defined in ![./user_config.h](./user_config.h) (Warning, perhaps this
is overkill … ;-)

Example: the `./base_numpad.c` has an option to entirely eviscerate the
`_PAD` layer, for convenience. (Why is this even useful ? Good question !
One reason could be that it can set up a default, so that anyone who chooses
this `./base_numpad.c` Base layer, automatically is eviscerating the `_PAD`
_common_ layer, without having to do anything else. On the downside, it
could be confusing that one option is configured in two places.)

Having done the above points ⑦ ➡ ⑧ as well, let's say for some reason you
need to reverse Left GUI and Right GUI.

      ⑨ Copy your User Configuration Block at the top of your `./base_YOUR_KEYMAP.c`
        and the GPL License, and place that in a new _header_ file: 
        `./base_YOUR_KEYMAP.h` 
    
      ① ⓪  Write the necessary code to set and unset the constant
           `SWITCH_GUIS` in your `./base_YOUR_KEYMAP.h` file You are encouraged
           to write code which overrides any setting in `./user_config.h,` for
           those constants which you choose to affect, for simplicity sake. 
           (This is not a C programming manual, so it won't get into this.)
   
      ① ①  Look in `./user_config.h`, and #include your header file there, in
           a similar way as was done for your C code file. It should be just
           below the user configuration block, and has a template for you.
   
      ① ②  Compile, flash and test.
   
      ① ③  It would be nice to put a remark on the general preprocessor constants
           which you might be affecting, that your keymap could be affecting them.
           You would edit the ./user_config.h comments with a short one line notice,
           such as:
   
           *
           * ⚠ Note: ./base_YOUR_KEYMAP.h can overrides this setting, if compiled with that ‛Base’ layer.
           */

Putting your `*.h` header file in ![./user_config.h](./user_config.h) isn't strictly
necessary, unless you alter “general preprocessor constants”
defined in ![./user_config.h](./user_config.h) (not local constants for your keymap only).

Perhaps a separate header file is overkill. On the other hand, whatever
preprocessor logic is necessary after user configuration has been given,
can be handled in one place, if #included as suggested. It allows you
to override the settings in ![./user_config.h](./user_config.h) from your header file
(because it is #included immediately below those). If a user is playing with
keymaps Base compile choices, it could be convenient to play with
`./base_YOUR_KEYMAP.h` settings, have everything that could be relevant
close at hand, then forgetting about those settings once compiling
with another Base layer, and be able to return to it with previous
configuration already done.

You can also just #include your header file at the top of your 
`./base_YOUR_KEYMAP.h` file, if it does not touch anything else but your
local keymap.

11 Evisceration
===============
Cutting down the keymap reduces the firmware size, and helps reducing
mental clutter from having masses of symbols you might never want to use.

You can compile as a single layout. Define only a ‛Default’ base pair,
and set `MINIFAN_SINGLE_LAYOUT` (![./user_config.h](./user_config.h)). The leds for the
base layers letters and numbers&symbols, will show up as they would for
the ‛Alternate’ layer in a dual layout compilation.

You can remove the layers `_ACC`, `_DRA` and/or `_BON` (see
![./user_config.h](./user_config.h) around `REMOVE_ACC`). 

You can remove a set of symbols from one or more of Unicode layers,
such as not having box drawing characters on `_BON`, or no sub-script
numbers on `_DRA`.

12 Key associations
===================
The keymap was designed to have the same or similar keys on the same key
or close to it, on different layers. Sometimes the association goes by
what finger is used, and/or on what row. For example the symbol ‛(’
on the numbers-symbols layer (`_NSY`), becomes the symbol ‛⁽’ on
another layer.

![Minivan layout Image associations](http://socialism.nl/misc/minivan/minivan-relationships_common_1500_ve.jpg)

12.1 Compared to regular keyboard
=================================
The main advantage compared to a regular keyboard is to never have to
leave the homerow. 

Basic trade-off examples are: (①) on a regular keyboard you need to
reach two rows up to press a number like ‛4’; (②) three rows up to reach
an F-key like ‛F4’; (③) or move your hand entirely to reach the navigation
cluster for ‛Up-Arrow’. On this Minivan 40% keyboard with this ‛Minifan’
layout you (①) move either thumb sideways a little to hold down the 
number/symbols layer key, and then press down left index finger for ‛4’;
(②) press and let go ‛Right-Shift’ to toggle the F-keys layer and then 
press down left index finger for ‛F4’; (③) press down left thumb on where 
it probably is resting, and then move left ring finger one row up to reach
‛Up-Arrow’.

A downside is that you would be typing a non-standard keyboard, making
it harder to adapt to regular keyboards. On the upside, this keyboard is
small enough to take it with you. Plugging it into some other computer
is only going to work, if that other computer is not using a language
setting which changes too many keycodes, or if changing the language
setting is not a problem.

In total the differences are probably marginal. It can be worth it if
you are doing a lot of 10 finger typing. The change in efficiency might
be similar to changing from Qwerty to Dvorak or another such optimized
layout, although incomparably much easier to learn than changing from
Qwerty to Dvorak (in author's personal experience). If the latter can
take years, the former could take weeks to months. Keep in mind that
you have the whole standard letters keymap where it used to be, plus the
numbers with their shifted symbols are in predictable locations.

The hardest to learn out of the standard symbols, will be: /\=+|?, and
to a lesser degree {}[]. These are now evenly spread out, rather than this
mess you have under right little finger on regular keyboards.

13 Trouble shooting
===================
  • Compiling

  If the firmware is too large, you can try using a different version
  of the compiler, or you may have to reduce size by removing certain
  options.

  • Unicode

  Unicode is chaos: try going to `_RAR` layer, and hit the Unicode
  operating system buttons.

  • Leds

  Leds not working after flashing firmware: try going to `_RAR` layer, 
  and hit the key MLeds and SLeds, which switch Leds on/off.

  • Weird layer jumping

  You weirdly end up on the `_PAD`, `_FUN` or some other layer while
  typing ? If you jump to layers which are on Shift key toggles, this
  is a typing mistake. 

  • Difficult/impossible key combinations ?

  An example of a difficult key combination is: the modifier Control, 
  Shift, or Alt, with media key “volume up” (or down, etc). It may 
  work to press and hold “Control” (which should communicate “Control
  depressed”), then activate `_RAR` layer with the hold key (which 
  communicates nothing to the computer attached to the keyboard), 
  press and let go “volume up” (which should communicate just that), let
  go of the `_RAR` layer (which again communicates nothing), let go of
  the Control key (which should communicate “Control released”).. 

14 Why you want this layout
===========================
☞  This layout seems easy to learn and predictable. It is not personalized
  or idiosyncratic, but rather based on existing keyboards, typewriters
  and commonly used symbols in the supported languages. The key placement
  is as close to a regular keyboard as possible, unless there are clearly
  better placement choices.

☞  The normally most used layer after letters is “numbers & symbols” 
  (123…, !@#…, []/…, called `_NSY`). This layer you can access by either
  your left or right thumb, to spread fatigue.

☞  Right hand pinky is no longer overused, as it is on regular keyboards.

☞  0-9 enumerations / numbers, they are on the same fingers as a standard
  keyboard. 

☞  The symbols normally reached by shifting a number, are also still on
  the same fingers.

☞  Because one often uses an F-key only once, the layer can switch back
  to Base after an F-key is used.

☞  Modifier combination keys on `_FUN` layer for use with F-keys.

☞  The movement layer has a bunch of layout options, and allows for mouse
  use.

☞  The layer with Power buttons protects you from accidental keystrokes
  on the critical keys. 

☞  If you need working with Control/Shift/Alt and a pointing device in
  right hand, you can quickly get uncluttered such keys by tapping left shift.

☞  The accented layer makes it possible to set the keyboard in a mode
  on the computer side without dead-keys.

☞  The second Unicode layer adds a fair amount of fun stuff to spice up 
  your writing. Write H₂O, 2⁷·⁰=128, ±8 °C, §2.1, 2 ³/₈", a note⁴, £ 6.²⁵
  etc.
        
☞  The third Unicode layer adds a proper dash — and French style
  quotations «»‹› and other stuff. ①  «Ça va bien», ②  5 × 3 ≠ 14,
  ③  .083% ÷ 2 ≈ 4‱ ➡  4.₁₅‱

                  ┏━━━━━━┓
                  ┃ test ┃
                ┅━╋━━━━━━┛
                  ┇ ④

☞  Speed and text size measuring, including to set a maximum on your text input.
  These are features not part of regular keyboards.

☞  Easy to create your own dual layout for letters / numbers.

☞  If you do want to reprogram the code, it has a lot of comments to make
  it easier to follow, and over the top much documentation as you can see.

15 BUGS
=======
  No real bugs known currently. Just some minor issues …

  `LCTL_T` `( KC_TAB )` is not seen as a blank by word counting, use as Control is not
  ignored in character counting. (This minor issue is ignored for now. Tab is not
  normally used in text writing.)

  The evisceration may not have been worked out yet into the ultimate scrubbing of
  everything that may have become redundant, because it does complicate the code with
  a lot of #defines. Perhaps it should be done eventually, if there is an actual need.

  ➡ You can send bug reports to what seem useful channels, and/or contact e-mail. Thanks

16 Resources
============
This links to an external file, with some additional resources.
[Resources](http://socialism.nl/misc/minivan/ "Additional resources")

     ☞ Gimp .xcf files.
     ☞ Some precompiled hex files.
     ☞ Documentation in other formats.
       …

17 Author(s)
============
  This keymap.c was edited from the Minivan default, original LED
  support was copied/edited from ../jetpacktuxedo/ keymap. Thanks to 
  QMK support for their help, especially Drashna.

  _Personal note:_ This keymap came about because of a sudden need
  for a replacement keyboard. It took over a year to make (≈ 1.5 h/day).
  The goal became to make a good keymap for everyone without the time to
  make one.

  Written on the Minivan: Jos Boersema. [contact](https://market.socialism.nl/author/ "get e-mail address there")
  If anyone forks this or whatever, feel free to drop me a note.

  Contributions to this key map:
      - …