mirror of
https://github.com/qmk/qmk_firmware
synced 2024-11-17 09:24:48 +00:00
25 lines
925 B
Markdown
25 lines
925 B
Markdown
# How to add your own keymap
|
|
|
|
Folders can be named however you'd like (will be approved upon merging), or should follow the format with a preceding `_`:
|
|
|
|
_[ISO 3166-1 alpha-2 code*]_[layout variant]_[layout name/author]
|
|
|
|
\* See full list: https://en.wikipedia.org/wiki/ISO_3166-1#Officially_assigned_code_elements
|
|
|
|
and contain the following files:
|
|
|
|
* `keymap.c`
|
|
* `readme.md` *recommended*
|
|
* `config.h` *optional*, found automatically when compiling
|
|
* `Makefile` *optional*, found automatically when compling
|
|
|
|
When adding your keymap to this list, keep it organised alphabetically (select list, edit->sort lines), and use this format:
|
|
|
|
* **folder_name** description
|
|
|
|
# List of keymaps
|
|
- **default** default layout from KBDFans
|
|
- **mason**
|
|
- **planck** Planck default layout
|
|
- **xtonhasvim** A Planck-like layout with a few tweaks and a vim emulation layer.
|
|
- **nosarthur** Custom Colemak-dh layout and qwerty layout
|