docs/ja/newbs_getting_started.md

   1 # イントロダクション
   2
   3 <!---
   4   grep --no-filename "^[ ]*git diff" docs/ja/*.md | sh
   5   original document: 161d469:docs/newbs_getting_started.md
   6   git diff 161d469 HEAD -- docs/newbs_getting_started.md | cat
   7 -->
   8
   9 キーボードにはプロセッサが入っており、それはコンピュータに入っているものと大して違わないものです。
  10 このプロセッサでは、キーボードのボタンの押し下げの検出を担当しキーボードのどのボタンが押されている/離されているかのレポートをコンピュータに送信するソフトウェアが動作しています。
  11 QMK は、そのソフトウェアの役割を果たし、ボタンの押下を検出しその情報をホストコンピュータに渡します。
  12 カスタムキーマップを作るということは、キーボード上で動くプログラムを作るということなのです。
  13
  14 QMK は、簡単なことは簡単に、そして、難しいことを可能なことにすることで、あなたの手にたくさんのパワーをもたらします。
  15 パワフルなキーマップを作るためにプログラムを作成する方法を知る必要はありません。いくつかのシンプルな文法に従うだけで OK です。
  16
  17 # はじめに
  18
  19 キーマップをビルドする前に、いくつかのソフトウェアをインストールしてビルド環境を構築する必要があります。
  20 ファームウェアをコンパイルするキーボードの数に関わらず、この作業を一度だけ実行する必要があります。
  21
  22 もし、GUI で作業をしたい場合、オンラインで作業できる [QMK Configurator](https://config.qmk.fm) を使ってください。
  23 使い方は [オンライン GUI を使用して初めてのファームウェアを構築する](ja/newbs_building_firmware_configurator.md) を参照してください。
  24
  25 ## ソフトウェアのダウンロード
  26
  27 ### テキストエディタ
  28
  29 GUI を使わない場合、プレーンテキストを編集・保存できるエディタが必要です。
  30 Windows の場合、メモ帳が使えます。Linux の場合、gedit が使えます。
  31 どちらもシンプルですが機能的なテキストエディタです。
  32 macOS では、デフォルトのテキストエディットアプリに注意してください。_フォーマット_ メニューから _標準テキストにする_ を選択しない限り、プレーンテキストとして保存されません。
  33
  34 [Sublime Text](https://www.sublimetext.com/) や [VS Code](https://code.visualstudio.com/) のような専用のテキストエディタをダウンロードしてインストールすることもできます。これらのプログラムはコードを編集するために特別に作成されているため、これはプラットフォームに関係なくベストな方法です。
  35
  36 ?> どのエディタを使えば良いか分からない場合、Laurence Bradford が書いたこの記事 [a great introduction](https://learntocodewith.me/programming/basics/text-editors/) を読んでください。
  37
  38 ### QMK Toolbox
  39
  40 QMK Toolbox は、Windows と macOS で使える GUI を備えたプログラムで、カスタムキーボードのプログラミングとデバッグの両方ができます。
  41 このプログラムは、キーボードに簡単にファームウェアを書き込んだり、出力されるデバッグメッセージを確認する際に、かけがえのないものであることがわかるでしょう。
  42
  43 [QMK Toolbox の最新版](https://github.com/qmk/qmk_toolbox/releases/latest)
  44
  45 * Windows 版: `qmk_toolbox.exe` (portable) または `qmk_toolbox_install.exe` (installer)
  46 * macOS 版: `QMK.Toolbox.app.zip` (portable) または `QMK.Toolbox.pkg` (installer)
  47
  48 ## 環境構築 :id=set-up-your-environment
  49
  50 私たちは、QMK を可能な限り簡単に構築できるように努力しています。
  51 Linux か Unix 環境を用意するだけで、QMK に残りをインストールさせることができます。
  52
  53 ?> もし、Linux か Unix のコマンドを使ったことがない場合、こちらで基本的な概念や各種コマンドを学んでください。これらの教材で QMK を使うのに必要なことを学ぶことができます。
  54
  55 [Must Know Linux Commands](https://www.guru99.com/must-know-linux-commands.html)<br>
  56 [Some Basic Unix Commands](https://www.tjhsst.edu/~dhyatt/superap/unixcmd.html)
  57
  58 ### Windows
  59
  60 MSYS2 と Git のインストールが必要です。
  61
  62 * [MSYS2 homepage](http://www.msys2.org) の手順に従って MSYS2 をインストールします。
  63 * 開いている MSYS2 の全ターミナル画面を閉じて、新しい MSYS2 MinGW 64-bit のターミナル画面を開きます。
  64 * `pacman -S git` を実行して Git をインストールします。
  65
  66 ### macOS
  67
  68 [Homebrew homepage](https://brew.sh) の手順に従って Homebrew をインストールしてください。
  69
  70 Homebrew をインストールしたら、以下の _QMK の設定_ に進んでください。そのステップでは、他のパッケージをインストールするスクリプトを実行します。
  71
  72 ### Linux
  73
  74 Git のインストールが必要です。既にインストールされている可能性は高いですが、そうでない場合、次のコマンドでインストールできます。
  75
  76 * Debian / Ubuntu / Devuan: `apt-get install git`
  77 * Fedora / Red Hat / CentOS: `yum install git`
  78 * Arch: `pacman -S git`
  79
  80 ?> 全てのプラットフォームにおいて、Docker を使うことも可能です。[詳細はこちらをクリックしてください](ja/getting_started_build_tools.md#docker)。
  81
  82 ## QMK の設定 :id=set-up-qmk
  83
  84 Linux/Unix 環境が準備できたら QMK のダウンロードの準備は完了です。Git を使用して QMK のリポジトリを「クローン」することで QMK をダウンロードします。ターミナルか MSYS2 MinGW ウィンドウを開いて、このガイドの残りの部分では開いたままにします。そのウィンドウ内で、次の2つのコマンドを実行します。
  85
  86 ```shell
  87 git clone --recurse-submodules https://github.com/qmk/qmk_firmware.git
  88 cd qmk_firmware
  89 ```
  90
  91 ?> 既に [GitHub の使いかた](ja/getting_started_github.md)を知っているなら、clone ではなく fork を勧めます。この一文の意味が分からない場合、このメッセージは無視してかまいません。
  92
  93 QMK には、必要な残りの設定を手助けするスクリプトが含まれています。
  94 セットアップ作業を完了させるため、次のコマンドを実行します。
  95
  96     util/qmk_install.sh
  97
  98 ## ビルド環境の確認
  99
 100 これで QMK のビルド環境が用意できましたので、キーボードのファームウェアをビルドできます。
 101 キーボードのデフォルトキーマップをビルドすることから始めます。次の形式のコマンドでビルドできるはずです。
 102
 103     make <keyboard>:default
 104
 105 例）Clueboard 66% のファームウェアをビルドする
 106
 107     make clueboard/66/rev3:default
 108
 109 大量の出力の最後に次のように出力されると完了です。
 110
 111 ```
 112 Linking: .build/clueboard_66_rev3_default.elf                                     [OK]
 113 Creating load file for flashing: .build/clueboard_66_rev3_default.hex             [OK]
 114 Copying clueboard_66_rev3_default.hex to qmk_firmware folder                      [OK]
 115 Checking file size of clueboard_66_rev3_default.hex                               [OK]
 116  * The firmware size is fine - 26356/28672 (2316 bytes free)
 117 ```
 118
 119 # キーマップの作成
 120
 121 これであなた専用のキーマップを作成する準備ができました！
 122 次は [Building Your First Firmware](ja/newbs_building_firmware.md) で専用のキーマップを作成します。