--- /dev/null
+* [完全な初心者のガイド](ja/newbs.md)
+ * [はじめに](ja/newbs_getting_started.md)
+ * [初めてのファームウェアの構築](ja/newbs_building_firmware.md)
+ * [ファームウェアのフラッシュ](ja/newbs_flashing.md)
+ * [テストとデバッグ](ja/newbs_testing_debugging.md)
+ * [Gitのベストプラクティス](ja/newbs_best_practices.md)
+ * [学習リソース](ja/newbs_learn_more_resources.md)
+
+* [QMKの基本](ja/README.md)
+ * [QMKの導入](ja/getting_started_introduction.md)
+ * [QMK CLI](ja/cli.md)
+ * [QMK CLI 設定](ja/cli_configuration.md)
+ * [QMKへの貢献](ja/contributing.md)
+ * [Githubの使い方](ja/getting_started_github.md)
+ * [ヘルプ](ja/getting_started_getting_help.md)
+
+* [破壊的な変更](ja/breaking_changes.md)
+ * [2019年8月30日](ja/ChangeLog/20190830.md)
+
+* [FAQ](ja/faq.md)
+ * [一般的なFAQ](ja/faq_general.md)
+ * [QMKのビルド/コンパイル](ja/faq_build.md)
+ * [QMKのデバッグ/トラブルシューティング](ja/faq_debug.md)
+ * [キーマップ](ja/faq_keymap.md)
+ * [Zadigを使ったドライバのインストール](ja/driver_installation_zadig.md)
+
+* 詳細なガイド
+ * [ビルドツールのインストール](ja/getting_started_build_tools.md)
+ * [Vagrantのガイド](ja/getting_started_vagrant.md)
+ * [ビルド/コンパイルの説明](ja/getting_started_make_guide.md)
+ * [ファームウェアのフラッシュ](ja/flashing.md)
+ * [機能のカスタマイズ](ja/custom_quantum_functions.md)
+ * [キーマップの概要](ja/keymap.md)
+
+* [ハードウェア](ja/hardware.md)
+ * [AVR プロセッサ](ja/hardware_avr.md)
+ * [ドライバ](ja/hardware_drivers.md)
+
+* リファレンス
+ * [キーボード ガイドライン](ja/hardware_keyboard_guidelines.md)
+ * [設定オプション](ja/config_options.md)
+ * [キーコード](ja/keycodes.md)
+ * [コーディング規約 - C](ja/coding_conventions_c.md)
+ * [コーディング規約 - Python](ja/coding_conventions_python.md)
+ * [ドキュメント ベストプラクティス](ja/documentation_best_practices.md)
+ * [ドキュメント テンプレート](ja/documentation_templates.md)
+ * [用語](ja/reference_glossary.md)
+ * [ユニットテスト](ja/unit_testing.md)
+ * [便利な関数](ja/ref_functions.md)
+ * [Configurator サポート](ja/reference_configurator_support.md)
+ * [info.json 形式](ja/reference_info_json.md)
+ * [Python CLI 開発](ja/cli_development.md)
+
+* [機能](ja/features.md)
+ * [基本的なキーコード](ja/keycodes_basic.md)
+ * [US ANSI シフトキー](ja/keycodes_us_ansi_shifted.md)
+ * [Quantum キーコード](ja/quantum_keycodes.md)
+ * [Advanced キーコード](ja/feature_advanced_keycodes.md)
+ * [オーディオ](ja/feature_audio.md)
+ * [自動シフト](ja/feature_auto_shift.md)
+ * [バックライト](ja/feature_backlight.md)
+ * [ブルートゥース](ja/feature_bluetooth.md)
+ * [ブートマジック](ja/feature_bootmagic.md)
+ * [コンボ](ja/feature_combo.md)
+ * [コマンド](ja/feature_command.md)
+ * [Debounce API](ja/feature_debounce_type.md)
+ * [DIP スイッチ](ja/feature_dip_switch.md)
+ * [動的マクロ](ja/feature_dynamic_macros.md)
+ * [エンコーダ](ja/feature_encoders.md)
+ * [グレイブ エスケープ](ja/feature_grave_esc.md)
+ * [触覚フィードバック](ja/feature_haptic_feedback.md)
+ * [HD44780 LCD コントローラ](ja/feature_hd44780.md)
+ * [キーロック](ja/feature_key_lock.md)
+ * [レイアウト](ja/feature_layouts.md)
+ * [リーダー キー](ja/feature_leader_key.md)
+ * [LED マトリクス](ja/feature_led_matrix.md)
+ * [マクロ](ja/feature_macros.md)
+ * [マウスキー](ja/feature_mouse_keys.md)
+ * [OLED ドライバ](ja/feature_oled_driver.md)
+ * [One Shot Keys](ja/feature_advanced_keycodes.md#one-shot-keys)
+ * [ポインティング デバイス](ja/feature_pointing_device.md)
+ * [PS/2 マウス](ja/feature_ps2_mouse.md)
+ * [RGB ライト](ja/feature_rgblight.md)
+ * [RGB マトリクス](ja/feature_rgb_matrix.md)
+ * [Space Cadet](ja/feature_space_cadet.md)
+ * [分割キーボード](ja/feature_split_keyboard.md)
+ * [Stenography](ja/feature_stenography.md)
+ * [Swap Hands](ja/feature_swap_hands.md)
+ * [タップ ダンス](ja/feature_tap_dance.md)
+ * [Terminal](ja/feature_terminal.md)
+ * [感熱式プリンタ](ja/feature_thermal_printer.md)
+ * [ユニコード](ja/feature_unicode.md)
+ * [Userspace](ja/feature_userspace.md)
+ * [Velocikey](ja/feature_velocikey.md)
+
+* メーカーおよびモッダーのために
+ * [Hand Wiring Guide](ja/hand_wire.md)
+ * [ISP Flashing Guide](ja/isp_flashing_guide.md)
+ * [ARM デバッグ ガイド](ja/arm_debugging.md)
+ * [I2C ドライバ](ja/i2c_driver.md)
+ * [GPIO コントロール](ja/internals_gpio_control.md)
+ * [Proton C 規約](ja/proton_c_conversion.md)
+
+* より深く知るために
+ * [キーボードがどのように動作するか](ja/how_keyboards_work.md)
+ * [QMKの理解](ja/understanding_qmk.md)
+
+* 他の話題
+ * [EclipseでQMKを使用](ja/other_eclipse.md)
+ * [VSCodeでQMKを使用](ja/other_vscode.md)
+ * [サポート](ja/support.md)
+ * [翻訳を追加する方法](ja/translating.md)
+
+* QMK の内部詳細(作成中)
+ * [定義](ja/internals_defines.md)
+ * [Input Callback Reg](ja/internals_input_callback_reg.md)
+ * [Midi ドライバ](ja/internals_midi_device.md)
+ * [Midi デバイスのセットアップ手順](ja/internals_midi_device_setup_process.md)
+ * [Midi ユーティリティ](ja/internals_midi_util.md)
+ * [Send Functions](ja/internals_send_functions.md)
+ * [Sysex Tools](ja/internals_sysex_tools.md)
キーボードに書き込む最も簡単な方法は [QMK Toolbox](https://github.com/qmk/qmk_toolbox/releases) を使うことです。
ただし、QMK Toolbox は、現在は Windows と macOS でしか使えません。
-Linuxを使用している場合(および、コマンドラインでファームウェアを書き込みたい場合)は、下の方で概説する[方法](newbs_flashing.md#コマンドラインでファームウェアを書き込む)で行なう必要があります。
+Linuxを使用している場合(および、コマンドラインでファームウェアを書き込みたい場合)は、下の方で概説する[方法](ja/newbs_flashing.md#flash-your-keyboard-from-the-command-line)で行なう必要があります。
### QMK Toolbox にファイルをロードする
*** Clueboard - Clueboard 66% HotSwap connected -- 0xC1ED:0x2390
```
-## コマンドラインでファームウェアを書き込む
+## コマンドラインでファームウェアを書き込む :id=flash-your-keyboard-from-the-command-line
これは、以前のものと比較して非常に単純になりました。
ファームウェアをコンパイルして書き込む準備ができたら、ターミナルウィンドウを開いてビルドコマンドを実行します。
ブートローダは主に 5 種類のものが使われています。
Pro Micro とそのクローンは Caterina を、Teensy は HalfKay を、OLKBの AVR ボードは QMK-DFU を、その他の ATmega32U4 ボードは DFU を、そして多くの ARM ボードは ARM DFU を使います。
-より詳しいブートローダの情報は、[Flashing Instructions and Bootloader Information](flashing.md) にあります。
+より詳しいブートローダの情報は、[Flashing Instructions and Bootloader Information](ja/flashing.md) にあります。
使用しているブートローダがわかっているならば、ファームウェアをコンパイルするときに、実は `make` コマンドにブートローダを指定するテキストを追加して、書き込みプロセスを自動化できます。
>>> dfu-programmer atmega32u4 reset
```
-?> `dfu-programmer:no device present` など、これに関する問題がある場合は、[よくある質問](faq_build.md) を参照してください。
+?> `dfu-programmer:no device present` など、これに関する問題がある場合は、[よくある質問](ja/faq_build.md) を参照してください。
#### DFU コマンド
おめでとうございます! カスタムファームウェアがキーボードにプログラムされました!
使ってみて、すべてがあなたの望むように動作するかどうか確認してください。
-この初心者ガイドを完全なものにするために [テストとデバッグ](newbs_testing_debugging.md) を書いたので、カスタム機能のトラブルシューティング方法については、こちらをご覧ください。
+この初心者ガイドを完全なものにするために [テストとデバッグ](ja/newbs_testing_debugging.md) を書いたので、カスタム機能のトラブルシューティング方法については、こちらをご覧ください。
ファームウェアをコンパイルするキーボードの数に関わらず、この作業を一度だけ実行する必要があります。
もし、GUI で作業をしたい場合、オンラインで作業できる [QMK Configurator](https://config.qmk.fm) を使ってください。
-使い方は [Building Your First Firmware using the online GUI](newbs_building_firmware_configurator.md) を参照してください。
+使い方は [オンライン GUI を使用して初めてのファームウェアを構築する](ja/newbs_building_firmware_configurator.md) を参照してください。
## ソフトウェアのダウンロード
* Windows 版: `qmk_toolbox.exe` (portable) または `qmk_toolbox_install.exe` (installer)
* macOS 版: `QMK.Toolbox.app.zip` (portable) または `QMK.Toolbox.pkg` (installer)
-## 環境構築
+## 環境構築 :id=set-up-your-environment
私たちは、QMK を可能な限り簡単に構築できるように努力しています。
Linux か Unix 環境を用意するだけで、QMK に残りをインストールさせることができます。
* Fedora / Red Hat / CentOS: `yum install git`
* Arch: `pacman -S git`
-?> 全てのプラットフォームにおいて、Docker を使うことも可能です。[詳細はこちらをクリックしてください](getting_started_build_tools.md#docker)。
+?> 全てのプラットフォームにおいて、Docker を使うことも可能です。[詳細はこちらをクリックしてください](ja/getting_started_build_tools.md#docker)。
-## QMK の設定
+## QMK の設定 :id=set-up-qmk
Linux/Unix 環境が準備できたら QMK のダウンロードの準備は完了です。Git を使用して QMK のリポジトリを「クローン」することで QMK をダウンロードします。ターミナルか MSYS2 MinGW ウィンドウを開いて、このガイドの残りの部分では開いたままにします。そのウィンドウ内で、次の2つのコマンドを実行します。
cd qmk_firmware
```
-?> 既に [GitHub の使いかた](getting_started_github.md)を知っているなら、clone ではなく fork を勧めます。この一文の意味が分からない場合、このメッセージは無視してかまいません。
+?> 既に [GitHub の使いかた](ja/getting_started_github.md)を知っているなら、clone ではなく fork を勧めます。この一文の意味が分からない場合、このメッセージは無視してかまいません。
QMK には、必要な残りの設定を手助けするスクリプトが含まれています。
セットアップ作業を完了させるため、次のコマンドを実行します。
# キーマップの作成
これであなた専用のキーマップを作成する準備ができました!
-次は [Building Your First Firmware](newbs_building_firmware.md) で専用のキーマップを作成します。
+次は [Building Your First Firmware](ja/newbs_building_firmware.md) で専用のキーマップを作成します。