<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="eo">
    <title>Antono Vasiljev - keebs</title>
    <subtitle>Trivialaĵoj pri programado</subtitle>
    <link rel="self" type="application/atom+xml" href="https://antono.info/eo/tags/keebs/atom.xml"/>
    <link rel="alternate" type="text/html" href="https://antono.info"/>
    <generator uri="https://www.getzola.org/">Zola</generator>
    <updated>2026-06-25T13:34:21+00:00</updated>
    <id>https://antono.info/eo/tags/keebs/atom.xml</id>
    <entry xml:lang="eo">
        <title>Unu floko por konstrui ilin ĉiujn: kiel mi mastrumas 5 dividitajn klavarojn per Nix</title>
        <published>2026-06-25T13:26:52+00:00</published>
        <updated>2026-06-25T13:34:21+00:00</updated>
        
        <author>
          <name>Unknown</name>
        </author>
        
        <link rel="alternate" type="text/html" href="https://antono.info/eo/blog/2026/06/25/keebs-nix/"/>
        <id>https://antono.info/eo/blog/2026/06/25/keebs-nix/</id>
        
        <content type="html" xml:base="https://antono.info/eo/blog/2026/06/25/keebs-nix/">&lt;h2 id=&quot;mia-historio-kun-mekanikaj-klavaroj&quot;&gt;Mia historio kun mekanikaj klavaroj&lt;/h2&gt;
&lt;p&gt;Ĉio komenciĝis en decembro 2022. Mi aĉetis Dao-n — 42-klavan dividitan klavaron (&lt;em&gt;split&lt;/em&gt;) kun kolona deŝovo, kiu funkcias per &lt;a rel=&quot;external&quot; href=&quot;https://zmk.dev&quot;&gt;ZMK&lt;/a&gt; — kaj jen. Mi estis kaptita!&lt;/p&gt;
&lt;p&gt;Estas io en dividita klavaro, kio rekabligas vian pensadon pri tajpado. Viaj manoj ĉesas etendiĝi. Tavoloj anstataŭas la ciferan vicon, la simbolan vicon, la navigan blokon. La klavmapo fariĝas persona artefakto, kiun vi agordas dum monatoj. Kaj kiam vi jam agordis unu klavaron, vi volas alian por agordi.&lt;/p&gt;
&lt;p&gt;Tri jarojn kaj duonon poste mi posedas &lt;strong&gt;kvin&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Ergonaut One — dividita, kun kolona deŝovo (Seeeduino XIAO BLE + ŝildo)&lt;/li&gt;
&lt;li&gt;HolySwitch TK44 — unukorpa klavaro kun dividita aranĝo (&lt;em&gt;monosplit&lt;/em&gt;; propra plato)&lt;/li&gt;
&lt;li&gt;Mriya46 — dividita, kun kolona deŝovo (du propraj platoj kun nRF52840)&lt;/li&gt;
&lt;li&gt;Dao — tiu, per kiu ĉio komenciĝis, 42-klava dividita (+ ZMK Studio)&lt;/li&gt;
&lt;li&gt;Charybdis Mini — 34-klava dividita kun spurbulo&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Kvin klavaroj — tio estas mirinda.&lt;/p&gt;
&lt;p&gt;Sed kvin klavaroj estas ankaŭ problemo de agordo-mastrumado.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://antono.info/eo/blog/2026/06/25/keebs-nix/489949bc-5358-4de4-b946-2b2e2012ef72.jpeg&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;Ĉiu ZMK-klavaro volas propran deponejon &lt;code&gt;zmk-config&lt;/code&gt;. La komunuma laborfluo estas bone tretita kaj, sincere dirite, afabla al komencantoj:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Forku ies deponejon &lt;code&gt;*-zmk-config&lt;/code&gt; ĉe GitHub.&lt;/li&gt;
&lt;li&gt;Redaktu la dosieron &lt;code&gt;.keymap&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Puŝu.&lt;/li&gt;
&lt;li&gt;GitHub Actions legas &lt;code&gt;build.yaml&lt;/code&gt;, lanĉas rulilon (&lt;em&gt;runner&lt;/em&gt;), klonas Zephyr + ZMK, kompilas kaj alŝutas la artefaktojn &lt;code&gt;.uf2&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Elŝutu la zip-arkivon, malpaku ĝin, skribu la mikroprogramon en ĉiun duonon.&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;Tiu laborfluo taŭgas por komencantoj, sed ĝi havas kelkajn problemojn:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Ĉiu ŝanĝeto — eĉ korekto de unu klavkodo — signifas: enmeto (&lt;em&gt;commit&lt;/em&gt;) → puŝo → atendi, ĝis la rulilo klonos Zephyr de nulo → elŝuti la zip-arkivon → malpaki → skribi la mikroprogramon. Minutoj por unu rondiro pro unusigna ŝanĝo.&lt;/li&gt;
&lt;li&gt;Kvin deponejoj, kvin forkoj, kvin historioj. Ĉiu klavaro estas aparta forko, ĉiu iom post iom forfluas de sia fonto (&lt;em&gt;upstream&lt;/em&gt;), ĉiu kun siaj strangaĵoj. Por unuecigi ĉiujn kvin klavmapojn al sama aranĝo necesis kvin tirpetoj (&lt;em&gt;PR&lt;/em&gt;) en kvin lokoj.&lt;/li&gt;
&lt;li&gt;Ne reprodukteble. „Ĝi konstruiĝis pasintmonate“ ne samas al „hodiaŭ ĝi konstruas la samajn bajtojn“. La branĉo &lt;code&gt;main&lt;/code&gt; de ZMK moviĝas antaŭen, ruliloj ŝanĝiĝas, kaj iun belan tagon via agordo simple ne plu kompiliĝas. Ĝuste tiu lasta punkto mordis min. ZMK &lt;code&gt;main&lt;/code&gt; migris al **Hardware Model v2** de Zephyr, kiu renomis ĝuste tiujn platojn, de kiuj dependas miaj agordoj (seeeduino_xiao_ble → xiao_ble, nice_nano_v2 → nice_nano). Agordoj, kiuj bone konstruiĝis, subite ne plu. La laborfluo „CI + forko“ ne havas respondon al „fiksu la tutan mondon“.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;keebs-nix-unu-floko-por-konstrui-ilin-ciujn&quot;&gt;keebs-nix: unu floko por konstrui ilin ĉiujn&lt;/h2&gt;
&lt;p&gt;Nix ja havas respondon al „fiksu la tutan mondon“. Do mi kreis &lt;a rel=&quot;external&quot; href=&quot;https://github.com/antono/keebs-nix&quot;&gt;keebs-nix&lt;/a&gt; — unu memstaran flokon (&lt;em&gt;flake&lt;/em&gt;), kiu konstruas la mikroprogramojn por ĉiuj kvin klavaroj, surbaze de &lt;a rel=&quot;external&quot; href=&quot;https://github.com/lilyinstarlight/zmk-nix&quot;&gt;zmk-nix&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;La kompleta ZMK-agordo de ĉiu klavaro — &lt;code&gt;west.yml&lt;/code&gt;, &lt;code&gt;boards/&lt;/code&gt;, klavmapoj, &lt;code&gt;.conf&lt;/code&gt; — estas laŭvorte &lt;strong&gt;enkopiita&lt;/strong&gt; (&lt;em&gt;vendored&lt;/em&gt;) en ĉi tiun deponejon. Neniuj forkoj, neniuj eksteraj agordaj deponejoj, neniuj submoduloj. La floko havas ĝuste du enigojn: &lt;code&gt;nixpkgs&lt;/code&gt; kaj &lt;code&gt;zmk-nix&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id=&quot;kion-la-floko-faras&quot;&gt;Kion la floko faras&lt;/h2&gt;
&lt;p&gt;Ĝi konstruas ĉion per unu komando.&lt;/p&gt;
&lt;pre class=&quot;giallo&quot; style=&quot;color-scheme: light dark; color: light-dark(#24292E, #E1E4E8); background-color: light-dark(#FFFFFF, #24292E);&quot; &gt;&lt;code data-lang=&quot;shellscript&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span style=&quot;color: light-dark(#6F42C1, #B392F0);&quot;&gt;nix&lt;/span&gt;&lt;span style=&quot;color: light-dark(#032F62, #9ECBFF);&quot;&gt; build&lt;/span&gt;&lt;span style=&quot;color: light-dark(#6A737D, #6A737D);&quot;&gt;               #&lt;/span&gt;&lt;span style=&quot;color: light-dark(#6A737D, #6A737D);&quot;&gt; all firmware → ./result (combined .uf2 dir)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span style=&quot;color: light-dark(#6F42C1, #B392F0);&quot;&gt;nix&lt;/span&gt;&lt;span style=&quot;color: light-dark(#032F62, #9ECBFF);&quot;&gt; build&lt;/span&gt;&lt;span style=&quot;color: light-dark(#032F62, #9ECBFF);&quot;&gt; .#dao&lt;/span&gt;&lt;span style=&quot;color: light-dark(#6A737D, #6A737D);&quot;&gt;         #&lt;/span&gt;&lt;span style=&quot;color: light-dark(#6A737D, #6A737D);&quot;&gt; or just one&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;La rezulto estas unu dosierujo kun stabilaj, homlegeblaj dosiernomoj — ne plu necesas fosi inter artefaktoj &lt;code&gt;zmk_left.uf2&lt;/code&gt;, scivolante, de kiu klavaro ili venis:&lt;/p&gt;
&lt;pre class=&quot;giallo&quot; style=&quot;color-scheme: light dark; color: light-dark(#24292E, #E1E4E8); background-color: light-dark(#FFFFFF, #24292E);&quot; &gt;&lt;code data-lang=&quot;plain&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;ergonaut_one_left.uf2   ergonaut_one_right.uf2   ergonaut_one_settings_reset.uf2&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;tk44.uf2&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;mriya46_left.uf2        mriya46_right.uf2        mriya46_settings_reset.uf2&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;dao_left.uf2            dao_right.uf2            dao_studio_left.uf2  ...&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;charybdis_mini_left.uf2 charybdis_mini_right.uf2 charybdis_mini_settings_reset.uf2&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Ĝi skribas la mikroprogramon rekte el la komandlinio.&lt;/p&gt;
&lt;pre class=&quot;giallo&quot; style=&quot;color-scheme: light dark; color: light-dark(#24292E, #E1E4E8); background-color: light-dark(#FFFFFF, #24292E);&quot; &gt;&lt;code data-lang=&quot;shellscript&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span style=&quot;color: light-dark(#6F42C1, #B392F0);&quot;&gt;nix&lt;/span&gt;&lt;span style=&quot;color: light-dark(#032F62, #9ECBFF);&quot;&gt; run&lt;/span&gt;&lt;span style=&quot;color: light-dark(#032F62, #9ECBFF);&quot;&gt; .#flash-dao&lt;/span&gt;&lt;span style=&quot;color: light-dark(#6A737D, #6A737D);&quot;&gt;        #&lt;/span&gt;&lt;span style=&quot;color: light-dark(#6A737D, #6A737D);&quot;&gt; prompts for left, then right&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span style=&quot;color: light-dark(#6F42C1, #B392F0);&quot;&gt;nix&lt;/span&gt;&lt;span style=&quot;color: light-dark(#032F62, #9ECBFF);&quot;&gt; run&lt;/span&gt;&lt;span style=&quot;color: light-dark(#032F62, #9ECBFF);&quot;&gt; .#flash-tk44&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span style=&quot;color: light-dark(#6F42C1, #B392F0);&quot;&gt;nix&lt;/span&gt;&lt;span style=&quot;color: light-dark(#032F62, #9ECBFF);&quot;&gt; run&lt;/span&gt;&lt;span style=&quot;color: light-dark(#032F62, #9ECBFF);&quot;&gt; .#flash-dao-reset&lt;/span&gt;&lt;span style=&quot;color: light-dark(#6A737D, #6A737D);&quot;&gt;  #&lt;/span&gt;&lt;span style=&quot;color: light-dark(#6A737D, #6A737D);&quot;&gt; settings reset, built on nice_nano_v2&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Ĝi desegnas diagramojn de la klavmapoj. La README de ĉiu klavaro enhavas SVG-bildon de la aranĝo, generitan de &lt;a rel=&quot;external&quot; href=&quot;https://github.com/caksoylar/keymap-drawer&quot;&gt;keymap-drawer&lt;/a&gt; rekte el la enkopiita klavmapo:&lt;/p&gt;
&lt;pre class=&quot;giallo&quot; style=&quot;color-scheme: light dark; color: light-dark(#24292E, #E1E4E8); background-color: light-dark(#FFFFFF, #24292E);&quot; &gt;&lt;code data-lang=&quot;shellscript&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span style=&quot;color: light-dark(#6F42C1, #B392F0);&quot;&gt;nix&lt;/span&gt;&lt;span style=&quot;color: light-dark(#032F62, #9ECBFF);&quot;&gt; run&lt;/span&gt;&lt;span style=&quot;color: light-dark(#032F62, #9ECBFF);&quot;&gt; .#draw-keymaps&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;img src=&quot;https://antono.info/eo/blog/2026/06/25/keebs-nix/d9d57029-2886-4492-b7db-c6b844a8f01b.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;Tiel la dokumentaro ne povas forflui de la mikroprogramo — ĝi estas analizata el la sama dosiero &lt;code&gt;.keymap&lt;/code&gt;, kiun uzas la konstruado.&lt;/p&gt;
&lt;h2 id=&quot;kial-nix-estas-la-gusta-ilo-por-tio&quot;&gt;Kial Nix estas la ĝusta ilo por tio&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Reprodukteblo — vera.&lt;/strong&gt; La enkopiitaj dosieroj west.yml fiksas ZMK je v0.3-branch plus Zephyr 3.5 — la konate bona revizio de antaŭ HWMv2. Tio tute evitas la rompiĝon pro la renomitaj platoj. La konstruo, kiu funkcias hodiaŭ, donos identajn bajtojn ankaŭ venontjare. Nix ne &lt;em&gt;klopodas&lt;/em&gt; esti reproduktebla; tio estas ĝia tuta fundamento.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Unu komuna elŝuto de dependaĵoj.&lt;/strong&gt; Ĉiuj kvin agordoj enhavas bajte identan west.yml, do anstataŭ ke ĉiu klavaro de nulo klonu plurgigabajtajn arbojn de Zephyr kaj ZMK, unu derivaĵo kun fiksita eligo (&lt;em&gt;fixed-output derivation&lt;/em&gt;) elŝutas la West-dependaĵojn unufoje, kaj ĉiu klavaro reuzas ilin. Unu haketo en flake.nix kovras la tutan aron. La elŝuto eĉ faras malprofundan, mallarĝan ĝisdatigon kun profundo 1, do per malrapida konekto ĝi tiras datumojn dum minutoj anstataŭ horoj — kaj eltenas la kapricajn rekomencigojn de HTTP/2-fluoj ĉe GitHub dum la granda klonado.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Rapida loka ciklo „ŝanĝi — skribi“.&lt;/strong&gt; Redaktu klavmapon, rulu nix build, rulu nix flash. Neniu puŝo, neniu rulilo, neniu zip-arkivo. La dependaĵoj estas en la kaŝmemoro, do rekonstruoj estas rapidaj. En la ĉiutaga laboro tio estas la plej granda gajno kompare kun la ciklo „CI + forko“.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Aldoni klavaron — unu linio.&lt;/strong&gt; Novaj platoj iras en la dosierujon keyboards, plus unu ero en la mapo firmwareOutputs. La kunpaka logiko trovas per ĵokeraj ŝablonoj (&lt;em&gt;glob&lt;/em&gt;) la realajn uf2-eligaĵojn de ĉiu konstruo kaj renomas ilin laŭ ĝenerala skemo, do kaj dividitaj klavaroj kaj platoj kun unu sola mikroprogramo simple funkcias — neniuj dosiernomoj fiksitaj en la kodo.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Memstareco.&lt;/strong&gt; Ĉar ĉiu agordo estas enkopiita, ne nur referencita, nenio povas malfreŝiĝi sub miaj piedoj. La Dao eĉ enkopias la difinon de sia plato el la ZMK-modulo ergonautkb anstataŭ tiri ĝin per west.yml, do ĝi estas same memstara kiel la ceteraj.&lt;/p&gt;
</content>
        
    </entry>
</feed>
