From d44ae684cef7b713cd2897cf419070956967f84a Mon Sep 17 00:00:00 2001 From: Cem Aksoylar Date: Wed, 22 Jan 2025 23:16:39 -0800 Subject: [PATCH 1/3] docs: Update keymaps intro --- docs/docs/keymaps/index.mdx | 21 ++++++++------------- 1 file changed, 8 insertions(+), 13 deletions(-) diff --git a/docs/docs/keymaps/index.mdx b/docs/docs/keymaps/index.mdx index bbef41acb8e..41330181033 100644 --- a/docs/docs/keymaps/index.mdx +++ b/docs/docs/keymaps/index.mdx @@ -5,22 +5,17 @@ sidebar_label: Keymaps import KeymapExample from "../keymap-example.md"; -ZMK uses a declarative approach to keymaps instead of using C code for all keymap configuration. -Right now, ZMK uses the devicetree syntax to declare those keymaps; future work is envisioned for -supporting dynamic loading of declarative keymaps, e.g. over USB Mass Storage or via a custom BLE -service. +ZMK uses a declarative approach to keymaps, using the devicetree syntax to configure them in a `.keymap` file. +This declarative configuration defines the key mappings, behaviors used within them and the configuration of certain features. +These keymaps can then be updated dynamically/at runtime using the [ZMK Studio](../features/studio.md) feature, +which allows keymap modifications over USB or BLE. -:::note -For advanced users looking to implement custom behaviors for their keymaps, this will be possible -in the future by allowing user configs to add to the CMake application built by Zephyr. -::: - -## Big Picture +## Stock and User Keymaps All keyboard definitions (complete boards or shields) include the _default_ keymap for that keyboard, -so ZMK can produce a "stock" firmware for that keyboard without any further modifications. For users -looking to customize their keyboard's behavior, they can copy the stock `.keymap` file into their -user config directory, and customize the keymap to their liking. +so ZMK can produce a "stock" firmware for that keyboard without any further modifications. +When users complete the [user setup](../user-setup.mdx), the stock `.keymap` file is copied to the +user config directory, using which users [customize](../customization.md) the keymap to their liking. ## Behaviors From f987afc91870efdf47ade0a2a4beafe431bcac08 Mon Sep 17 00:00:00 2001 From: Cem Aksoylar Date: Wed, 22 Jan 2025 23:18:36 -0800 Subject: [PATCH 2/3] docs: Update layer diagram --- .../assets/features/keymaps/layer-diagram.png | Bin 53975 -> 0 bytes docs/docs/assets/keymaps/layer-diagram.png | Bin 0 -> 58607 bytes docs/docs/keymaps/index.mdx | 2 +- 3 files changed, 1 insertion(+), 1 deletion(-) delete mode 100644 docs/docs/assets/features/keymaps/layer-diagram.png create mode 100644 docs/docs/assets/keymaps/layer-diagram.png diff --git a/docs/docs/assets/features/keymaps/layer-diagram.png b/docs/docs/assets/features/keymaps/layer-diagram.png deleted file mode 100644 index 7b42daae87c7ac600d39c81252f7f1ab932ac334..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 53975 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

9^W zdcOPKS!MUj-W!^X9YI0c%=6tz3Ms6RJRq~ljsdniEhPpmt-Pkm!s34=Aa+<42+O zy&4bun@VJbFYNtso4JS{F!Ja*))#@z*!@2@6UN~!;(7K2aF0nVv`>2~J<98T-pUje z0}wAU@wu_&*{+ps;jRlhP7<1D=o0>KCpskED<5i0@a9=b3^%~8gE6tftgUD9N@fh9sM5grqHjvP`BJS#>z*IACRzsNidUKGnouGH~$z zN$uB1fWTJ{;>I`u{NRx^NFlxFAnQ?GgCS-dfOyh@!uFpa+=dJ*wE`-Jw+!@1gn6ba z4*E^-o>(}o{yPcyK7mNcKMBR5g&uya({kJUB}9kzNd^xNIzD*#TNJaGq2&J>FG?IS z=wVj#_gLNmP_#iEm~kHmoeEkxt{lZbxLWhY9Oqw4@m7=nn}|M&2F@GzC^Jp(aHAL!v1Do8w3F){FP*h7YE2GlS# zN{sh^E$3U&Vu^dEs3?%D{*w7{;5royjb8}$A3xsCf=6})Zj@ttA4A8|Sd+Da^D7Y&4>L;m zCJoGwQC|Y{pDbMmbf}1qbKV591mXtF8~-Cqwm_DC_L7DFJHs$Da4d@?tRvtL=HR_= zb3h}{fj>s*FE&rY<_%vvNH6}Qc`+V*(G^Yp0Qh5V@E$8KuzgKHa_5OoepMo>iD#y8 z`Tm`XD|9O4KUKIufD{hi!@>cYzyjVnmK2`aq=xwkcu8RYBRK`~l61vtU=QP9gRO+P zH$g-r2uYRF3mQGnYAaM}y(SHzx3Y!QtmGlsB!6ehU5xGk`UcpW9zI_2)fJ`((6; z7q2#mi~b%us!wuY`T`|8bX4*Tm@~L7tv)naPyPlcoEQ?4kS|YIh|~jkTi#V9SHFEwJ(kOGe=fl5Q<_b(tlr>01D#{FM2M9=G;4Ta_R-k^V{M5X+t51sM7 z|9i%(<=~8y;e+^pxBV4ELKbX0bFSGRjYd&4_QdAwtZMh$yvgp;*sSc)-8;tH4M#z* zi^|r?rC<|w3;D0{kAM278XwdiEp4iAcP2P(chjZXM22$Pa(#^ATfN5Dq~cn0>{FI$ zdXTGfS&pA!+!?Wh7W4TC(7{ws`L=rXrsUe+t+hmnMnRk~Z!eK%D7N`w}F#sbd$2!a*U$XVv{z0 zucy28#rMS014I#`BB(k}7#FbbMcAN32KxSec6GNqaf`J|{E2o`#UE5wMlE^_&sl_m z;c#pkMH%sHcHy6{|I>g`)HG@k-$oqZ%(cYf4J-xJ-m^QLYAyYhX;Ql2Pr(r(3YQPP zMH3sRC*deyiDGKElbaizIjW%1RiU9z?@!@e%qF0H^USvK!oSDkkSm_mMA06tg1dUw z^Q_ z_@wW3p)gu-^-Ry*C`37R;(=&4QcqW!T<$T4IpgwYyh4%;;uiOU)m+YRDv(l-FYP$I}1r%^6 zHF>}62|G%iBB8aQAHI;D94a85nsU*1H>$7`IXz9>jwB=J%PuIlR_+(LMwO326N^L3 z{Dq1JhQ`bH9_`N=qw{;y2OuOv;EGY{-D9`;4`o_oySp2^tkEPWZW$e0|)mm^+_+lQ|U!9B=8PDv= zW!PtOV1*xixpBnE?eKDWLoxtyHv&G~;d>T(!#IWT=j8$!XjSkk4Ln{+^@@%m^XsDF zNCm⩔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 NSxH5SLNS9E{|82zP0RoQ diff --git a/docs/docs/assets/keymaps/layer-diagram.png b/docs/docs/assets/keymaps/layer-diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..31ff14893a1edce528919dfc3e3d9a6cef82a816 GIT binary patch literal 58607 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

HlgKb?`HI+C_}B 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 literal 0 HcmV?d00001 diff --git a/docs/docs/keymaps/index.mdx b/docs/docs/keymaps/index.mdx index 41330181033..e29bd7c86c2 100644 --- a/docs/docs/keymaps/index.mdx +++ b/docs/docs/keymaps/index.mdx @@ -35,7 +35,7 @@ Like many mechanical keyboard firmwares, ZMK keymaps are composed of a collectio minimum of at least one layer that is the default, usually near the bottom of the "layer stack". Each layer in ZMK contains a set of bindings that bind a certain behavior to a certain key position in that layer. -| ![Diagram of three layers](../assets/features/keymaps/layer-diagram.png) | +| ![Diagram of three layers](../assets/keymaps/layer-diagram.png) | | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | | _A simplified diagram showing three layers. The layout of each layer is the same (they all contain four keys), but the behavior bindings within each layer can be different._ | From bd80531a585ca07dcc9c410b0d747a6564d6a40d Mon Sep 17 00:00:00 2001 From: Cem Aksoylar Date: Thu, 23 Jan 2025 09:54:29 -0800 Subject: [PATCH 3/3] Apply suggestions from code review Co-authored-by: Nicolas Munnich <98408764+Nick-Munnich@users.noreply.github.com> --- docs/docs/keymaps/index.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/docs/keymaps/index.mdx b/docs/docs/keymaps/index.mdx index e29bd7c86c2..016e98e80be 100644 --- a/docs/docs/keymaps/index.mdx +++ b/docs/docs/keymaps/index.mdx @@ -5,7 +5,7 @@ sidebar_label: Keymaps import KeymapExample from "../keymap-example.md"; -ZMK uses a declarative approach to keymaps, using the devicetree syntax to configure them in a `.keymap` file. +ZMK uses a declarative approach to keymaps, using devicetree syntax to configure them in a `.keymap` file. This declarative configuration defines the key mappings, behaviors used within them and the configuration of certain features. These keymaps can then be updated dynamically/at runtime using the [ZMK Studio](../features/studio.md) feature, which allows keymap modifications over USB or BLE. @@ -15,7 +15,7 @@ which allows keymap modifications over USB or BLE. All keyboard definitions (complete boards or shields) include the _default_ keymap for that keyboard, so ZMK can produce a "stock" firmware for that keyboard without any further modifications. When users complete the [user setup](../user-setup.mdx), the stock `.keymap` file is copied to the -user config directory, using which users [customize](../customization.md) the keymap to their liking. +user config directory, which can be used to [customize](../customization.md) the keymap to each user's liking. ## Behaviors