summaryrefslogtreecommitdiffstats
path: root/keyboards/crkbd/keymaps/bermeo/readme.md
blob: a9b0d4ff095869804ae3e348099fb257911b203c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
# Bermeo Layout for Corne

## Features

### *Corne for neo-latin creatives*

* Usable with left hand only (Figma, Adobe, Spline, etc) to combo with mouse.
* Delete and enter keys on the left side.
* Z and X on left side with lower layer used to control the monitor's brigtness.
* Arrow keys on left hand (vim logic)
* Accentuations used in Romance (neo-latin) languages like Spanish, Portuguese, French and Italian - ` ~ ^ ' -.

#### Direct ç and ã keys

The termination "tion" (eg. action) in portuguese is "ção" (eg. ação). This layout is optimized to use the less keys possible to write words with this termination.

Compared to the `crkbd:default` layout the difference to output ção would be half of the interations:

| crkbd:bermeo | <sub>`MO(2)`</sub>, `KC_C`, `KC_A`, <sup>`MO(2)`</sup> |
|:--|:--|
| crkbd:default | `KC_QUOT`, `KC_C`, <sub>`MO(2)`</sub>, <sub>`KC_SFT`</sub>, `KC_GRV`, <sup>`MO(2)`</sup>, <sup>`KC_SFT`</sup>, `KC_A` |

[ <sub>`hold key`</sub> , <sup>`release key`</sup> ]

### Modern OLED Support

* Non-intrusive OLED layer indicator.
* Non-intrusive OLED modifier indicators ⌘ ⇧ ⌥  ⌃.
* Fully animated Luna on left side.
  
### Full per-key RGB Matrix support

With the index of every key mapped in the table below to be used with `rgb_matrix_set_color(index, r, g, b)`;.

#### Indexes of the keys

|||||||||||||||
|:--:|:--:|:--:|:--:|:--:|:--:|--|--|:--:|:--:|:--:|:--:|:--:|:--:|
| 24 | 23 | 18 | 17 | 10 | 9 ||| 36 | 37 | 44 | 45 | 50 | 51 |
| 25 | 22 | 19 | 16 | 11 | 8 ||| 35 | 38 | 43 | 46 | 49 | 52 |
| 26 | 21 | 20 | 15 | 12 | 7 ||| 34 | 39 | 42 | 47 | 48 | 53 |
|||||            14 | 13 |  6 | 33  | 40 | 41            |||||

Each layer uses the LED `14` as an visual indicator:

* ⚫️ Default layer
* 🔵 Lower (0)
* 🟠 Raise (1)
* 🟢 Numpad (2)
* ⚪️ Control and Command
* 🟡 Shift

## Mod-taps

For convenience, QMK includes some Mod-Tap shortcuts to make common combinations more compact in your keymap:
| Key         |                             Description |
| :--         |                                     --: |
| LCTL_T(kc)  | Left Control when held, kc when tapped. |
| LSFT_T(kc)  | Left Shift when held, kc when tapped.   |
| LALT_T(kc)  | Left Alt when held, kc when tapped.     |
| ALT(kc)     | Left Alt + kc when tapped.              |
| LGUI_T(kc)  | Left GUI when held, kc when tapped.     |
| RSFT_T(kc)  | Right Shift when held, kc when tapped.  |
| RGUI_T(kc)  | Right GUI when held, kc when tapped.    |

## Macros

|Layer | Name    | Description                                                                       | Keys          |
| :--: | --:     | --                                                                                | --:           |
|  🟠  | CEDILLA |  Directly outputs ç                                                               | ' + c         |
|  🟠  | AO      |  Directly outputs ã                                                               | shift + ` + a |
|  🟠  | ASPAS   |  Outputs ", since diaeresis[^1] are less used than " (for coding and quoting) | shift + ' + space |

## Layers

### QWERTY

|||||||||||||||
|:--|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|--:|
| LCTL_T(F3[^2])  | Q | W | E | R | T ||| Y | U | I | O | P |      GRAVE      |
| LALT_T(TAB)     | A | S | D | F | G ||| H | J | K | L | ; |        ↵        |
| LSFT_T(&larr;)  | Z | X | C | V | B ||| N | M | , | . | / | RGUI_T(&rarr;)  |
|||||  LGUI_T(&darr;) | MO(1) | SPACE |  ⌫ | MO(2)| RSFT_T( &uarr;)       |||||


### LOWER 🔵

|||||||||||||||
|:--|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|--:|
|CTL_T(F5[^3])   |  1  |  2  |  3  |  4  |  5  |||  6  |  7  |  8  |  9  |  0  | ESCAPE |
|LCTL(LGUI(KC_SPC))[^4] | &larr; | &darr; |  &uarr; | &rarr; | ↵ ||| [ | ] | \ | ' | : |  ↵  |
|ALT(&larr;) | F1[^5] | F2[^6] |   C |  V |  ⌫ ||| - | = | < | > | ? |   LALT(&rarr;)       |
|||||      LGUI_T(PAGE_DOWN) | _ | SPACE | LALT(⌫) | TG(3) | RSFT_T(PAGE_UP)           |||||

### RAISE 🟠

|||||||||||||||
|:--|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|--:|
LCTL_T(F4[^7]) |  ! | @ | # | $ | % |||  ˆ | & | *      | (     | ) |     ˜    |
LALT_T(TAB) | Ã[^8] |   |   |   |   |||  { | } | &#124; | "[^9] | : |     ↵    |
LALT(&larr;) |  |   | Ç[^10] |   |   ||| _ | + | <      | >     | ? | LALT(&rarr;) |
|||||  LGUI_T(END) | TG(3) | SPACE| DEL| _ | RSFT_T(HOME)                      |||||

### NUMPAD 🟢

|||||||||||||||
|:--|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|--:|
|  RGB_TOG ||         |         |         ||||   | 7 | 8 | 9 | * | / |
||  RGB_HUI | RGB_SAI | RGB_VAI | RGB_SPI ||||   | 4 | 5 | 6 | - | ↵ |
||  RGB_HUD | RGB_SAD | RGB_VAD | RGB_SPD |||| . | 1 | 2 | 3 | + |   |
|||||                  TG(3)| TG(3) | TG(3) | ⌫ | TG(3) |  0     |||||

## Usage

To compile and flash, from `qmk setup` folder, run:

    make crkbd:bermeo:flash

## Compiled size

    28658/28672 (99%, 14 bytes free)

If more space is needed, start by deactivating Macros and Luna's animations.

## Credits

Guilherme Bermêo [(github)](https://git.bermeo.dev)

### Thanks

* @armand1m
* @brneor
* @drashna
* @hellsingcoder
* @soundmonster
* @wdtamagi

[^1]: The diaeresis (/daɪˈɛrəsɪs, -ˈɪər-/ dy-ERR-ə-sis, -⁠EER-; also known as the trema) and the umlaut (/ˈʊmlaʊt/) are two different diacritical marks that (in modern usage) look alike. They both consist of two dots ¨ placed over a letter, usually a vowel; when that letter is an i or a j, the diacritic replaces the tittle: ï. In computer systems, both forms have the same code point (binary code). Their appearance in print or on screen may vary between typefaces but rarely within the same typeface. The "diaeresis" diacritic is used to mark the separation of two distinct vowels in adjacent syllables when an instance of diaeresis (or hiatus) occurs, so as to distinguish from a digraph or diphthong.
The "umlaut" diacritic, in contrast, indicates a sound shift phenomenon – also known as umlaut – in which a back vowel becomes a front vowel.
Neither of these phenomena occur in English, except in loanwords (like naïve) or for stylistic reasons (as in the Brontë family or Mötley Crüe).

[^2]: Open Mission Control.

[^3]: Bring up the screenshot toolbar.

[^4]: Opens emoji dialog box.

[^5]: Decrease display brightness.

[^6]: Increase display brightness.

[^7]: Launchpad.

[^8]: Macro "CEDILLA".

[^9]: Macro "AO".

[^10]: Macro "ASPAS".