Trim pointer layer and edit readme
This commit is contained in:
Björn
GitHub
parent
949f4f1812
commit
07523cf497
5 changed files with 270 additions and 225 deletions
164
README.md
164
README.md
|
|
@ -2,58 +2,124 @@
|
|||
|
||||
This is a template repository which allows for an external set of QMK keymaps to be defined and compiled. This is useful for users who want to maintain their own keymaps without having to fork the main QMK repository.
|
||||
|
||||
## Howto configure your build targets
|
||||
These keymaps are using keymap_german_mac_iso.
|
||||
Symbols are 'translated', if a linux/windows host is detected.
|
||||
|
||||
1. Run the normal `qmk setup` procedure if you haven't already done so -- see [QMK Docs](https://docs.qmk.fm/#/newbs) for details.
|
||||
1. Fork this repository
|
||||
1. Clone your fork to your local machine
|
||||
1. Enable userspace in QMK config using `qmk config user.overlay_dir="$(realpath qmk_userspace)"`
|
||||
1. Add a new keymap for your board using `qmk new-keymap`
|
||||
* This will create a new keymap in the `keyboards` directory, in the same location that would normally be used in the main QMK repository. For example, if you wanted to add a keymap for the Planck, it will be created in `keyboards/planck/keymaps/<your keymap name>`
|
||||
* You can also create a new keymap using `qmk new-keymap -kb <your_keyboard> -km <your_keymap>`
|
||||
* Alternatively, add your keymap manually by placing it in the location specified above.
|
||||
* `layouts/<layout name>/<your keymap name>/keymap.*` is also supported if you prefer the layout system
|
||||
1. Add your keymap(s) to the build by running `qmk userspace-add -kb <your_keyboard> -km <your_keymap>`
|
||||
* This will automatically update your `qmk.json` file
|
||||
* Corresponding `qmk userspace-remove -kb <your_keyboard> -km <your_keymap>` will delete it
|
||||
* Listing the build targets can be done with `qmk userspace-list`
|
||||
1. Commit your changes
|
||||
|
||||
## Howto build with GitHub
|
||||
|
||||
1. In the GitHub Actions tab, enable workflows
|
||||
1. Push your changes above to your forked GitHub repository
|
||||
1. Look at the GitHub Actions for a new actions run
|
||||
1. Wait for the actions run to complete
|
||||
1. Inspect the Releases tab on your repository for the latest firmware build
|
||||
|
||||
## Howto build locally
|
||||
|
||||
1. Run the normal `qmk setup` procedure if you haven't already done so -- see [QMK Docs](https://docs.qmk.fm/#/newbs) for details.
|
||||
1. Fork this repository
|
||||
1. Clone your fork to your local machine
|
||||
1. `cd` into this repository's clone directory
|
||||
1. Set global userspace path: `qmk config user.overlay_dir="$(realpath .)"` -- you MUST be located in the cloned userspace location for this to work correctly
|
||||
* This will be automatically detected if you've `cd`ed into your userspace repository, but the above makes your userspace available regardless of your shell location.
|
||||
1. Compile normally: `qmk compile -kb your_keyboard -km your_keymap` or `make your_keyboard:your_keymap`
|
||||
|
||||
Alternatively, if you configured your build targets above, you can use `qmk userspace-compile` to build all of your userspace targets at once.
|
||||
|
||||
## Extra info
|
||||
|
||||
If you wish to point GitHub actions to a different repository, a different branch, or even a different keymap name, you can modify `.github/workflows/build_binaries.yml` to suit your needs.
|
||||
|
||||
To override the `build` job, you can change the following parameters to use a different QMK repository or branch:
|
||||
# Base Layers
|
||||
First and last column keys on base layers for 6x3 keyboards,
|
||||
(X) is the corresponding key from the currently active base layer:
|
||||
```
|
||||
with:
|
||||
qmk_repo: qmk/qmk_firmware
|
||||
qmk_ref: master
|
||||
⌥/⌫│ │⌥/(X)
|
||||
───┼─ ─┼─────
|
||||
⌃/⎋│ (...other keys...) │⌃/(X)
|
||||
───┼─ ─┼─────
|
||||
⌘/▤│ │⌘/ ↵
|
||||
```
|
||||
|
||||
If you wish to manually manage `qmk_firmware` using git within the userspace repository, you can add `qmk_firmware` as a submodule in the userspace directory instead. GitHub Actions will automatically use the submodule at the pinned revision if it exists, otherwise it will use the default latest revision of `qmk_firmware` from the main repository.
|
||||
All base layers share the same thumb cluster:
|
||||
(If the keyboard only has 2 keys on one side, the outermost key (marked with *) is missing)
|
||||
```
|
||||
* *
|
||||
⎋ │ ↵ │ ⇥ │ │ ⌫ │Spc│ ⌦
|
||||
───┴─⇧─┴LOW┘ └RSE┴─⇧─┴───
|
||||
```
|
||||
|
||||
This can also be used to control which fork is used, though only upstream `qmk_firmware` will have support for external userspace until other manufacturers update their forks.
|
||||
## QWERTY (german adaption)
|
||||
```
|
||||
q │ w │ e │ r │ t z │ u │ i │ o │ p │(ü)
|
||||
───┼───┼───┼───┼─── ───┼───┼───┼───┼─── ───
|
||||
a │ s │ d │ f │ g h │ j │ k │ l │ ö │(ä)
|
||||
─Σ─┼───┼───┼───┼─── ───┼───┼───┼───┼─Σ─ ───
|
||||
y │ x │ c │ v │ b n │ m │ , │ . │ ß │
|
||||
─M─┴───┴───┴───┴─── ───┴───┴───┴───┴─M─
|
||||
```
|
||||
|
||||
1. (First time only) `git submodule add https://github.com/qmk/qmk_firmware.git`
|
||||
1. (To update) `git submodule update --init --recursive`
|
||||
1. Commit your changes to your userspace repository
|
||||
## BONE
|
||||
```
|
||||
j │ d │ u │ a │ x p │ h │ l │ m │ w │(ß)
|
||||
───┼───┼───┼───┼─── ───┼───┼───┼───┼─── ───
|
||||
c │ t │ i │ e │ o b │ n │ r │ s │ g │(q)
|
||||
─Σ─┼───┼───┼───┼─── ───┼───┼───┼───┼─Σ─ ───
|
||||
f │ v │ ü │ ä │ ö y │ z │ , │ . │ k │
|
||||
─M─┴───┴───┴───┴─── ───┴───┴───┴───┴─M─
|
||||
```
|
||||
|
||||
## Colemak (Mod DH, german adaption)
|
||||
```
|
||||
q │ w │ f │ p │ b j │ l │ u │ y │ ö │(ü)
|
||||
───┼───┼───┼───┼─── ───┼───┼───┼───┼─── ───
|
||||
a │ r │ s │ t │ g m │ n │ e │ i │ o │(ä)
|
||||
─Σ─┼───┼───┼───┼─── ───┼───┼───┼───┼─Σ─ ───
|
||||
z │ x │ c │ d │ v k │ h │ , │ . │ ß │
|
||||
─M─┴───┴───┴───┴─── ───┴───┴───┴───┴─M─
|
||||
```
|
||||
|
||||
# Additional Layers
|
||||
|
||||
## Symbols
|
||||
```
|
||||
(⌥)│ @ │ _ │ [ │ ] │ ^ ! │ < │ > │ = │ & │(⌥)
|
||||
─── ───┼───┼───┼───┼─── ───┼───┼───┼───┼─── ───
|
||||
(⌃)│ \ │ / │ { │ } │ * ? │ ( │ ) │ - │ : │(⌃)
|
||||
─── ───┼───┼───┼───┼─── ───┼───┼───┼───┼─── ───
|
||||
(⌘)│ # │ $ │ | │ ~ │ ´ + │ % │ " │ ' │ ; │(⌘)
|
||||
───┌───┬───┐ ┌───┬───┐───
|
||||
° │ § │ ` │ │AGr│Spc│CWT
|
||||
───└───┴───┘ └───┴─⇧─┘───
|
||||
```
|
||||
(when dynamic tapping term is enabled, thumbs change to:)
|
||||
```
|
||||
───┌───┬───┐ ┌───┬───┐───
|
||||
PTT│ § │TT+│ │TT-│Spc│CWT
|
||||
───└───┴───┘ └───┴─⇧─┘───
|
||||
```
|
||||
|
||||
## Lower (Function keys and numbers)
|
||||
```
|
||||
(⌥)│F1 │F2 │F3 │F4 │ £ / │ 7 │ 8 │ 9 │ - │(⌥)
|
||||
─── ───┼───┼───┼───┼─── ───┼───┼───┼───┼─── ───
|
||||
(⌃)│F5 │F6 │F7 │F8 │ € + │ 4 │ 5 │ 6 │ . │(⌃)
|
||||
─── ───┼───┼───┼───┼─── ───┼───┼───┼───┼─── ───
|
||||
(⌘)│F9 │F10│F11│F12│ ¢ 0 │ 1 │ 2 │ 3 │ , │(⌘)
|
||||
───┌───┬───┐ ┌───┬───┐───
|
||||
$ │Sft│(v)│ │Bsp│Spc│App
|
||||
───└───┴───┘ └ATT┴─⇧─┘───
|
||||
```
|
||||
|
||||
## Raise (Navigation and control keys)
|
||||
(the home row modifiers on the right are sticky)
|
||||
```
|
||||
(⌥)│PUp│BSp│ ↑ │Del│Ins Prv│Stp│Ply│AGr│Nxt│(⌥)
|
||||
─── ───┼───┼───┼───┼─── ───┼───┼───┼───┼─── ───
|
||||
(⌃)│Hme│ ← │ ↓ │ → │End * Meh│Sft│ ⌃ │ ⌥ │ ⌘ │(⌃)
|
||||
─── ───┼───┼───┼───┼─── ───┼───┼───┼───┼─── ───
|
||||
(⌘)│Esc│Cut│Cpy│Pst│PDn PSc│CWT│Pse│Ejt│SLk│(⌘)
|
||||
───┌───┬───┐ ┌───┬───┐───
|
||||
Prv│V -│V ×│ │(v)│V +│Nxt
|
||||
───└─⇧─┴ATT┘ └───┴─⇧─┘───
|
||||
```
|
||||
|
||||
## Pointer (Mouse, only if enabled)
|
||||
* CSC: CTL(/GUI)+Shift+Click
|
||||
```
|
||||
(⌥)│vMv│<M<│Ms↑│>M>│ │ │CSC│AGr│ │(⌥)
|
||||
─── ───┼───┼───┼───┼─── ───┼───┼───┼───┼─── ───
|
||||
(⌃)│Bt4│Ms←│Ms↓│Ms→│Bt5 Meh│Sft│ ⌃ │ ⌥ │ ⌘ │(⌃)
|
||||
─── ───┼───┼───┼───┼─── ───┼───┼───┼───┼─── ───
|
||||
(⌘)│Tb←│Cut│Cpy│Pst│^M^ │Slo│Med│Fst│Tb→│(⌘)
|
||||
───┌───┬───┐ ┌───┬───┐───
|
||||
CSC│Bt1│Bt2│ │Bt3│Bt1│CSC
|
||||
───└───┴───┘ └───┴─⇧─┘───
|
||||
```
|
||||
|
||||
## Attic (Adjustments and missing stuff)
|
||||
```
|
||||
│QBt│ECl│LAs│LAr│APP ¡ │ ‹ │ « │ » │ › │(§)
|
||||
─── ───┼───┼───┼───┼─── ───┼───┼───┼───┼─── ───
|
||||
│LyG│Ly←│Ly→│BsL│MDX ¿ │ • │ ‚ │ ‘ │ ’ │(…)
|
||||
─── ───┼───┼───┼───┼─── ───┼───┼───┼───┼─── ───
|
||||
│RGB│R_S│R_H│R_V│R_M n-–│m-—│ „ │ “ │ ” │
|
||||
───┌───┬───┐ ┌───┬───┐───
|
||||
LSf│Br-│(v)│ │(v)│Br+│RSf
|
||||
───└─⇧─┴───┘ └───┴─⇧─┘───
|
||||
```
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue