docs: ja menu tutorial

docs/docs/tutorials/menu/index.md

@@ -3,6 +3,8 @@ sidebar_position: 4
 sidebar_label: Edit menus
 ---
 
+# Edit menus
+
 Modular Avatar includes an object-based menu editing system, which lets you easily edit menus and even create simple toggles from within the Unity inspector.
 
 This tutorial will show you how to use this system to edit your avatar's existing menus, and how to include it in your assets.

docs/i18n/ja/docusaurus-plugin-content-docs/current/tutorials/index.md

@@ -10,3 +10,4 @@ Modular Avatarを使ったセットアップ方法を紹介するチュートリ
 * [簡単な衣装セットアップ](clothing/) - 多くの場合は衣装を数クリックだけでセットアップできます。このチュートリアルで詳細をチェック！
 * [複雑なCloth衣装セットアップ](adv_clothing/) - もう少しだけセットアップが必要になる、複雑な衣装の例です。
 * [オブジェクトを出し入れしよう](object_toggle/) - 簡単なオブジェクト出し入れギミック。アニメーターを使ったギミックの基礎をカバーします。
+* [メニュー編集](menu/) - 簡単にメニューを編集できる機能を紹介します。

docs/i18n/ja/docusaurus-plugin-content-docs/current/tutorials/menu/index.md

@@ -0,0 +1,102 @@
+---
+sidebar_position: 4
+sidebar_label: メニューを編集
+---
+
+# メニューを編集
+
+Modular Avatarには、オブジェクトベースのメニュー編集機能があります。これを使うと、Unityのインスペクターから簡単にメニューを編集したり、インスペクターだけでシンプルなトグルを作成したりできます。
+
+このチュートリアルでは、既存のアバターのメニューを編集する方法と、アセットに含める方法を紹介します。
+
+## 既存アバターのメニューを変換します
+
+一番簡単に始める方法は、既存のアバターのメニューを変換することです。アバターを右クリックして、`[Modular Avatar] Extract menu`を選択します。
+
+![Extracting a menu](extract-menu.png)
+
+When you do this, a new `Avatar Menu` object will be added to your avatar, containing the top level of your avatar's menu.
+
+すると、新しい`Avatar Menu`オブジェクトがアバターに追加されます。これには、アバターのメニュートップの項目が入っています。
+
+![Top-level menu](menu-toplevel.png)
+
+御覧の通り、メニューアイテムがオブジェクト化しています。各メニューアイテムを個別に見ることもできます。
+
+![Single menu item](menuitem-single.png)
+
+「オブジェクトに展開」ボタンを押すと、このサブメニューも変換できます。これでメニューの各階層をヒエラルキーで見れます。
+
+![Extracted second-level menu item](second-level-extract.png)
+
+オブジェクト化したら、アイテムをドラッグアンドドロップでメニュー内で移動させられます。
+
+### 新規メニュー項目を追加
+
+メニューを展開したら、「メニューアイテムを追加」ボタンを押すことで新しい項目を追加できます。
+
+![Add menu item button](add-menu-item-button.png)
+
+リストの最後に新規アイテムが追加されます。そのあと名前、タイプ、パラメーターなどを設定できます。
+
+サブメニューを作るなら、「タイプ」を「Sub Menu」にして、「サブメニューの引用元」を「子オブジェクトから生成」にしましょう。そしたら、サブメニューオブジェクトから「メニューアイテムを追加」を押すことで追加できます。
+
+![Creating a submenu](new-submenu-item.png)
+
+### パラメーター設定
+
+パラメーターを設定するときは、パラメーター名欄の右にある矢印を押すことで、名前で検索できます。親にあるMA Parametersコンポーネントも考慮されます。
+
+
+![Parameter search](param-search.png)
+
+## トグルを作成
+
+Modular Avatarにはヒエラルキーから簡単なトグルアニメーションを作る機能もあります。まずは簡単なON/OFFトグルを見てみましょう。
+
+![Simple toggle](simple-toggle.png)
+
+このオブジェクトは「Simple Toggle」というサンプルとして同封されます。見ての通り、MA Menu ItemにMA Action Toggle Objectを追加し、メニューアイテムをToggleタイプにし、表示・非表示にするオブジェクトを設定しただけです。
+
+Cubeの隣のチェックは、トグルがＯＮになったときは表示するべきで、ＯＦＦになったときは非表示にするべきという意味です。チェックを外すと、逆にメニューがＯＦＦのときに表示し、ＯＮのときは非表示になります。
+
+:::tip
+
+オブジェクトリストにドラッグアンドドロップでオブジェクトを簡単に追加できます。
+
+:::
+
+### 複数選択トグル
+
+もうすこし複雑なトグルを作りたいときもあるでしょう。複数のトグルを一つのグループにするためには「MA Control Group」も作ります。例を見てみましょう。
+
+![Sample control group object](control-group.png)
+
+こちらはControl Groupがついている衣装切り替えメニューです。Control group自体には設定項目がなく、メニューアイテムを一括りにするためだけにあります。各メニューアイテムも見てみましょう。
+
+![Clothing menu item: Default](clothes-0.png)
+![Clothing menu item: Blanchir](clothes-1.png)
+![Clothing menu item: SailorOnepiece](clothes-2.png)
+
+見ての通り、どれも「Toggle」タイプで、「MA Action Toggle Object」コンポーネントがついています。違うのは、Control Groupのオブジェクトを「コントロールグループ」に指定し、デフォルトの衣装に「グループの初期設定にする」をチェックしています。
+
+コントロールグループを指定すると、その中から一つのメニューアイテムしか設定できないようになります。同じパラメーターで連動するというわけです。
+
+コントロールグループに連動するアイテムのうちから一つを初期設定にできます。すると、そのトグルが最初から設定される状態になり、そのトグルで表示されるものが他のトグルでは非表示になります（その逆もしかり）。この例の場合、「Kikyo_Blouse」、「Kikyo_Coat」、「Kikyo_Skirt」を初期項目でＯＮにしたので、BlanchirとSailorOnepieceでは無効かされます。この挙動が不要の場合は、ほかの項目に該当オブジェクトを追加し、手動で設定できます。
+
+### 制限
+
+この機能は開発途中のもので、いくつか制限があります。
+
+1. 一つのオブジェクトは一つのコントロールグループまたはグループに入っていないトグルにしか操作できない。
+2. 現在、トグルの状態が保存されません。アバター変更・ワールド移動で状態が保持されないということです。
+3. 一つのトグルでアクションと通常のアニメーターを両方操作できません。
+
+今後のリリースで改善していく予定です。
+
+## 再利用できるアセットでの応用
+
+新しいメニューアイテムシステムを配布アセットなどでも利用できます。サンプルとしては、FingerpenやSimpleToggleアセットにご参照ください。
+
+簡単に解説すると、一つの項目またはサブメニューを追加するなら、MA Menu InstallerとMA Menu Itemを両方同じオブジェクトに追加してください。Menu Itemがアバターに自動的に追加されます。
+サブメニューにグループしないで複数の項目を追加する場合は、MA Menu InstallerとMA Menu Groupを両方追加しましょう。Menu Groupはサブメニューに入れずに複数の項目を追加できるようにするコンポーネントです。Extract menuと同じ仕様です。