<h1 id="what%3F">
<a class="header-anchor-link" href="#what%3F" aria-hidden="true"></a> What?</h1>
<p>Macを使っているユーザー（特にUS配列のキーボードを使っている人）の中には、<br>
<a href="https://karabiner-elements.pqrs.org/" target="_blank" rel="nofollow noopener noreferrer">Karabiner Elements</a> を使って、特定のキー入力を別のキー入力として変換するように設定してる人も多いかと思います。<br>
（例: 「左のコマンドキーを単体で押した時に、入力ソースを英字入力に切り替える」など）</p>
<p>Karabinerではjsonファイルにこのようなルールを記述することでカスタムルールを作ることができるのですが、どのようにそれをimportできるのか分かりにくかったので、調べたことをメモしておきます。</p>
<h1 id="why%3F">
<a class="header-anchor-link" href="#why%3F" aria-hidden="true"></a> Why?</h1>
<p>そもそも筆者の場合は、下記のような事情がありました。</p>
<ul>
<li>Macを使っている</li>
<li>キーボードはUS配列</li>
<li>日本語・英語・中国語を使う（使用頻度はEn -&gt; Jp -&gt; Ch)</li>
<li>
<code>For Japanese （日本語環境向けの設定） (rev 6)</code> という設定を入れている
<ul>
<li>左右のコマンドキーをEn/Jpの切り替えにマッピングされている</li>
</ul>
</li>
<li><strong>中国語に切り替える場合は、入力ソースの切り替え(Cmd+Spaceにマップしている)をグルグルと回らなければいけない（※下図参照）</strong></li>
</ul>
<p><img src="https://storage.googleapis.com/zenn-user-upload/43035b57aeba001769d2af33.png" alt loading="lazy" class="md-img"></p>
<p>そこで、どうしても1回のキー入力で中国語に切り替えるルールが欲しかったのですが、<br>
<a href="https://ke-complex-modifications.pqrs.org/" target="_blank" rel="nofollow noopener noreferrer">公式のカスタムルール共有サイト</a>に公開されているカスタムルールの中に、自分の状況に適しているものが見つからなかったため、新しく作ることにしました。</p>
<p>なので、最終的なゴールとしては、</p>
<ul>
<li>左の⌘（コマンド）キー単体入力 -&gt; 英字入力</li>
<li>右の⌘（コマンド）キー単体入力 -&gt; 日本語入力</li>
<li>左の⌥（オプション）キー単体入力 -&gt; 中国語（簡体字）入力</li>
</ul>
<p>この3つを満たせることがゴールとなります。</p>
<h1 id="%E4%BD%9C%E6%88%90%E3%81%8B%E3%82%89%E5%85%AC%E9%96%8B%E3%81%BE%E3%81%A7">
<a class="header-anchor-link" href="#%E4%BD%9C%E6%88%90%E3%81%8B%E3%82%89%E5%85%AC%E9%96%8B%E3%81%BE%E3%81%A7" aria-hidden="true"></a> 作成から公開まで</h1>
<h2 id="1.-%E7%8B%AC%E8%87%AA%E3%83%AB%E3%83%BC%E3%83%AB%E3%82%92%E4%BD%9C%E3%82%8B">
<a class="header-anchor-link" href="#1.-%E7%8B%AC%E8%87%AA%E3%83%AB%E3%83%BC%E3%83%AB%E3%82%92%E4%BD%9C%E3%82%8B" aria-hidden="true"></a> 1. 独自ルールを作る</h2>
<p>公式のドキュメントがあんまり分かりやすくはなかったのですが、jsonに記述するべきルールはだいたい<a href="https://karabiner-elements.pqrs.org/docs/json/complex-modifications-manipulator-definition/" target="_blank" rel="nofollow noopener noreferrer">この辺</a>に書いてあります。</p>
<p>また、公式ではルールジェネレーターとして下記の2つが紹介されています。</p>
<ul>
<li><a href="https://github.com/yqrashawn/GokuRakuJoudo#usage" target="_blank" rel="nofollow noopener noreferrer">GokuRakuJoudo</a></li>
<li><a href="https://genesy.github.io/karabiner-complex-rules-generator/" target="_blank" rel="nofollow noopener noreferrer">Karabiner Complex Modification</a></li>
</ul>
<p>筆者の場合は、既存のルールのjsonファイルを見ながら、見よう見まねでなんとなく作りました。</p>
<h2 id="2.-%E3%83%AD%E3%83%BC%E3%82%AB%E3%83%AB%E3%81%A7%E5%8B%95%E4%BD%9C%E7%A2%BA%E8%AA%8D%E3%81%99%E3%82%8B">
<a class="header-anchor-link" href="#2.-%E3%83%AD%E3%83%BC%E3%82%AB%E3%83%AB%E3%81%A7%E5%8B%95%E4%BD%9C%E7%A2%BA%E8%AA%8D%E3%81%99%E3%82%8B" aria-hidden="true"></a> 2. ローカルで動作確認する</h2>
<p>作ったはいいものの、どのようにしてKarabiner Elementsに取り込むのか分かりませんでした。</p>
<p>なぜなら、KarabinerのGUI上では、下図のようにルール共有サイトからimportする方法しか存在していないからです。</p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/07d2624452e8411e03a5a46e.png" alt loading="lazy" class="md-img"></p>
<p>色々調べた結果、<br>
どうやら</p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash">~/.config/karabiner/assets/complex_modifications/
</code></pre></div><p>というディレクトリの下に配置されているjsonファイルを読んでいることがわかったので、<br>
CUIから手で <code>cp</code> して配置すると、無事に取り込むことができ、動作も確認することができました🎉</p>
<p>この時点で、自分の目的は達成できたのですが、</p>
<ul>
<li>毎回PCを購入し直す度にこの作業をするのが嫌なことと</li>
<li>もしかしたら世の中に同じようなルールを求めている人がいるかもしれないこと</li>
</ul>
<p>から一応、共有サイトに追加しようと思いました。</p>
<h2 id="3.-%E5%85%B1%E6%9C%89%E3%82%B5%E3%82%A4%E3%83%88%E3%81%AB%E8%BF%BD%E5%8A%A0%E3%81%99%E3%82%8B">
<a class="header-anchor-link" href="#3.-%E5%85%B1%E6%9C%89%E3%82%B5%E3%82%A4%E3%83%88%E3%81%AB%E8%BF%BD%E5%8A%A0%E3%81%99%E3%82%8B" aria-hidden="true"></a> 3. 共有サイトに追加する</h2>
<p><a href="https://ke-complex-modifications.pqrs.org/" target="_blank" rel="nofollow noopener noreferrer">共有サイト</a> にはimportするための機能は一通りあるのですが、どうやったらアップロードできるのか全然分かりませんでした。</p>
<p>色々探した結果、どうやら<a href="https://github.com/pqrs-org/KE-complex_modifications" target="_blank" rel="nofollow noopener noreferrer">このGitHubリポジトリ</a>でカスタムルールを管理していることが分かりました。</p>
<p>（READMEに書いてある通りですが）手順を簡単にまとめると、</p>
<ol>
<li>ソースコードをcloneする</li>
<li>
<code>.json</code> ファイルを指定されたディレクトリに追加する</li>
<li>検索インデックスするためのファイルがあるので、そこに追加したファイルへのパスを追加する</li>
<li>
<code>make build</code> する</li>
<li>
<code>make server</code> すると <code>http://localhost:8000</code> に共有サイトが立ち上がるので、そこで自分の追加したルールが存在することを確認する</li>
<li>リポジトリをforkする</li>
<li>作業内容をコミットしてupstreamに対してPRを作る（メンテナへの感謝の気持ちを忘れずに）</li>
</ol>
<h1 id="%E3%81%BE%E3%81%A8%E3%82%81">
<a class="header-anchor-link" href="#%E3%81%BE%E3%81%A8%E3%82%81" aria-hidden="true"></a> まとめ</h1>
<p>本記事執筆時点では<a href="https://github.com/pqrs-org/KE-complex_modifications/pull/919" target="_blank" rel="nofollow noopener noreferrer">PR</a>を作った直後で、このPRが取り込まれるかどうかも分からず、最終的な本番環境での動作確認まではできていないのですが、一応一通りの手順は記せたかと思います。</p>
<p>また、PRの行く末はさておいても、自分個人としては非常にペインの大きかった言語入力切り替えがスムーズになったことで、とても満足しています😊</p>
<h2 id="2021%2F08%2F21-%E8%BF%BD%E8%A8%98">
<a class="header-anchor-link" href="#2021%2F08%2F21-%E8%BF%BD%E8%A8%98" aria-hidden="true"></a> 2021/08/21 追記</h2>
<p><a href="https://github.com/pqrs-org/KE-complex_modifications/pull/919" target="_blank" rel="nofollow noopener noreferrer">PR</a>をマージしていただき、無事に公開されていることを確認できました🎉<br>
<img src="https://storage.googleapis.com/zenn-user-upload/2bc992762ef715cbb69f92a5.png" alt loading="lazy" class="md-img"></p>


Karabiner Elementsにカスタムルールを追加して公開するまでの方法

Discussion