Update Japanese newbs_getting_started.md (#12841)
shela
GitHub
parent
36d8d7df5a
commit
a726ada59b
|
|
@ -74,7 +74,7 @@ default.keymap: None -> default
|
||||||
|
|
||||||
qmk config compile
|
qmk config compile
|
||||||
|
|
||||||
### 単一キーの例
|
### 単一キーの例 :id=single-key-example
|
||||||
|
|
||||||
qmk config compile.keyboard
|
qmk config compile.keyboard
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -2,125 +2,182 @@
|
||||||
|
|
||||||
<!---
|
<!---
|
||||||
grep --no-filename "^[ ]*git diff" docs/ja/*.md | sh
|
grep --no-filename "^[ ]*git diff" docs/ja/*.md | sh
|
||||||
original document: 0.9.44:docs/newbs_getting_started.md
|
original document: 0.12.45:docs/newbs_getting_started.md
|
||||||
git diff 0.9.44 HEAD -- docs/newbs_getting_started.md | cat
|
git diff 0.12.45 HEAD -- docs/newbs_getting_started.md | cat
|
||||||
-->
|
-->
|
||||||
|
|
||||||
キーマップをビルドする前に、いくつかのソフトウェアをインストールしてビルド環境を構築する必要があります。
|
キーマップをビルドする前に、いくつかのソフトウェアをインストールしてビルド環境を構築する必要があります。
|
||||||
ファームウェアをコンパイルするキーボードの数に関わらず、この作業を一度だけ実行する必要があります。
|
ファームウェアをコンパイルするキーボードの数に関わらず、この作業を一度だけ実行する必要があります。
|
||||||
|
|
||||||
## 1. ソフトウェアのダウンロード
|
## 1. 前提条件
|
||||||
|
|
||||||
始めるために必要なソフトウェアがいくつかあります。
|
始めるために必要なソフトウェアがいくつかあります。
|
||||||
|
|
||||||
### テキストエディタ
|
* [テキストエディタ](ja/newbs_learn_more_resources.md#text-editor-resources)
|
||||||
|
* プレーンテキストファイルを編集して保存できるプログラムが必要です。多くの OS に付属するデフォルトのエディタはプレーンテキストファイルを保存しないため、選択したエディタがプレーンテキストファイルを保存することを確認する必要があります。
|
||||||
|
* [Toolbox (オプション)](https://github.com/qmk/qmk_toolbox)
|
||||||
|
* Windows と macOS で使える GUI を備えたプログラムで、カスタムキーボードのプログラミングとデバッグの両方ができます。
|
||||||
|
|
||||||
**プレーンテキスト** ファイルを編集して保存できるプログラムが必要です。
|
?> もし、Linux か Unix のコマンドを使ったことがない場合、こちらで基本的な概念や各種コマンドを学んでください。[これらの教材](ja/newbs_learn_more_resources.md#command-line-resources)で QMK を使うのに必要なことを学ぶことができます。
|
||||||
Windows の場合、メモ帳が使えます。Linux の場合、gedit が使えます。どちらもシンプルですが機能的なテキストエディタです。
|
|
||||||
macOS では、デフォルトのテキストエディットアプリに注意してください。_フォーマット_ メニューから _標準テキストにする_ を選択しない限り、プレーンテキストとして保存されません。
|
|
||||||
|
|
||||||
[Sublime Text](https://www.sublimetext.com/) や [VS Code](https://code.visualstudio.com/) のような専用のテキストエディタをダウンロードしてインストールすることもできます。これらのプログラムはコードを編集するために特別に作成されているため、これはプラットフォームに関係なくベストな方法です。
|
|
||||||
|
|
||||||
?> どのエディタを使えば良いか分からない場合、Laurence Bradford が書いたこの記事 [a great introduction](https://learntocodewith.me/programming/basics/text-editors/) を読んでください。
|
|
||||||
|
|
||||||
### QMK Toolbox
|
|
||||||
|
|
||||||
QMK Toolbox は、Windows と macOS で使える GUI を備えたプログラムで、カスタムキーボードのプログラミングとデバッグの両方ができます。
|
|
||||||
このプログラムは、キーボードに簡単にファームウェアを書き込んだり、出力されるデバッグメッセージを確認する際に、かけがえのないものであることがわかるでしょう。
|
|
||||||
|
|
||||||
[QMK Toolbox の最新版](https://github.com/qmk/qmk_toolbox/releases/latest)
|
|
||||||
|
|
||||||
* Windows 版: `qmk_toolbox.exe` (portable) または `qmk_toolbox_install.exe` (installer)
|
|
||||||
* macOS 版: `QMK.Toolbox.app.zip` (portable) または `QMK.Toolbox.pkg` (installer)
|
|
||||||
|
|
||||||
### Unix ライクな環境
|
|
||||||
|
|
||||||
Linux や macOS には既に実行可能な unix シェルが付属しています。ビルド環境を構築するだけで済みます。
|
|
||||||
|
|
||||||
Windows では、MSYS2 や WSL をインストールして、これらの環境を使う必要があります。MSYS2 の構築手順を以下に示します。
|
|
||||||
|
|
||||||
## 2. ビルド環境を準備する :id=set-up-your-environment
|
## 2. ビルド環境を準備する :id=set-up-your-environment
|
||||||
|
|
||||||
私たちは、QMK を可能な限り簡単に構築できるように努力しています。
|
私たちは、QMK を可能な限り簡単に構築できるように努力しています。Linux か Unix 環境を用意するだけで、QMK に残りをインストールさせることができます。
|
||||||
Linux か Unix 環境を用意するだけで、QMK に残りをインストールさせることができます。
|
|
||||||
|
|
||||||
?> もし、Linux か Unix のコマンドを使ったことがない場合、こちらで基本的な概念や各種コマンドを学んでください。これらの教材で QMK を使うのに必要なことを学ぶことができます:<br>
|
<!-- tabs:start -->
|
||||||
[Must Know Linux Commands](https://www.guru99.com/must-know-linux-commands.html)<br>
|
|
||||||
[Some Basic Unix Commands](https://www.tjhsst.edu/~dhyatt/superap/unixcmd.html)
|
|
||||||
|
|
||||||
### Windows
|
### ** Windows **
|
||||||
|
|
||||||
MSYS2 と Git と QMK CLI のインストールが必要です。
|
QMK は、MSYS2、CLI、および必要な全ての依存関係のバンドルを保守しています。また、正しい環境で直接起動するための便利な `QMK MSYS` ターミナルショートカットも提供しています。
|
||||||
|
|
||||||
[MSYS2 homepage](https://www.msys2.org) のインストール手順に従ってください。開いている MSYS2 の全ターミナル画面を閉じて、新しい MinGW 64-bit ターミナル画面を開きます。**注意: これはインストールが完了した時に開く MSYS ターミナルと同じ *ではありません*。**
|
#### 前提条件
|
||||||
|
|
||||||
|
[QMK MSYS](https://msys.qmk.fm/) をインストールする必要があります。最新リリースは[ここ](https://github.com/qmk/qmk_distro_msys/releases/latest)から入手できます。
|
||||||
|
|
||||||
|
または、MSYS2 を手動でインストールしたい場合、次のセクションでプロセスを説明します。
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary>手動インストール</summary>
|
||||||
|
|
||||||
|
?> `QMK MSYS` を使う場合、次のステップは無視してください。
|
||||||
|
|
||||||
|
#### 前提条件
|
||||||
|
|
||||||
|
MSYS2 と Git と Python をインストールする必要があります。https://www.msys2.org のインストール手順に従ってください。
|
||||||
|
|
||||||
|
MSYS2 をインストールしたら、開いている MSYS の全ターミナル画面を閉じて、新しい MinGW 64-bit ターミナル画面を開きます。
|
||||||
|
|
||||||
|
!> **注意:** MinGW 64-bit ターミナルは、インストールが完了した時に開く MSYS ターミナルと*同じではありません*。プロンプトには、「MSYS」ではなく、紫色のテキストで「MINGW64」と表示されます。違いについての詳細は[このページ](https://www.msys2.org/wiki/MSYS2-introduction/#subsystems)を参照してください。
|
||||||
|
|
||||||
それから、次のように実行します:
|
それから、次のように実行します:
|
||||||
|
|
||||||
pacman --needed --noconfirm --disable-download-timeout -S git mingw-w64-x86_64-toolchain mingw-w64-x86_64-python3-pip
|
pacman --needed --noconfirm --disable-download-timeout -S git mingw-w64-x86_64-toolchain mingw-w64-x86_64-python3-pip
|
||||||
python3 -m pip install qmk
|
|
||||||
|
|
||||||
### macOS
|
#### インストール
|
||||||
|
|
||||||
Homebrew のインストールが必要です。[Homebrew homepage](https://brew.sh) の手順に従ってください。
|
次のコマンドを実行して、QMK CLI をインストールします:
|
||||||
|
|
||||||
Homebrew をインストールした後で、以下のコマンドを実行します:
|
PYTHONUTF8=1 python3 -m pip install qmk
|
||||||
|
|
||||||
|
!> **訳注:** 現在、日本語版 Windows 環境では、環境変数として `PYTHONUTF8=1` を指定してインストールする必要があります。この環境変数を指定しない場合、システムのロケール設定が原因で一部の Python モジュールのインストールでエラーが発生します。この問題は該当モジュールのソースコードでは修正済みですが、配布モジュールはまだ修正されていません。
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
### ** macOS **
|
||||||
|
|
||||||
|
QMK は CLI と全ての必要な依存関係を自動的にインストールする Homebrew tap と formula を保守しています。
|
||||||
|
|
||||||
|
#### 前提条件
|
||||||
|
|
||||||
|
Homebrew のインストールが必要です。https://brew.sh の手順に従ってください。
|
||||||
|
|
||||||
|
#### インストール
|
||||||
|
|
||||||
|
次のコマンドを実行して、QMK CLI をインストールします:
|
||||||
|
|
||||||
brew install qmk/qmk/qmk
|
brew install qmk/qmk/qmk
|
||||||
|
|
||||||
### Linux
|
### ** Linux/WSL **
|
||||||
|
|
||||||
|
?> **WSL ユーザーへの注意**: デフォルトでは、インストールプロセスは QMK リポジトリを WSL ホームディレクトリに clone しますが、手動で clone した場合、Windows ファイルシステムではなく、WSL インスタンス内にある(つまり `/mnt` 内にない)ことを確認してください。これは、現在アクセスが[非常に遅い](https://github.com/microsoft/WSL/issues/4197)ためです。
|
||||||
|
|
||||||
|
#### 前提条件
|
||||||
|
|
||||||
Git と Python をインストールする必要があります。両方とも既にインストールされている可能性は高いですが、そうでない場合、次のコマンドのいずれかでそれらをインストールできます:
|
Git と Python をインストールする必要があります。両方とも既にインストールされている可能性は高いですが、そうでない場合、次のコマンドのいずれかでそれらをインストールできます:
|
||||||
|
|
||||||
* Debian / Ubuntu / Devuan: `sudo apt install git python3 python3-pip`
|
* Debian / Ubuntu / Devuan: `sudo apt install -y git python3-pip`
|
||||||
* Fedora / Red Hat / CentOS: `sudo yum install git python3 python3-pip`
|
* Fedora / Red Hat / CentOS: `sudo yum -y install git python3-pip`
|
||||||
* Arch / Manjaro: `sudo pacman -S git python python-pip python-setuptools libffi`
|
* Arch / Manjaro: `sudo pacman --needed --noconfirm -S git python-pip libffi`
|
||||||
|
* Void: `sudo xbps-install -y git python3-pip`
|
||||||
|
* Solus: `sudo eopkg -y install git python3`
|
||||||
|
* Sabayon: `sudo equo install dev-vcs/git dev-python/pip`
|
||||||
|
* Gentoo: `sudo emerge dev-vcs/git dev-python/pip`
|
||||||
|
|
||||||
グローバル CLI をインストールして、システムをブートストラップします:
|
#### インストール
|
||||||
|
|
||||||
`python3 -m pip install --user qmk` (Arch ベースのディストリビューションでは AUR から `qmk` パッケージを試すこともできます(**メモ**: コミュニティメンバーによって保守されています): `yay -S qmk`)
|
次のコマンドを実行して、QMK CLI をインストールします:
|
||||||
|
|
||||||
### FreeBSD
|
|
||||||
|
|
||||||
Git と Python をインストールする必要があります。両方とも既にインストールされている可能性は高いですが、そうでない場合、次のコマンドを実行してそれらをインストールします:
|
|
||||||
|
|
||||||
pkg install git python3
|
|
||||||
|
|
||||||
ローカルにインストールした Python パッケージが利用できるように、`$HOME/.local/bin` が `$PATH` に追加されていることを確認してください。
|
|
||||||
|
|
||||||
インストール完了後、QMK CLI をインストールできます:
|
|
||||||
|
|
||||||
python3 -m pip install --user qmk
|
python3 -m pip install --user qmk
|
||||||
|
|
||||||
|
#### コミュニティパッケージ
|
||||||
|
|
||||||
|
これらのパッケージはコミュニティメンバーによって保守されているため、最新ではないか、完全には機能しない可能性があります。問題が発生した場合は、それぞれのメンテナに報告してください。
|
||||||
|
|
||||||
|
Arch ベースのディストリビューションでは、公式リポジトリから CLI をインストールできます(注意: 執筆時点では、このパッケージは一部の依存関係をオプションとしてマークしていますが、そうではありません):
|
||||||
|
|
||||||
|
sudo pacman -S qmk
|
||||||
|
|
||||||
|
AUR から `qmk-git` パッケージを試すこともできます:
|
||||||
|
|
||||||
|
yay -S qmk-git
|
||||||
|
|
||||||
|
### ** FreeBSD **
|
||||||
|
|
||||||
|
#### インストール
|
||||||
|
|
||||||
|
次のコマンドを実行して、QMK CLI の FreeBSD パッケージをインストールします:
|
||||||
|
|
||||||
|
pkg install -g "py*-qmk"
|
||||||
|
|
||||||
|
注意: インストールの最後に表示された指示に従うことを忘れないでください(再度表示するには、`pkg info -Dg "py*-qmk"` を使ってください)。
|
||||||
|
|
||||||
|
<!-- tabs:end -->
|
||||||
|
|
||||||
## 3. QMK の設定を行う :id=set-up-qmk
|
## 3. QMK の設定を行う :id=set-up-qmk
|
||||||
|
|
||||||
|
<!-- tabs:start -->
|
||||||
|
|
||||||
|
### ** Windows **
|
||||||
|
|
||||||
QMK のインストール後に、このコマンドで設定できます:
|
QMK のインストール後に、このコマンドで設定できます:
|
||||||
|
|
||||||
qmk setup
|
qmk setup
|
||||||
|
|
||||||
ほとんどの場合、全てのプロンプトに Yes と答えます。
|
ほとんどの場合、全てのプロンプトに `y` と答えます。
|
||||||
|
|
||||||
|
### ** macOS **
|
||||||
|
|
||||||
|
QMK のインストール後に、このコマンドで設定できます:
|
||||||
|
|
||||||
|
qmk setup
|
||||||
|
|
||||||
|
ほとんどの場合、全てのプロンプトに `y` と答えます。
|
||||||
|
|
||||||
|
### ** Linux/WSL **
|
||||||
|
|
||||||
|
QMK のインストール後に、このコマンドで設定できます:
|
||||||
|
|
||||||
|
qmk setup
|
||||||
|
|
||||||
|
ほとんどの場合、全てのプロンプトに `y` と答えます。
|
||||||
|
|
||||||
?>**Debian、Ubuntu、それらの派生に関する注意**:
|
?>**Debian、Ubuntu、それらの派生に関する注意**:
|
||||||
次のようなエラーが表示される可能性があります: `bash: qmk: command not found`.
|
次のようなエラーが表示される可能性があります: `bash: qmk: command not found`.
|
||||||
これは Debian の Bash 4.4 リリースで導入された [バグ](https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=839155) で、`$HOME/.local/bin` が PATH から削除されました。このバグは後に Debian や Ubuntu で修正されました。
|
これは Debian の Bash 4.4 リリースで導入された[バグ](https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=839155)で、`$HOME/.local/bin` が PATH から削除されました。このバグは後に Debian や Ubuntu で修正されました。
|
||||||
残念なことに、Ubuntu はこのバグを再導入し、[まだ修正していません](https://bugs.launchpad.net/ubuntu/+source/bash/+bug/1588562)。
|
残念なことに、Ubuntu はこのバグを再導入し、[まだ修正していません](https://bugs.launchpad.net/ubuntu/+source/bash/+bug/1588562)。
|
||||||
幸い、修正は簡単です。これをあなたのユーザで実行します: `echo 'PATH="$HOME/.local/bin:$PATH"' >> $HOME/.bashrc && source $HOME/.bashrc`
|
幸い、修正は簡単です。これをあなたのユーザで実行します: `echo 'PATH="$HOME/.local/bin:$PATH"' >> $HOME/.bashrc && source $HOME/.bashrc`
|
||||||
|
|
||||||
?>**FreeBSD に関する注意**:
|
### ** FreeBSD **
|
||||||
まず、`root` 以外のユーザで `qmk setup` を実行することをお勧めしますが、これはおそらく `pkg` を使って基本システムにインストールする必要があるパッケージを識別します。
|
|
||||||
しかし、特権のないユーザで実行すると、インストールはおそらく失敗します。
|
|
||||||
基本的な依存関係を手動でインストールするには、`./util/qmk_install.sh` を `root` として実行するか、`sudo` をつけて実行します。
|
|
||||||
それが完了したら、`qmk setup` を再実行して設定と確認を完了させます。
|
|
||||||
|
|
||||||
?> 既に [GitHub の使いかた](ja/getting_started_github.md)を知っているなら、fork を作成し、`qmk setup <github_username>/qmk_firmware` を使って個人用の fork から clone することをお勧めします。この一文の意味が分からない場合、このメッセージは無視してかまいません。
|
QMK のインストール後に、このコマンドで設定できます:
|
||||||
|
|
||||||
|
qmk setup
|
||||||
|
|
||||||
|
ほとんどの場合、全てのプロンプトに `y` と答えます。
|
||||||
|
|
||||||
|
<!-- tabs:end -->
|
||||||
|
|
||||||
|
?> qmk ホームフォルダは、セットアップ時に `qmk setup -H <path>` を使って指定し、[cli 構成](ja/cli_configuration.md?id=single-key-example)と変数 `user.qmk_home` を使って変更できます。利用可能な全てのオプションについては、`qmk setup --help` を実行します。
|
||||||
|
|
||||||
|
?> 既に GitHub の使い方を知っている場合、[これらの手順に従うことをお勧めします](ja/getting_started_github.md)。そして `qmk setup <github_username>/qmk_firmware` を使って個人用の fork から clone します。この一文の意味が分からない場合、このメッセージは無視してかまいません。
|
||||||
|
|
||||||
## 4. ビルド環境の確認
|
## 4. ビルド環境の確認
|
||||||
|
|
||||||
これで QMK のビルド環境が用意できたので、キーボードのファームウェアをビルドできます。
|
これで QMK のビルド環境が用意できたので、キーボードのファームウェアをビルドできます。キーボードのデフォルトキーマップをビルドすることから始めます。次の形式のコマンドでビルドできるはずです:
|
||||||
キーボードのデフォルトキーマップをビルドすることから始めます。次の形式のコマンドでビルドできるはずです。
|
|
||||||
|
|
||||||
qmk compile -kb <keyboard> -km default
|
qmk compile -kb <keyboard> -km default
|
||||||
|
|
||||||
例えば、Clueboard 66% のファームウェアをビルドする場合:
|
例えば、Clueboard 66% のファームウェアをビルドする場合、次のようにします:
|
||||||
|
|
||||||
qmk compile -kb clueboard/66/rev3 -km default
|
qmk compile -kb clueboard/66/rev3 -km default
|
||||||
|
|
||||||
|
|
@ -152,5 +209,4 @@ QMK を初めて使うほとんどの人は、キーボードを1つしか持っ
|
||||||
|
|
||||||
# キーマップの作成
|
# キーマップの作成
|
||||||
|
|
||||||
これであなた専用のキーマップを作成する準備ができました！
|
これであなた専用のキーマップを作成する準備ができました！次は[初めてのファームウェアの構築](ja/newbs_building_firmware.md)で専用のキーマップを作成します。
|
||||||
次は [初めてのファームウェアの構築](ja/newbs_building_firmware.md) で専用のキーマップを作成します。
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue