Skip to content

Commit

Permalink
Stub out community layout directory structure
Browse files Browse the repository at this point in the history
  • Loading branch information
zvecr committed Nov 26, 2023
1 parent 65b5969 commit 40516dd
Show file tree
Hide file tree
Showing 88 changed files with 241 additions and 144 deletions.
3 changes: 3 additions & 0 deletions layouts/community/60_abnt2/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 60_abnt2

LAYOUT_60_abnt2
66 changes: 1 addition & 65 deletions layouts/community/60_ansi/readme.md
Original file line number Diff line number Diff line change
@@ -1,67 +1,3 @@
# 60_ansi

This is the standard 60% ANSI keyboard layout.

## Requirements

### 1. Layout defined

A keyboard's `.h` file needs to have `LAYOUT_60_ansi` defined

```c
#define LAYOUT_60_ansi( \
K36, K37, K46, K47, K56, K57, K66, K67, K76, K77, K06, K07, K17, K27, \
K34, K35, K44, K45, K54, K55, K64, K65, K75, K05, K15, K16, K25, K24, \
K32, K33, K43, K52, K53, K63, K73, K74, K03, K04, K13, K14, K23, \
K31, K42, K51, K61, K62, K71, K72, K01, K02, K11, K12, K21, \
K30, K40, K50, K60, K70, K00, K10, K20 \
) { \
{ K00, K01, K02, K03, K04, K05, K06, K07 }, \
{ K10, K11, K12, K13, K14, K15, K16, K17 }, \
{ K20, K21, KC_NO, K23, K24, K25, KC_NO, K27 }, \
{ K30, K31, K32, K33, K34, K35, K36, K37 }, \
{ K40, KC_NO, K42, K43, K44, K45, K46, K47 }, \
{ K50, K51, K52, K53, K54, K55, K56, K57 }, \
{ K60, K61, K62, K63, K64, K65, K66, K67 }, \
{ K70, K71, K72, K73, K74, K75, K76, K77 } \
}
```
This layout needs to match the layout defined in
qmk_firmware/layouts/community/layout.json
### 2. Configuring rules.mk
`rules.mk` needs to have the following line:
LAYOUTS = 60_ansi
### 3. Defining a keymap
A keymap must be defined at
qmk_firmware/layouts/community/60_ansi/yourfoldername/keymap.c
This keymap must have a `LAYOUT_60_ansi` layout defined.
```c
const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
[BASE] = LAYOUT_60_ansi(
QK_GESC, KC_1, KC_2, KC_3, KC_4, KC_5, KC_6, KC_7, KC_8, KC_9, KC_0, KC_MINS, KC_EQL, KC_BSPC,
KC_TAB, KC_Q, KC_W, KC_E, KC_R, KC_T, KC_Y, KC_U, KC_I, KC_O, KC_P, KC_LBRC, KC_RBRC, KC_BSLS,
KC_LCTL, KC_A, KC_S, KC_D, KC_F, KC_G, KC_H, KC_J, KC_K, KC_L, KC_SCLN, KC_QUOT, KC_ENT,
KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT,
KC_LCTL, KC_LALT, KC_LGUI, KC_SPACE, MO(1), KC_RALT, KC_RGUI, KC_RCTL),
};
```

## Usage

To make generate a hex file, type

make yourkeyboard:yourfoldername

This hex file will contain a keymap with layout `LAYOUT_60_ansi` derived from

qmk_firmware/layouts/community/60_ansi/yourfoldername/keymap.c
LAYOUT_60_ansi
3 changes: 3 additions & 0 deletions layouts/community/60_ansi_arrow/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 60_ansi_arrow

LAYOUT_60_ansi_arrow
3 changes: 3 additions & 0 deletions layouts/community/60_ansi_arrow_split_bs_7u_spc/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 60_ansi_arrow_split_bs_7u_spc

LAYOUT_60_ansi_arrow_split_bs_7u_spc
2 changes: 1 addition & 1 deletion layouts/community/60_ansi_split_bs_rshift/readme.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
# 60_ansi_split_bs_rshift

LAYOUT_60_ansi_split_bs_rshift
LAYOUT_60_ansi_split_bs_rshift
3 changes: 3 additions & 0 deletions layouts/community/60_ansi_tsangan/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 60_ansi_tsangan

LAYOUT_60_ansi_tsangan
3 changes: 3 additions & 0 deletions layouts/community/60_ansi_wkl/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 60_ansi_wkl

LAYOUT_60_ansi_wkl
3 changes: 3 additions & 0 deletions layouts/community/60_ansi_wkl_split_bs_rshift/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 60_ansi_wkl_split_bs_rshift

LAYOUT_60_ansi_wkl_split_bs_rshift
3 changes: 3 additions & 0 deletions layouts/community/60_hhkb/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 60_hhkb

LAYOUT_60_hhkb
2 changes: 1 addition & 1 deletion layouts/community/60_iso/readme.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
# 60_iso

LAYOUT_60_iso
LAYOUT_60_iso
3 changes: 3 additions & 0 deletions layouts/community/60_iso_split_bs_rshift/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 60_iso_split_bs_rshift

LAYOUT_60_iso_split_bs_rshift
3 changes: 3 additions & 0 deletions layouts/community/60_iso_tsangan/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 60_iso_tsangan

LAYOUT_60_iso_tsangan
3 changes: 3 additions & 0 deletions layouts/community/60_iso_tsangan_split_bs_rshift/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 60_iso_tsangan_split_bs_rshift

LAYOUT_60_iso_tsangan_split_bs_rshift
3 changes: 3 additions & 0 deletions layouts/community/60_iso_wkl/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 60_iso_wkl

LAYOUT_60_iso_wkl
3 changes: 3 additions & 0 deletions layouts/community/60_iso_wkl_split_bs_rshift/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 60_iso_wkl_split_bs_rshift

LAYOUT_60_iso_wkl_split_bs_rshift
3 changes: 3 additions & 0 deletions layouts/community/60_jis/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 60_jis

LAYOUT_60_jis
3 changes: 3 additions & 0 deletions layouts/community/60_tsangan_hhkb/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 60_tsangan_hhkb

LAYOUT_60_tsangan_hhkb
3 changes: 3 additions & 0 deletions layouts/community/64_ansi/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 64_ansi

LAYOUT_64_ansi
3 changes: 3 additions & 0 deletions layouts/community/64_iso/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 64_iso

LAYOUT_64_iso
3 changes: 3 additions & 0 deletions layouts/community/65_ansi/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 65_ansi

LAYOUT_65_ansi
3 changes: 3 additions & 0 deletions layouts/community/65_ansi_blocker/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 65_ansi_blocker

LAYOUT_65_ansi_blocker
3 changes: 3 additions & 0 deletions layouts/community/65_ansi_blocker_split_bs/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 65_ansi_blocker_split_bs

LAYOUT_65_ansi_blocker_split_bs
3 changes: 3 additions & 0 deletions layouts/community/65_ansi_blocker_tsangan/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 65_ansi_blocker_tsangan

LAYOUT_65_ansi_blocker_tsangan
3 changes: 3 additions & 0 deletions layouts/community/65_ansi_blocker_tsangan_split_bs/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 65_ansi_blocker_tsangan_split_bs

LAYOUT_65_ansi_blocker_tsangan_split_bs
3 changes: 3 additions & 0 deletions layouts/community/65_ansi_split_bs/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 65_ansi_split_bs

LAYOUT_65_ansi_split_bs
3 changes: 3 additions & 0 deletions layouts/community/65_iso/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 65_iso

LAYOUT_65_iso
3 changes: 3 additions & 0 deletions layouts/community/65_iso_blocker/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 65_iso_blocker

LAYOUT_65_iso_blocker
3 changes: 3 additions & 0 deletions layouts/community/65_iso_blocker_split_bs/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 65_iso_blocker_split_bs

LAYOUT_65_iso_blocker_split_bs
3 changes: 3 additions & 0 deletions layouts/community/65_iso_blocker_tsangan/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 65_iso_blocker_tsangan

LAYOUT_65_iso_blocker_tsangan
3 changes: 3 additions & 0 deletions layouts/community/65_iso_blocker_tsangan_split_bs/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 65_iso_blocker_tsangan_split_bs

LAYOUT_65_iso_blocker_tsangan_split_bs
3 changes: 3 additions & 0 deletions layouts/community/65_iso_split_bs/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 65_iso_split_bs

LAYOUT_65_iso_split_bs
3 changes: 3 additions & 0 deletions layouts/community/66_iso/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 66_iso

LAYOUT_66_iso
2 changes: 0 additions & 2 deletions layouts/community/68_ansi/readme.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,3 @@
# 68_ansi

LAYOUT_68_ansi

This is the 68 key ANSI layout made popular by boards such as the Magicforce 68 and Varmilo VA68M.
3 changes: 3 additions & 0 deletions layouts/community/68_iso/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 68_iso

LAYOUT_68_iso
70 changes: 1 addition & 69 deletions layouts/community/75_ansi/readme.md
Original file line number Diff line number Diff line change
@@ -1,71 +1,3 @@
# 75_ansi

This is the standard 75% ANSI keyboard layout.

One may argue that having 3 1u keys to the right of spacebar
is not desired as two 1.5u keys. However, most 75% boards that
come out have that as the standard.

## Requirements

### 1. Layout defined

A keyboard's `.h` file needs to have `LAYOUT_75_ansi` defined

```c
#define LAYOUT_75_ansi( \
K5A, K5B, K5C, K5D, K5E, K5F, K5G, K5H, K5I, K5J, K5K, K5L, K5M, K5N, K5O, K5Q, \
K4A, K4B, K4C, K4D, K4E, K4F, K4G, K4H, K4I, K4J, K4K, K4L, K4M, K4O, K4P, \
K3A, K3B, K3C, K3D, K3E, K3F, K3G, K3H, K3I, K3J, K3K, K3L, K3M, K3O, K3P, \
K2A, K2B, K2C, K2D, K2E, K2F, K2G, K2H, K2I, K2J, K2K, K2L, K2O, K2P, \
K1A, K1C, K1D, K1E, K1F, K1G, K1H, K1I, K1J, K1K, K1M, K1N, K1O, K1P, \
K0A, K0B, K0C, K0J, K0K, K0L, K0M, K0N, K0O, K0P \
) { \
{ K5A, K5B, K5C, K5D, K5E, K5F, K5G, K5H, K5I, K5J, K5K, K5L, K5M, K5N, K5O, KC_NO, K5Q }, \
{ K4A, K4B, K4C, K4D, K4E, K4F, K4G, K4H, K4I, K4J, K4K, K4L, K4M, KC_NO, K4O, K4P, KC_NO }, \
{ K3A, K3B, K3C, K3D, K3E, K3F, K3G, K3H, K3I, K3J, K3K, K3L, K3M, KC_NO, K3O, K3P, KC_NO }, \
{ K2A, K2B, K2C, K2D, K2E, K2F, K2G, K2H, K2I, K2J, K2K, K2L, KC_NO, KC_NO, K2O, K2P, KC_NO }, \
{ K1A, KC_NO, K1C, K1D, K1E, K1F, K1G, K1H, K1I, K1J, K1K, KC_NO, K1M, K1N, K1O, K1P, KC_NO }, \
{ K0A, K0B, K0C, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, K0J, KC_NO, K0K, K0L, K0M, K0N, K0O, K0P, KC_NO } \
}
```
This layout needs to match the layout defined in
qmk_firmware/layouts/community/75_ansi/layout.json
### 2. Configuring rules.mk
`rules.mk` needs to have the following line:
LAYOUTS = 75_ansi
### 3. Defining a keymap
A keymap must be defined at
qmk_firmware/layouts/community/75_ansi/yourfoldername/keymap.c
This keymap must have a `LAYOUT_75_ansi` layout defined.
```c
const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
[0] = LAYOUT_75_ansi(
KC_ESC, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, KC_PSCR, KC_PAUS, KC_DEL,
KC_GRV, KC_1, KC_2, KC_3, KC_4, KC_5, KC_6, KC_7, KC_8, KC_9, KC_0, KC_MINS, KC_EQL, KC_BSPC, KC_HOME,
KC_TAB, KC_Q, KC_W, KC_E, KC_R, KC_T, KC_Y, KC_U, KC_I, KC_O, KC_P, KC_LBRC, KC_RBRC, KC_BSLS, KC_PGUP,
KC_CAPS, KC_A, KC_S, KC_D, KC_F, KC_G, KC_H, KC_J, KC_K, KC_L, KC_SCLN, KC_QUOT, KC_ENT, KC_PGDN,
KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP, KC_END,
KC_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, KC_RGUI, KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT)
};
```

## Usage

To make generate a hex file, type

make yourkeyboard:yourfoldername

This hex file will contain a keymap with layout `LAYOUT_75_ansi` derived from

qmk_firmware/layouts/community/75_ansi/yourfoldername/keymap.c
LAYOUT_75_ansi
3 changes: 3 additions & 0 deletions layouts/community/75_iso/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 75_iso

LAYOUT_75_iso
3 changes: 3 additions & 0 deletions layouts/community/96_ansi/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 96_ansi

LAYOUT_96_ansi
3 changes: 3 additions & 0 deletions layouts/community/96_iso/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 96_iso

LAYOUT_96_iso
3 changes: 3 additions & 0 deletions layouts/community/alice/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# alice

LAYOUT_alice
3 changes: 3 additions & 0 deletions layouts/community/alice_split_bs/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# alice_split_bs

LAYOUT_alice_split_bs
2 changes: 1 addition & 1 deletion layouts/community/ergodox/readme.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
# ergodox

LAYOUT_ergodox
LAYOUT_ergodox
3 changes: 3 additions & 0 deletions layouts/community/fullsize_ansi/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# fullsize_ansi

LAYOUT_fullsize_ansi
3 changes: 3 additions & 0 deletions layouts/community/fullsize_extended_ansi/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# fullsize_extended_ansi

LAYOUT_fullsize_extended_ansi
3 changes: 3 additions & 0 deletions layouts/community/fullsize_extended_iso/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# fullsize_extended_iso

LAYOUT_fullsize_extended_iso
3 changes: 3 additions & 0 deletions layouts/community/fullsize_extended_jis/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# fullsize_extended_jis

LAYOUT_fullsize_extended_jis
3 changes: 3 additions & 0 deletions layouts/community/fullsize_iso/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# fullsize_iso

LAYOUT_fullsize_iso
3 changes: 3 additions & 0 deletions layouts/community/fullsize_jis/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# fullsize_jis

LAYOUT_fullsize_jis
3 changes: 3 additions & 0 deletions layouts/community/numpad_4x4/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# numpad_4x4

LAYOUT_numpad_4x4
3 changes: 3 additions & 0 deletions layouts/community/numpad_5x4/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# numpad_5x4

LAYOUT_numpad_5x4
3 changes: 3 additions & 0 deletions layouts/community/numpad_6x4/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# numpad_6x4

LAYOUT_numpad_6x4
3 changes: 3 additions & 0 deletions layouts/community/numpad_6x5/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# numpad_6x5

LAYOUT_numpad_6x5
3 changes: 3 additions & 0 deletions layouts/community/ortho_1x1/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# ortho_1x1

LAYOUT_ortho_1x1
3 changes: 3 additions & 0 deletions layouts/community/ortho_3x3/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# ortho_3x3

LAYOUT_ortho_3x3
3 changes: 3 additions & 0 deletions layouts/community/ortho_4x10/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# ortho_4x10

LAYOUT_ortho_4x10
2 changes: 1 addition & 1 deletion layouts/community/ortho_4x12/readme.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
# ortho_4x12

LAYOUT_ortho_4x12
LAYOUT_ortho_4x12
3 changes: 3 additions & 0 deletions layouts/community/ortho_4x16/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# ortho_4x16

LAYOUT_ortho_4x16
2 changes: 1 addition & 1 deletion layouts/community/ortho_4x4/readme.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
# ortho_4x4

LAYOUT_ortho_4x4
LAYOUT_ortho_4x4
3 changes: 3 additions & 0 deletions layouts/community/ortho_4x6/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# ortho_4x6

LAYOUT_ortho_4x6
2 changes: 1 addition & 1 deletion layouts/community/ortho_5x12/readme.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
# ortho_5x12

LAYOUT_ortho_5x12
LAYOUT_ortho_5x12
3 changes: 3 additions & 0 deletions layouts/community/ortho_5x14/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# ortho_5x14

LAYOUT_ortho_5x14
2 changes: 1 addition & 1 deletion layouts/community/ortho_5x15/readme.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
# ortho_5x15

LAYOUT_ortho_5x15
LAYOUT_ortho_5x15
3 changes: 3 additions & 0 deletions layouts/community/ortho_5x4/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# ortho_5x4

LAYOUT_ortho_5x4

0 comments on commit 40516dd

Please sign in to comment.