Browse Source

docs: Add guide to build additional keyboards with GH Actions (#1126)

Co-authored-by: Cem Aksoylar <caksoylar@users.noreply.github.com>
xmkb
Albert Y 3 years ago committed by GitHub
parent
commit
7474d985c9
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
  1. 25
      docs/docs/customization.md

25
docs/docs/customization.md

@ -56,3 +56,28 @@ For normal keyboards, follow the same flashing instructions as before to flash y
For split keyboards, only the central (left) side will need to be reflashed if you are just updating your keymap. For split keyboards, only the central (left) side will need to be reflashed if you are just updating your keymap.
More troubleshooting information for split keyboards can be found [here](troubleshooting.md#split-keyboard-halves-unable-to-pair). More troubleshooting information for split keyboards can be found [here](troubleshooting.md#split-keyboard-halves-unable-to-pair).
## Building Additional Keyboards
You can build additional keyboards with GitHub actions by appending them to `build.yml` in your `zmk-config` folder. For instance assume that we have set up a Corne shield with nice!nano during [initial setup](user-setup.md) and we want to add a Lily58 shield with nice!nano v2. The following is an example `build.yaml` file that would accomplish that:
```
include:
- board: nice_nano
shield: corne_left
- board: nice_nano
shield: corne_right
- board: nice_nano_v2
shield: lily58_left
- board: nice_nano_v2
shield: lily58_right
```
In addition to updating `build.yaml`, Lily58's shield files should also be added into the `config` sub-folder inside `zmk-config` together with your Corne files, e.g.:
```
corne.conf
corne.keymap
lily58.conf
lily58.keymap
```

Loading…
Cancel
Save