aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorumi <57262844+umi-umi@users.noreply.github.com>2020-05-19 12:29:04 +0900
committerGitHub <noreply@github.com>2020-05-18 20:29:04 -0700
commit0bece1d44275abe5522eab396efd3acbf2117b44 (patch)
tree936faee455b5900daff8e47968e0d5b77172c4c5 /docs
parentbe69dd22e8903b9e2f2d14e7c5bdfd3b912ef29e (diff)
downloadqmk_firmware-0bece1d44275abe5522eab396efd3acbf2117b44.tar.gz
qmk_firmware-0bece1d44275abe5522eab396efd3acbf2117b44.zip
[Docs] Japanese translation of docs/feature_layouts.md (#8949)
* add feature_layouts.md translation * update based on comment * update based on comment
Diffstat (limited to 'docs')
-rw-r--r--docs/ja/feature_layouts.md114
1 files changed, 114 insertions, 0 deletions
diff --git a/docs/ja/feature_layouts.md b/docs/ja/feature_layouts.md
new file mode 100644
index 000000000..9b36a1eda
--- /dev/null
+++ b/docs/ja/feature_layouts.md
@@ -0,0 +1,114 @@
1# レイアウト: 複数のキーボードで1つのキーマップを使用
2
3<!---
4 original document: 0.8.134:docs/feature_layouts.md
5 git diff 0.8.134 HEAD -- docs/feature_layouts.md | cat
6-->
7
8`layouts/` フォルダは、様々なキーボードに適用できる色々な物理キーレイアウトを含みます。
9
10```
11layouts/
12+ default/
13| + 60_ansi/
14| | + readme.md
15| | + layout.json
16| | + a_good_keymap/
17| | | + keymap.c
18| | | + readme.md
19| | | + config.h
20| | | + rules.mk
21| | + <keymap folder>/
22| | + ...
23| + <layout folder>/
24+ community/
25| + <layout folder>/
26| + ...
27```
28
29`layouts/default/` と `layouts/community/` は、レイアウト「repositories」の2つの例です。現在のところ、`default` にはユーザの参考用に、レイアウトに関する全ての情報および、`default_<layout>` という名前の1つのデフォルトのキーマップが含まれています。`community` には全ての共有キーマップが含まれており、それらはユーザが `layouts/` にクローンするための別のリポジトリに分割することを最終的な目的としていますQMK は `layouts/` 内のすべてのフォルダを検索するため、ここに複数のリポジトリを持つことができます。
30
31各レイアウトフォルダは、レイアウトの物理的な側面に基づいて、可能な限り一般的な名称で(`[a-z0-9_]`)という名前が付けられ、キーボードで定義されるレイアウトと一緒に `readme.md` を含みます。
32
33```md
34# 60_ansi
35
36 LAYOUT_60_ansi
37```
38
39新しい名前は既存のレイアウトで設定された標準に準拠しようと努力する必要があり、必要に応じて PR/Issue で議論することができます。
40
41## レイアウトのサポート
42
43キーボードがレイアウトをサポートするために、変数は `<keyboard>.h` で定義し、引数/キー (できれば物理レイアウト)の数に一致している必要があります。
44
45 #define LAYOUT_60_ansi KEYMAP_ANSI
46
47レイアウトの名前は次の正規表現に一致しなければなりません: `[a-z0-9_]+`
48
49フォルダ名はキーボードの `rules.mk` に追加する必要があります:
50
51 LAYOUTS = 60_ansi
52
53`LAYOUTS` は任意のキーボードフォルダレべルの `rules.mk` に設定することができます:
54
55 LAYOUTS = 60_iso
56
57ただし、`LAYOUT_<layout>` 変数は `<folder>.h` でも定義する必要があります。
58
59## キーマップのビルド
60
61以下の形式でコマンドを使ってキーボードキーマップを作成できるはずです:
62
63 make <keyboard>:<layout>
64
65### レイアウトの競合
66キーボードが複数のレイアウトオプションをサポートし、
67
68 LAYOUTS = ortho_4x4 ortho_4x12
69
70なおかつ両方のオプションについてレイアウトが存在する場合、
71```
72layouts/
73+ community/
74| + ortho_4x4/
75| | + <layout>/
76| | | + ...
77| + ortho_4x12/
78| | + <layout>/
79| | | + ...
80| + ...
81```
82
83FORCE_LAYOUT 引数はどのレイアウトをビルドするかを指定するために使うことができます
84
85 make <keyboard>:<layout> FORCE_LAYOUT=ortho_4x4
86 make <keyboard>:<layout> FORCE_LAYOUT=ortho_4x12
87
88## キーボードに依存しないレイアウトを作成するためのヒント
89
90### インクルード
91
92`#include "planck.h"` を使う代わりに、以下の行を使ってコンパイルされる `<keyboard>.h` (`<folder>.h` はここでインクルードすべきではありません)ファイルをインクルードすることができます:
93
94 #include QMK_KEYBOARD_H
95
96キーボード固有のコードを保持したい場合は、これらの変数を使って `#ifdef` 文でエスケープすることができます:
97
98* `KEYBOARD_<folder1>_<folder2>`
99
100例えば:
101
102```c
103#ifdef KEYBOARD_planck
104 #ifdef KEYBOARD_planck_rev4
105 planck_rev4_function();
106 #endif
107#endif
108```
109
110名前は小文字でキーボード/リビジョンのフォルダ/ファイル名と正確に一致することに注意してください。
111
112### キーマップ
113
114同じレイアウトで分割および非分割キーボードをサポートするためには、キーマップでキーボード非依存の `LAYOUT_<layout name>` マクロを使う必要があります。例えば、Let's Split および Planck が同じレイアウトを共有するには、`LAYOUT_planck_grid` や C 配列の場合の単なる `{}` の代わりに、`LAYOUT_ortho_4x12` を使う必要があります。