aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorshela <shelaf@users.noreply.github.com>2020-08-01 10:53:35 +0900
committerGitHub <noreply@github.com>2020-07-31 18:53:35 -0700
commit3f2521115d7d6e2bb5e221c34a636f9e5af80358 (patch)
treeea51402790dce4321c75e94b35aabcd71bf6830a /docs
parent0d405ad38e25641fbdbbeedbc411c1d69a8980b8 (diff)
downloadqmk_firmware-3f2521115d7d6e2bb5e221c34a636f9e5af80358.tar.gz
qmk_firmware-3f2521115d7d6e2bb5e221c34a636f9e5af80358.zip
[Docs] Update Japanese translation of newbs_getting_started.md. (#9813)
Diffstat (limited to 'docs')
-rw-r--r--docs/ja/newbs_getting_started.md142
1 files changed, 88 insertions, 54 deletions
diff --git a/docs/ja/newbs_getting_started.md b/docs/ja/newbs_getting_started.md
index 2e283840c..05608bf87 100644
--- a/docs/ja/newbs_getting_started.md
+++ b/docs/ja/newbs_getting_started.md
@@ -1,34 +1,22 @@
1# イントロダクション 1# QMK ç’°å¢ƒã®æ§‹ç¯‰
2 2
3<!--- 3<!---
4 grep --no-filename "^[ ]*git diff" docs/ja/*.md | sh 4 grep --no-filename "^[ ]*git diff" docs/ja/*.md | sh
5 original document: 161d469:docs/newbs_getting_started.md 5 original document: 0.9.44:docs/newbs_getting_started.md
6 git diff 161d469 HEAD -- docs/newbs_getting_started.md | cat 6 git diff 0.9.44 HEAD -- docs/newbs_getting_started.md | cat
7--> 7-->
8 8
9キーボードã«ã¯ãƒ—ロセッサãŒå…¥ã£ã¦ãŠã‚Šã€ãれã¯ã‚³ãƒ³ãƒ”ュータã«å…¥ã£ã¦ã„ã‚‹ã‚‚ã®ã¨å¤§ã—ã¦é•ã‚ãªã„ã‚‚ã®ã§ã™ã€‚
10ã“ã®ãƒ—ロセッサã§ã¯ã€ã‚­ãƒ¼ãƒœãƒ¼ãƒ‰ã®ãƒœã‚¿ãƒ³ã®æŠ¼ã—下ã’ã®æ¤œå‡ºã‚’担当ã—キーボードã®ã©ã®ãƒœã‚¿ãƒ³ãŒæŠ¼ã•れã¦ã„ã‚‹/離ã•れã¦ã„ã‚‹ã‹ã®ãƒ¬ãƒãƒ¼ãƒˆã‚’コンピュータã«é€ä¿¡ã™ã‚‹ã‚½ãƒ•トウェアãŒå‹•作ã—ã¦ã„ã¾ã™ã€‚
11QMK ã¯ã€ãã®ã‚½ãƒ•トウェアã®å½¹å‰²ã‚’æžœãŸã—ã€ãƒœã‚¿ãƒ³ã®æŠ¼ä¸‹ã‚’検出ã—ãã®æƒ…å ±ã‚’ãƒ›ã‚¹ãƒˆã‚³ãƒ³ãƒ”ãƒ¥ãƒ¼ã‚¿ã«æ¸¡ã—ã¾ã™ã€‚
12カスタムキーマップを作るã¨ã„ã†ã“ã¨ã¯ã€ã‚­ãƒ¼ãƒœãƒ¼ãƒ‰ä¸Šã§å‹•ãプログラムを作るã¨ã„ã†ã“ã¨ãªã®ã§ã™ã€‚
13
14QMK ã¯ã€ç°¡å˜ãªã“ã¨ã¯ç°¡å˜ã«ã€ãã—ã¦ã€é›£ã—ã„ã“ã¨ã‚’å¯èƒ½ãªã“ã¨ã«ã™ã‚‹ã“ã¨ã§ã€ã‚ãªãŸã®æ‰‹ã«ãŸãã•ã‚“ã®ãƒ‘ワーをもãŸã‚‰ã—ã¾ã™ã€‚
15パワフルãªã‚­ãƒ¼ãƒžãƒƒãƒ—を作るãŸã‚ã«ãƒ—ログラムを作æˆã™ã‚‹æ–¹æ³•を知る必è¦ã¯ã‚りã¾ã›ã‚“。ã„ãã¤ã‹ã®ã‚·ãƒ³ãƒ—ãƒ«ãªæ–‡æ³•ã«å¾“ã†ã ã‘ã§ OK ã§ã™ã€‚
16
17# ã¯ã˜ã‚ã«
18
19キーマップをビルドã™ã‚‹å‰ã«ã€ã„ãã¤ã‹ã®ã‚½ãƒ•トウェアをインストールã—ã¦ãƒ“ルド環境を構築ã™ã‚‹å¿…è¦ãŒã‚りã¾ã™ã€‚ 9キーマップをビルドã™ã‚‹å‰ã«ã€ã„ãã¤ã‹ã®ã‚½ãƒ•トウェアをインストールã—ã¦ãƒ“ルド環境を構築ã™ã‚‹å¿…è¦ãŒã‚りã¾ã™ã€‚
20ファームウェアをコンパイルã™ã‚‹ã‚­ãƒ¼ãƒœãƒ¼ãƒ‰ã®æ•°ã«é–¢ã‚らãšã€ã“ã®ä½œæ¥­ã‚’一度ã ã‘実行ã™ã‚‹å¿…è¦ãŒã‚りã¾ã™ã€‚ 10ファームウェアをコンパイルã™ã‚‹ã‚­ãƒ¼ãƒœãƒ¼ãƒ‰ã®æ•°ã«é–¢ã‚らãšã€ã“ã®ä½œæ¥­ã‚’一度ã ã‘実行ã™ã‚‹å¿…è¦ãŒã‚りã¾ã™ã€‚
21 11
22ã‚‚ã—ã€GUI ã§ä½œæ¥­ã‚’ã—ãŸã„å ´åˆã€ã‚ªãƒ³ãƒ©ã‚¤ãƒ³ã§ä½œæ¥­ã§ãã‚‹ [QMK Configurator](https://config.qmk.fm) を使ã£ã¦ãã ã•ã„。 12## 1. ソフトウェアã®ãƒ€ã‚¦ãƒ³ãƒ­ãƒ¼ãƒ‰
23ä½¿ã„æ–¹ã¯ [オンライン GUI を使用ã—ã¦åˆã‚ã¦ã®ãƒ•ァームウェアを構築ã™ã‚‹](ja/newbs_building_firmware_configurator.md) ã‚’å‚ç…§ã—ã¦ãã ã•ã„。
24 13
25## ソフトウェアã®ãƒ€ã‚¦ãƒ³ãƒ­ãƒ¼ãƒ‰ 14å§‹ã‚ã‚‹ãŸã‚ã«å¿…è¦ãªã‚½ãƒ•トウェアãŒããã¤ã‹ã‚りã¾ã。
26 15
27### テキストエディタ 16### テキストエディタ
28 17
29GUI を使ã‚ãªã„å ´åˆã€ãƒ—レーンテキストを編集・ä¿å­˜ã§ãるエディタãŒå¿…è¦ã§ã™ã€‚ 18**プレーンテキスト** ファイルを編集ã—ã¦ä¿å­˜ã§ãるプログラムãŒå¿…è¦ã§ã™ã€‚
30Windows ã®å ´åˆã€ãƒ¡ãƒ¢å¸³ãŒä½¿ãˆã¾ã™ã€‚Linux ã®å ´åˆã€gedit ãŒä½¿ãˆã¾ã™ã€‚ 19Windows ã®å ´åˆã€ãƒ¡ãƒ¢å¸³ãŒä½¿ãˆã¾ã™ã€‚Linux ã®å ´åˆã€gedit ãŒä½¿ãˆã¾ã™ã€‚ã©ã¡ã‚‰ã‚‚シンプルã§ã™ãŒæ©Ÿèƒ½çš„ãªãƒ†ã‚­ã‚¹ãƒˆã‚¨ãƒ‡ã‚£ã‚¿ã§ã™ã€‚
31ã©ã¡ã‚‰ã‚‚シンプルã§ã™ãŒæ©Ÿèƒ½çš„ãªãƒ†ã‚­ã‚¹ãƒˆã‚¨ãƒ‡ã‚£ã‚¿ã§ã™ã€‚
32macOS ã§ã¯ã€ãƒ‡ãƒ•ォルトã®ãƒ†ã‚­ã‚¹ãƒˆã‚¨ãƒ‡ã‚£ãƒƒãƒˆã‚¢ãƒ—ãƒªã«æ³¨æ„ã—ã¦ãã ã•ã„。_フォーマット_ メニューã‹ã‚‰ _標準テキストã«ã™ã‚‹_ ã‚’é¸æŠžã—ãªã„é™ã‚Šã€ãƒ—レーンテキストã¨ã—ã¦ä¿å­˜ã•れã¾ã›ã‚“。 20macOS ã§ã¯ã€ãƒ‡ãƒ•ォルトã®ãƒ†ã‚­ã‚¹ãƒˆã‚¨ãƒ‡ã‚£ãƒƒãƒˆã‚¢ãƒ—ãƒªã«æ³¨æ„ã—ã¦ãã ã•ã„。_フォーマット_ メニューã‹ã‚‰ _標準テキストã«ã™ã‚‹_ ã‚’é¸æŠžã—ãªã„é™ã‚Šã€ãƒ—レーンテキストã¨ã—ã¦ä¿å­˜ã•れã¾ã›ã‚“。
33 21
34[Sublime Text](https://www.sublimetext.com/) ã‚„ [VS Code](https://code.visualstudio.com/) ã®ã‚ˆã†ãªå°‚用ã®ãƒ†ã‚­ã‚¹ãƒˆã‚¨ãƒ‡ã‚£ã‚¿ã‚’ダウンロードã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚ã“れらã®ãƒ—ログラムã¯ã‚³ãƒ¼ãƒ‰ã‚’編集ã™ã‚‹ãŸã‚ã«ç‰¹åˆ¥ã«ä½œæˆã•れã¦ã„ã‚‹ãŸã‚ã€ã“れã¯ãƒ—ラットフォームã«é–¢ä¿‚ãªããƒ™ã‚¹ãƒˆãªæ–¹æ³•ã§ã™ã€‚ 22[Sublime Text](https://www.sublimetext.com/) ã‚„ [VS Code](https://code.visualstudio.com/) ã®ã‚ˆã†ãªå°‚用ã®ãƒ†ã‚­ã‚¹ãƒˆã‚¨ãƒ‡ã‚£ã‚¿ã‚’ダウンロードã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚ã“れらã®ãƒ—ログラムã¯ã‚³ãƒ¼ãƒ‰ã‚’編集ã™ã‚‹ãŸã‚ã«ç‰¹åˆ¥ã«ä½œæˆã•れã¦ã„ã‚‹ãŸã‚ã€ã“れã¯ãƒ—ラットフォームã«é–¢ä¿‚ãªããƒ™ã‚¹ãƒˆãªæ–¹æ³•ã§ã™ã€‚
@@ -45,78 +33,124 @@ QMK Toolbox ã¯ã€Windows 㨠macOS ã§ä½¿ãˆã‚‹ GUI ã‚’å‚™ãˆãŸãƒ—ログラム
45* Windows 版: `qmk_toolbox.exe` (portable) ã¾ãŸã¯ `qmk_toolbox_install.exe` (installer) 33* Windows 版: `qmk_toolbox.exe` (portable) ã¾ãŸã¯ `qmk_toolbox_install.exe` (installer)
46* macOS 版: `QMK.Toolbox.app.zip` (portable) ã¾ãŸã¯ `QMK.Toolbox.pkg` (installer) 34* macOS 版: `QMK.Toolbox.app.zip` (portable) ã¾ãŸã¯ `QMK.Toolbox.pkg` (installer)
47 35
48## 環境構築 :id=set-up-your-environment 36### Unix ライクãªç’°å¢ƒ
37
38Linux ã‚„ macOS ã«ã¯æ—¢ã«å®Ÿè¡Œå¯èƒ½ãª unix シェルãŒä»˜å±žã—ã¦ã„ã¾ã™ã€‚ビルド環境を構築ã™ã‚‹ã ã‘ã§æ¸ˆã¿ã¾ã™ã€‚
39
40Windows ã§ã¯ã€MSYS2 ã‚„ WSL をインストールã—ã¦ã€ã“れらã®ç’°å¢ƒã‚’使ã†å¿…è¦ãŒã‚りã¾ã™ã€‚MSYS2 ã®æ§‹ç¯‰æ‰‹é †ã‚’以下ã«ç¤ºã—ã¾ã™ã€‚
41
42## 2. ビルド環境を準備ã™ã‚‹ :id=set-up-your-environment
49 43
50ç§ãŸã¡ã¯ã€QMK ã‚’å¯èƒ½ãªé™ã‚Šç°¡å˜ã«æ§‹ç¯‰ã§ãるよã†ã«åŠªåŠ›ã—ã¦ã„ã¾ã™ã€‚ 44ç§ãŸã¡ã¯ã€QMK ã‚’å¯èƒ½ãªé™ã‚Šç°¡å˜ã«æ§‹ç¯‰ã§ãるよã†ã«åŠªåŠ›ã—ã¦ã„ã¾ã™ã€‚
51Linux ã‹ Unix 環境を用æ„ã™ã‚‹ã ã‘ã§ã€QMK ã«æ®‹ã‚Šã‚’インストールã•ã›ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ 45Linux ã‹ Unix 環境を用æ„ã™ã‚‹ã ã‘ã§ã€QMK ã«æ®‹ã‚Šã‚’インストールã•ã›ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚
52 46
53?> ã‚‚ã—ã€Linux ã‹ Unix ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’使ã£ãŸã“ã¨ãŒãªã„å ´åˆã€ã“ã¡ã‚‰ã§åŸºæœ¬çš„ãªæ¦‚念やå„種コマンドを学んã§ãã ã•ã„。ã“ã‚Œã‚‰ã®æ•™æã§ QMK を使ã†ã®ã«å¿…è¦ãªã“ã¨ã‚’å­¦ã¶ã“ã¨ãŒã§ãã¾ã™ã€‚ 47?> ã‚‚ã—ã€Linux ã‹ Unix ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’使ã£ãŸã“ã¨ãŒãªã„å ´åˆã€ã“ã¡ã‚‰ã§åŸºæœ¬çš„ãªæ¦‚念やå„種コマンドを学んã§ãã ã•ã„。ã“ã‚Œã‚‰ã®æ•™æã§ QMK を使ã†ã®ã«å¿…è¦ãªã“ã¨ã‚’å­¦ã¶ã“ã¨ãŒã§ãã¾ã™:<br>
54
55[Must Know Linux Commands](https://www.guru99.com/must-know-linux-commands.html)<br> 48[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) 49[Some Basic Unix Commands](https://www.tjhsst.edu/~dhyatt/superap/unixcmd.html)
57 50
58### Windows 51### Windows
59 52
60MSYS2 㨠Git ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ãŒå¿…è¦ã§ã™ã€‚ 53MSYS2 㨠Git 㨠QMK CLI ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ãŒå¿…è¦ã§ã™ã€‚
61 54
62* [MSYS2 homepage](http://www.msys2.org) ã®æ‰‹é †ã«å¾“ã£ã¦ MSYS2 をインストールã—ã¾ã™ã€‚ 55[MSYS2 homepage](http://www.msys2.org) ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«æ‰‹é †ã«å¾“ã£ã¦ãã ã•ã„。開ã„ã¦ã„ã‚‹ MSYS2 ã®å…¨ã‚¿ãƒ¼ãƒŸãƒŠãƒ«ç”»é¢ã‚’é–‰ã˜ã¦ã€æ–°ã—ã„ MinGW 64-bit ターミナル画é¢ã‚’é–‹ãã¾ã™ã€‚**注æ„: ã“れã¯ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ãŒå®Œäº†ã—ãŸæ™‚ã«é–‹ã MSYS ターミナルã¨åŒã˜ *ã§ã¯ã‚りã¾ã›ã‚“*。**
63* é–‹ã„ã¦ã„ã‚‹ MSYS2 ã®å…¨ã‚¿ãƒ¼ãƒŸãƒŠãƒ«ç”»é¢ã‚’é–‰ã˜ã¦ã€æ–°ã—ã„ MSYS2 MinGW 64-bit ã®ã‚¿ãƒ¼ãƒŸãƒŠãƒ«ç”»é¢ã‚’é–‹ãã¾ã™ã€‚ 56
64* `pacman -S git` を実行ã—㦠Git をインストールã—ã¾ã™ã€‚ 57ãれã‹ã‚‰ã€æ¬¡ã®ã‚ˆã†ã«å®Ÿè¡Œã—ã¾ã™:
58
59 pacman --needed --noconfirm --disable-download-timeout -S git mingw-w64-x86_64-toolchain mingw-w64-x86_64-python3-pip
60 python3 -m pip install qmk
65 61
66### macOS 62### macOS
67 63
68[Homebrew homepage](https://brew.sh) ã®æ‰‹é †ã«å¾“ã£ã¦ Homebrew をインストールã—ã¦ãã ã•ã„。 64Homebrew ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ãŒå¿…è¦ã§ã™ã€‚[Homebrew homepage](https://brew.sh) ã®æ‰‹é †ã«å¾“ã£ã¦ãã ã•ã„。
69 65
70Homebrew をインストールã—ãŸã‚‰ã€ä»¥ä¸‹ã® _QMK ã®è¨­å®š_ ã«é€²ã‚“ã§ãã ã•ã„。ãã®ã‚¹ãƒ†ãƒƒãƒ—ã§ã¯ã€ä»–ã®ãƒ‘ッケージをインストールã™ã‚‹ã‚¹ã‚¯ãƒªãƒ—トを実行ã—ã¾ã™ã€‚ 66Homebrew をインストールã—ãŸå¾Œã§ã€ä»¥ä¸‹ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã—ã¾ã™:
67
68 brew install qmk/qmk/qmk
71 69
72### Linux 70### Linux
73 71
74Git ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ãŒå¿…è¦ã§ã™ã€‚æ—¢ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•れã¦ã„ã‚‹å¯èƒ½æ€§ã¯é«˜ã„ã§ã™ãŒã€ãã†ã§ãªã„å ´åˆã€æ¬¡ã®ã‚³ãƒžãƒ³ãƒ‰ã§ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã§ãã¾ã™ã€‚ 72Git 㨠Python をインストールã™ã‚‹å¿…è¦ãŒã‚りã¾ã™ã€‚両方ã¨ã‚‚æ—¢ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•れã¦ã„ã‚‹å¯èƒ½æ€§ã¯é«˜ã„ã§ã™ãŒã€ãã†ã§ãªã„å ´åˆã€æ¬¡ã®ã‚³ãƒžãƒ³ãƒ‰ã®ã„ãšã‚Œã‹ã§ãれらをインストールã§ãã¾ã™:
75 73
76* Debian / Ubuntu / Devuan: `apt-get install git` 74* Debian / Ubuntu / Devuan: `sudo apt install git python3 python3-pip`
77* Fedora / Red Hat / CentOS: `yum install git` 75* Fedora / Red Hat / CentOS: `sudo yum install git python3 python3-pip`
78* Arch: `pacman -S git` 76* Arch / Manjaro: `sudo pacman -S git python python-pip python-setuptools libffi`
79 77
80?> å…¨ã¦ã®ãƒ—ラットフォームã«ãŠã„ã¦ã€Docker を使ã†ã“ã¨ã‚‚å¯èƒ½ã§ã™ã€‚[詳細ã¯ã“ã¡ã‚‰ã‚’クリックã—ã¦ãã ã•ã„](ja/getting_started_build_tools.md#docker)。 78グローãƒãƒ« CLI をインストールã—ã¦ã€ã‚·ã‚¹ãƒ†ãƒ ã‚’ブートストラップã—ã¾ã™:
81 79
82## QMK ã®è¨­å®š :id=set-up-qmk 80`python3 -m pip install --user qmk` (Arch ベースã®ãƒ‡ã‚£ã‚¹ãƒˆãƒªãƒ“ューションã§ã¯ AUR ã‹ã‚‰ `qmk` パッケージを試ã™ã“ã¨ã‚‚ã§ãã¾ã™(**メモ**: コミュニティメンãƒãƒ¼ã«ã‚ˆã£ã¦ä¿å®ˆã•れã¦ã„ã¾ã™): `yay -S qmk`)
83 81
84Linux/Unix ç’°å¢ƒãŒæº–å‚™ã§ããŸã‚‰ QMK ã®ãƒ€ã‚¦ãƒ³ãƒ­ãƒ¼ãƒ‰ã®æº–å‚™ã¯å®Œäº†ã§ã™ã€‚Git を使用ã—㦠QMK ã®ãƒªãƒã‚¸ãƒˆãƒªã‚’「クローンã€ã™ã‚‹ã“ã¨ã§ QMK をダウンロードã—ã¾ã™ã€‚ターミナル㋠MSYS2 MinGW ウィンドウを開ã„ã¦ã€ã“ã®ã‚¬ã‚¤ãƒ‰ã®æ®‹ã‚Šã®éƒ¨åˆ†ã§ã¯é–‹ã„ãŸã¾ã¾ã«ã—ã¾ã™ã€‚ãã®ã‚¦ã‚£ãƒ³ãƒ‰ã‚¦å†…ã§ã€æ¬¡ã®2ã¤ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã—ã¾ã™ã€‚ 82### FreeBSD
85 83
86```shell 84Git 㨠Python をインストールã™ã‚‹å¿…è¦ãŒã‚りã¾ã™ã€‚両方ã¨ã‚‚æ—¢ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•れã¦ã„ã‚‹å¯èƒ½æ€§ã¯é«˜ã„ã§ã™ãŒã€ãã†ã§ãªã„å ´åˆã€æ¬¡ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã—ã¦ãれらをインストールã—ã¾ã™:
87git clone --recurse-submodules https://github.com/qmk/qmk_firmware.git 85
88cd qmk_firmware 86 pkg install git python3
89``` 87
88ローカルã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã—㟠Python パッケージãŒåˆ©ç”¨ã§ãるよã†ã«ã€`$HOME/.local/bin` ㌠`$PATH` ã«è¿½åŠ ã•れã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„。
89
90インストール完了後ã€QMK CLI をインストールã§ãã¾ã™:
90 91
91?> 既㫠[GitHub ã®ä½¿ã„ã‹ãŸ](ja/getting_started_github.md)を知ã£ã¦ã„ã‚‹ãªã‚‰ã€clone ã§ã¯ãªã fork ã‚’å‹§ã‚ã¾ã™ã€‚ã“ã®ä¸€æ–‡ã®æ„味ãŒåˆ†ã‹ã‚‰ãªã„å ´åˆã€ã“ã®ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã¯ç„¡è¦–ã—ã¦ã‹ã¾ã„ã¾ã›ã‚“。 92 python3 -m pip install --user qmk
92 93
93QMK ã«ã¯ã€å¿…è¦ãªæ®‹ã‚Šã®è¨­å®šã‚’手助ã‘ã™ã‚‹ã‚¹ã‚¯ãƒªãƒ—トãŒå«ã¾ã‚Œã¦ã„ã¾ã™ã€‚ 94## 3. QMK ã®è¨­å®šã‚’行ㆠ:id=set-up-qmk
94セットアップ作業を完了ã•ã›ã‚‹ãŸã‚ã€æ¬¡ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã—ã¾ã™ã€‚
95 95
96 util/qmk_install.sh 96QMK ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«å¾Œã«ã€ã“ã®ã‚³ãƒžãƒ³ãƒ‰ã§è¨­å®šã§ãã¾ã™:
97 97
98## ビルド環境ã®ç¢ºèª 98 qmk setup
99 99
100ã“れ㧠QMK ã®ãƒ“ルド環境ãŒç”¨æ„ã§ãã¾ã—ãŸã®ã§ã€ã‚­ãƒ¼ãƒœãƒ¼ãƒ‰ã®ãƒ•ァームウェアをビルドã§ãã¾ã™ã€‚ 100ã»ã¨ã‚“ã©ã®å ´åˆã€å…¨ã¦ã®ãƒ—ロンプト㫠Yes ã¨ç­”ãˆã¾ã™ã€‚
101
102?>**Debianã€Ubuntuã€ãã‚Œã‚‰ã®æ´¾ç”Ÿã«é–¢ã™ã‚‹æ³¨æ„**:
103次ã®ã‚ˆã†ãªã‚¨ãƒ©ãƒ¼ãŒè¡¨ç¤ºã•れるå¯èƒ½æ€§ãŒã‚りã¾ã™: `bash: qmk: command not found`.
104ã“れ㯠Debian ã® Bash 4.4 リリースã§å°Žå…¥ã•れ㟠[ãƒã‚°](https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=839155) ã§ã€`$HOME/.local/bin` ㌠PATH ã‹ã‚‰å‰Šé™¤ã•れã¾ã—ãŸã€‚ã“ã®ãƒã‚°ã¯å¾Œã« Debian ã‚„ Ubuntu ã§ä¿®æ­£ã•れã¾ã—ãŸã€‚
105残念ãªã“ã¨ã«ã€Ubuntu ã¯ã“ã®ãƒã‚°ã‚’å†å°Žå…¥ã—ã€[ã¾ã ä¿®æ­£ã—ã¦ã„ã¾ã›ã‚“](https://bugs.launchpad.net/ubuntu/+source/bash/+bug/1588562)。
106幸ã„ã€ä¿®æ­£ã¯ç°¡å˜ã§ã™ã€‚ã“れをã‚ãªãŸã®ãƒ¦ãƒ¼ã‚¶ã§å®Ÿè¡Œã—ã¾ã™: `echo 'PATH="$HOME/.local/bin:$PATH"' >> $HOME/.bashrc && source $HOME/.bashrc`
107
108?>**FreeBSD ã«é–¢ã™ã‚‹æ³¨æ„**:
109ã¾ãšã€`root` 以外ã®ãƒ¦ãƒ¼ã‚¶ã§ `qmk setup` を実行ã™ã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ãŒã€ã“れã¯ãŠãらã `pkg` を使ã£ã¦åŸºæœ¬ã‚·ã‚¹ãƒ†ãƒ ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹å¿…è¦ãŒã‚るパッケージを識別ã—ã¾ã™ã€‚
110ã—ã‹ã—ã€ç‰¹æ¨©ã®ãªã„ユーザã§å®Ÿè¡Œã™ã‚‹ã¨ã€ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã¯ãŠãらã失敗ã—ã¾ã™ã€‚
111基本的ãªä¾å­˜é–¢ä¿‚を手動ã§ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹ã«ã¯ã€`./util/qmk_install.sh` ã‚’ `root` ã¨ã—ã¦å®Ÿè¡Œã™ã‚‹ã‹ã€`sudo` ã‚’ã¤ã‘ã¦å®Ÿè¡Œã—ã¾ã™ã€‚
112ãれãŒå®Œäº†ã—ãŸã‚‰ã€`qmk setup` ã‚’å†å®Ÿè¡Œã—ã¦è¨­å®šã¨ç¢ºèªã‚’完了ã•ã›ã¾ã™ã€‚
113
114?> 既㫠[GitHub ã®ä½¿ã„ã‹ãŸ](ja/getting_started_github.md)を知ã£ã¦ã„ã‚‹ãªã‚‰ã€fork を作æˆã—ã€`qmk setup <github_username>/qmk_firmware` を使ã£ã¦å€‹äººç”¨ã® fork ã‹ã‚‰ clone ã™ã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ã€‚ã“ã®ä¸€æ–‡ã®æ„味ãŒåˆ†ã‹ã‚‰ãªã„å ´åˆã€ã“ã®ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã¯ç„¡è¦–ã—ã¦ã‹ã¾ã„ã¾ã›ã‚“。
115
116## 4. ビルド環境ã®ç¢ºèª
117
118ã“れ㧠QMK ã®ãƒ“ルド環境ãŒç”¨æ„ã§ããŸã®ã§ã€ã‚­ãƒ¼ãƒœãƒ¼ãƒ‰ã®ãƒ•ァームウェアをビルドã§ãã¾ã™ã€‚
101キーボードã®ãƒ‡ãƒ•ォルトキーマップをビルドã™ã‚‹ã“ã¨ã‹ã‚‰å§‹ã‚ã¾ã™ã€‚次ã®å½¢å¼ã®ã‚³ãƒžãƒ³ãƒ‰ã§ãƒ“ルドã§ãã‚‹ã¯ãšã§ã™ã€‚ 119キーボードã®ãƒ‡ãƒ•ォルトキーマップをビルドã™ã‚‹ã“ã¨ã‹ã‚‰å§‹ã‚ã¾ã™ã€‚次ã®å½¢å¼ã®ã‚³ãƒžãƒ³ãƒ‰ã§ãƒ“ルドã§ãã‚‹ã¯ãšã§ã™ã€‚
102 120
103 make <keyboard>:default 121 qmk compile -kb <keyboard> -km default
104 122
105例)Clueboard 66% ã®ãƒ•ァームウェアをビルドã™ã‚‹ 123例ãˆã°ã€Clueboard 66% ã®ãƒ•ァームウェアをビルドã™ã‚‹å ´åˆ:
106 124
107 make clueboard/66/rev3:default 125 qmk compile -kb clueboard/66/rev3 -km default
108 126
109大é‡ã®å‡ºåŠ›ã®æœ€å¾Œã«æ¬¡ã®ã‚ˆã†ã«å‡ºåŠ›ã•れるã¨å®Œäº†ã§ã™ã€‚ 127大é‡ã®å‡ºåŠ›ã®æœ€å¾Œã«æ¬¡ã®ã‚ˆã†ã«å‡ºåŠ›ã•れるã¨å®Œäº†ã§ã™:
110 128
111``` 129```
112Linking: .build/clueboard_66_rev3_default.elf [OK] 130Linking: .build/clueboard_66_rev3_default.elf [OK]
113Creating load file for flashing: .build/clueboard_66_rev3_default.hex [OK] 131Creating load file for flashing: .build/clueboard_66_rev3_default.hex [OK]
114Copying clueboard_66_rev3_default.hex to qmk_firmware folder [OK] 132Copying clueboard_66_rev3_default.hex to qmk_firmware folder [OK]
115Checking file size of clueboard_66_rev3_default.hex [OK] 133Checking file size of clueboard_66_rev3_default.hex [OK]
116 * The firmware size is fine - 26356/28672 (2316 bytes free) 134 * The firmware size is fine - 26356/28672 (2316 bytes free)
117``` 135```
118 136
137## 5. ビルド環境ã®è¨­å®š(オプション)
138
139ビルド環境を設定ã—ã¦ãƒ‡ãƒ•ォルトを設定ã™ã‚‹ã“ã¨ã§ã€QMK ã§ã®ä½œæ¥­ã‚’ã‚ã¾ã‚Šé¢å€’ãã•ããªã„よã†ã«ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚今ã‹ã‚‰ã‚„りã¾ã—ょã†ï¼
140
141QMK ã‚’åˆã‚ã¦ä½¿ã†ã»ã¨ã‚“ã©ã®äººã¯ã€ã‚­ãƒ¼ãƒœãƒ¼ãƒ‰ã‚’1ã¤ã—ã‹æŒã£ã¦ã„ã¾ã›ã‚“。`qmk config` コマンドã§ã“ã®ã‚­ãƒ¼ãƒœãƒ¼ãƒ‰ã‚’デフォルトã¨ã—ã¦è¨­å®šã§ãã¾ã™ã€‚例ãˆã°ã€ãƒ‡ãƒ•ォルトã®ã‚­ãƒ¼ãƒœãƒ¼ãƒ‰ã‚’ `clueboard/66/rev4` ã«è¨­å®šã™ã‚‹ã«ã¯:
142
143 qmk config user.keyboard=clueboard/66/rev4
144
145デフォルトキーマップåを設定ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚ã»ã¨ã‚“ã©ã®äººã¯ã“ã“ã§ GitHub ユーザåを使ã„ã¾ã™ãŒã€ãã†ã™ã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ã€‚
146
147 qmk config user.keymap=<github_username>
148
149ã“ã®å¾Œã€ã“れらã®å¼•数をオフã«ã—ã¦ã€æ¬¡ã®ã‚ˆã†ã«ã‚­ãƒ¼ãƒœãƒ¼ãƒ‰ã‚’コンパイルã§ãã¾ã™:
150
151 qmk compile
152
119# キーマップã®ä½œæˆ 153# キーマップã®ä½œæˆ
120 154
121ã“れã§ã‚ãªãŸå°‚用ã®ã‚­ãƒ¼ãƒžãƒƒãƒ—を作æˆã™ã‚‹æº–å‚™ãŒã§ãã¾ã—ãŸï¼ 155ã“れã§ã‚ãªãŸå°‚用ã®ã‚­ãƒ¼ãƒžãƒƒãƒ—を作æˆã™ã‚‹æº–å‚™ãŒã§ãã¾ã—ãŸï¼
122次㯠[Building Your First Firmware](ja/newbs_building_firmware.md) ã§å°‚用ã®ã‚­ãƒ¼ãƒžãƒƒãƒ—を作æˆã—ã¾ã™ã€‚ 156次㯠[åˆã‚ã¦ã®ãƒ•ã‚¡ãƒ¼ãƒ ã‚¦ã‚§ã‚¢ã®æ§‹ç¯‰](ja/newbs_building_firmware.md) ã§å°‚用ã®ã‚­ãƒ¼ãƒžãƒƒãƒ—を作æˆã—ã¾ã™ã€‚