diff options
| author | shela <shelaf@users.noreply.github.com> | 2020-08-01 10:53:35 +0900 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2020-07-31 18:53:35 -0700 |
| commit | 3f2521115d7d6e2bb5e221c34a636f9e5af80358 (patch) | |
| tree | ea51402790dce4321c75e94b35aabcd71bf6830a /docs | |
| parent | 0d405ad38e25641fbdbbeedbc411c1d69a8980b8 (diff) | |
| download | qmk_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.md | 142 |
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 | ã“ã®ãƒ—ãƒã‚»ãƒƒã‚µã§ã¯ã€ã‚ーボードã®ãƒœã‚¿ãƒ³ã®æŠ¼ã—下ã’ã®æ¤œå‡ºã‚’担当ã—ã‚ーボードã®ã©ã®ãƒœã‚¿ãƒ³ãŒæŠ¼ã•れã¦ã„ã‚‹/離ã•れã¦ã„ã‚‹ã‹ã®ãƒ¬ãƒãƒ¼ãƒˆã‚’コンピュータã«é€ä¿¡ã™ã‚‹ã‚½ãƒ•トウェアãŒå‹•作ã—ã¦ã„ã¾ã™ã€‚ | ||
| 11 | QMK ã¯ã€ãã®ã‚½ãƒ•トウェアã®å½¹å‰²ã‚’æžœãŸã—ã€ãƒœã‚¿ãƒ³ã®æŠ¼ä¸‹ã‚’検出ã—ãã®æƒ…å ±ã‚’ãƒ›ã‚¹ãƒˆã‚³ãƒ³ãƒ”ãƒ¥ãƒ¼ã‚¿ã«æ¸¡ã—ã¾ã™ã€‚ | ||
| 12 | カスタムã‚ーマップを作るã¨ã„ã†ã“ã¨ã¯ã€ã‚ーボード上ã§å‹•ãプãƒã‚°ãƒ©ãƒ を作るã¨ã„ã†ã“ã¨ãªã®ã§ã™ã€‚ | ||
| 13 | |||
| 14 | QMK ã¯ã€ç°¡å˜ãªã“ã¨ã¯ç°¡å˜ã«ã€ãã—ã¦ã€é›£ã—ã„ã“ã¨ã‚’å¯èƒ½ãªã“ã¨ã«ã™ã‚‹ã“ã¨ã§ã€ã‚ãªãŸã®æ‰‹ã«ãŸãã•ã‚“ã®ãƒ‘ワーをもãŸã‚‰ã—ã¾ã™ã€‚ | ||
| 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 | ||
| 29 | GUI を使ã‚ãªã„å ´åˆã€ãƒ—レーンテã‚ストを編集・ä¿å˜ã§ãるエディタãŒå¿…è¦ã§ã™ã€‚ | 18 | **プレーンテã‚スト** ファイルを編集ã—ã¦ä¿å˜ã§ãるプãƒã‚°ãƒ©ãƒ ãŒå¿…è¦ã§ã™ã€‚ |
| 30 | Windows ã®å ´åˆã€ãƒ¡ãƒ¢å¸³ãŒä½¿ãˆã¾ã™ã€‚Linux ã®å ´åˆã€gedit ãŒä½¿ãˆã¾ã™ã€‚ | 19 | Windows ã®å ´åˆã€ãƒ¡ãƒ¢å¸³ãŒä½¿ãˆã¾ã™ã€‚Linux ã®å ´åˆã€gedit ãŒä½¿ãˆã¾ã™ã€‚ã©ã¡ã‚‰ã‚‚シンプルã§ã™ãŒæ©Ÿèƒ½çš„ãªãƒ†ã‚ストエディタã§ã™ã€‚ |
| 31 | ã©ã¡ã‚‰ã‚‚シンプルã§ã™ãŒæ©Ÿèƒ½çš„ãªãƒ†ã‚ストエディタã§ã™ã€‚ | ||
| 32 | macOS ã§ã¯ã€ãƒ‡ãƒ•ォルトã®ãƒ†ã‚ã‚¹ãƒˆã‚¨ãƒ‡ã‚£ãƒƒãƒˆã‚¢ãƒ—ãƒªã«æ³¨æ„ã—ã¦ãã ã•ã„。_フォーマット_ メニューã‹ã‚‰ _標準テã‚ストã«ã™ã‚‹_ ã‚’é¸æŠžã—ãªã„é™ã‚Šã€ãƒ—レーンテã‚ストã¨ã—ã¦ä¿å˜ã•れã¾ã›ã‚“。 | 20 | macOS ã§ã¯ã€ãƒ‡ãƒ•ォルトã®ãƒ†ã‚ã‚¹ãƒˆã‚¨ãƒ‡ã‚£ãƒƒãƒˆã‚¢ãƒ—ãƒªã«æ³¨æ„ã—ã¦ãã ã•ã„。_フォーマット_ メニューã‹ã‚‰ _標準テã‚ストã«ã™ã‚‹_ ã‚’é¸æŠžã—ãªã„é™ã‚Šã€ãƒ—レーンテã‚ストã¨ã—ã¦ä¿å˜ã•れã¾ã›ã‚“。 |
| 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 | |||
| 38 | Linux ã‚„ macOS ã«ã¯æ—¢ã«å®Ÿè¡Œå¯èƒ½ãª unix シェルãŒä»˜å±žã—ã¦ã„ã¾ã™ã€‚ビルド環境を構築ã™ã‚‹ã ã‘ã§æ¸ˆã¿ã¾ã™ã€‚ | ||
| 39 | |||
| 40 | Windows ã§ã¯ã€MSYS2 ã‚„ WSL をインストールã—ã¦ã€ã“れらã®ç’°å¢ƒã‚’使ã†å¿…è¦ãŒã‚りã¾ã™ã€‚MSYS2 ã®æ§‹ç¯‰æ‰‹é †ã‚’以下ã«ç¤ºã—ã¾ã™ã€‚ | ||
| 41 | |||
| 42 | ## 2. ビルド環境を準備ã™ã‚‹ :id=set-up-your-environment | ||
| 49 | 43 | ||
| 50 | ç§ãŸã¡ã¯ã€QMK ã‚’å¯èƒ½ãªé™ã‚Šç°¡å˜ã«æ§‹ç¯‰ã§ãるよã†ã«åŠªåŠ›ã—ã¦ã„ã¾ã™ã€‚ | 44 | ç§ãŸã¡ã¯ã€QMK ã‚’å¯èƒ½ãªé™ã‚Šç°¡å˜ã«æ§‹ç¯‰ã§ãるよã†ã«åŠªåŠ›ã—ã¦ã„ã¾ã™ã€‚ |
| 51 | Linux ã‹ Unix 環境を用æ„ã™ã‚‹ã ã‘ã§ã€QMK ã«æ®‹ã‚Šã‚’インストールã•ã›ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ | 45 | Linux ã‹ 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 | ||
| 60 | MSYS2 㨠Git ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ãŒå¿…è¦ã§ã™ã€‚ | 53 | MSYS2 㨠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 をインストールã—ã¦ãã ã•ã„。 | 64 | Homebrew ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ãŒå¿…è¦ã§ã™ã€‚[Homebrew homepage](https://brew.sh) ã®æ‰‹é †ã«å¾“ã£ã¦ãã ã•ã„。 |
| 69 | 65 | ||
| 70 | Homebrew をインストールã—ãŸã‚‰ã€ä»¥ä¸‹ã® _QMK ã®è¨å®š_ ã«é€²ã‚“ã§ãã ã•ã„。ãã®ã‚¹ãƒ†ãƒƒãƒ—ã§ã¯ã€ä»–ã®ãƒ‘ッケージをインストールã™ã‚‹ã‚¹ã‚¯ãƒªãƒ—トを実行ã—ã¾ã™ã€‚ | 66 | Homebrew をインストールã—ãŸå¾Œã§ã€ä»¥ä¸‹ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã—ã¾ã™: |
| 67 | |||
| 68 | brew install qmk/qmk/qmk | ||
| 71 | 69 | ||
| 72 | ### Linux | 70 | ### Linux |
| 73 | 71 | ||
| 74 | Git ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ãŒå¿…è¦ã§ã™ã€‚æ—¢ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•れã¦ã„ã‚‹å¯èƒ½æ€§ã¯é«˜ã„ã§ã™ãŒã€ãã†ã§ãªã„å ´åˆã€æ¬¡ã®ã‚³ãƒžãƒ³ãƒ‰ã§ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã§ãã¾ã™ã€‚ | 72 | Git 㨠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 | ||
| 84 | Linux/Unix ç’°å¢ƒãŒæº–å‚™ã§ããŸã‚‰ QMK ã®ãƒ€ã‚¦ãƒ³ãƒãƒ¼ãƒ‰ã®æº–å‚™ã¯å®Œäº†ã§ã™ã€‚Git を使用ã—㦠QMK ã®ãƒªãƒã‚¸ãƒˆãƒªã‚’「クãƒãƒ¼ãƒ³ã€ã™ã‚‹ã“ã¨ã§ QMK をダウンãƒãƒ¼ãƒ‰ã—ã¾ã™ã€‚ターミナル㋠MSYS2 MinGW ウィンドウを開ã„ã¦ã€ã“ã®ã‚¬ã‚¤ãƒ‰ã®æ®‹ã‚Šã®éƒ¨åˆ†ã§ã¯é–‹ã„ãŸã¾ã¾ã«ã—ã¾ã™ã€‚ãã®ã‚¦ã‚£ãƒ³ãƒ‰ã‚¦å†…ã§ã€æ¬¡ã®2ã¤ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã—ã¾ã™ã€‚ | 82 | ### FreeBSD |
| 85 | 83 | ||
| 86 | ```shell | 84 | Git 㨠Python をインストールã™ã‚‹å¿…è¦ãŒã‚りã¾ã™ã€‚両方ã¨ã‚‚æ—¢ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•れã¦ã„ã‚‹å¯èƒ½æ€§ã¯é«˜ã„ã§ã™ãŒã€ãã†ã§ãªã„å ´åˆã€æ¬¡ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã—ã¦ãれらをインストールã—ã¾ã™: |
| 87 | git clone --recurse-submodules https://github.com/qmk/qmk_firmware.git | 85 | |
| 88 | cd 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 | ||
| 93 | QMK ã«ã¯ã€å¿…è¦ãªæ®‹ã‚Šã®è¨å®šã‚’手助ã‘ã™ã‚‹ã‚¹ã‚¯ãƒªãƒ—トãŒå«ã¾ã‚Œã¦ã„ã¾ã™ã€‚ | 94 | ## 3. QMK ã®è¨å®šã‚’行ㆠ:id=set-up-qmk |
| 94 | セットアップ作æ¥ã‚’完了ã•ã›ã‚‹ãŸã‚ã€æ¬¡ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã—ã¾ã™ã€‚ | ||
| 95 | 95 | ||
| 96 | util/qmk_install.sh | 96 | QMK ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«å¾Œã«ã€ã“ã®ã‚³ãƒžãƒ³ãƒ‰ã§è¨å®šã§ãã¾ã™: |
| 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 | ``` |
| 112 | Linking: .build/clueboard_66_rev3_default.elf [OK] | 130 | Linking: .build/clueboard_66_rev3_default.elf [OK] |
| 113 | Creating load file for flashing: .build/clueboard_66_rev3_default.hex [OK] | 131 | Creating load file for flashing: .build/clueboard_66_rev3_default.hex [OK] |
| 114 | Copying clueboard_66_rev3_default.hex to qmk_firmware folder [OK] | 132 | Copying clueboard_66_rev3_default.hex to qmk_firmware folder [OK] |
| 115 | Checking file size of clueboard_66_rev3_default.hex [OK] | 133 | Checking 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 | |||
| 141 | QMK ã‚’åˆã‚ã¦ä½¿ã†ã»ã¨ã‚“ã©ã®äººã¯ã€ã‚ーボードを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) ã§å°‚用ã®ã‚ーマップを作æˆã—ã¾ã™ã€‚ |
