From 8b9b3fa7e135d01ca04015f4ce5c8768c6f80a54 Mon Sep 17 00:00:00 2001
From: ousttrue <ousttrue@gmail.com>
Date: Fri, 22 Oct 2021 20:29:50 +0900
Subject: [PATCH] how_to_customize_material_import

---
 docs/gltf/0_82_glb_import.md                  | 14 +------------
 docs/gltf/how_to_customize_material_import.md | 21 +++++++++++++++++++
 docs/gltf/index.md                            |  9 ++++++--
 3 files changed, 29 insertions(+), 15 deletions(-)
 create mode 100644 docs/gltf/how_to_customize_material_import.md

diff --git a/docs/gltf/0_82_glb_import.md b/docs/gltf/0_82_glb_import.md
index 23c961b42..cab05c296 100644
--- a/docs/gltf/0_82_glb_import.md
+++ b/docs/gltf/0_82_glb_import.md
@@ -97,19 +97,7 @@ async RuntimeGltfInstance Load(GltfData data)
 
 ### materialGenerator で URP 用のマテリアルをロードする
 
-`materialGenerator` 引き数(省略可能)を指定することで URP マテリアルを生成するようにカスタムできます。
-
-```csharp
-async RuntimeGltfInstance Load(GltfData data)
-{
-    var materialGenerator = new GltfUrpMaterialDescriptorGenerator();
-    using(var loader = new UniGLTF.ImporterContext(data, materialGenerator: materialGenerator)
-    {
-        var instance = await loader.LoadAsync();
-        return instance;
-    }
-}
-```
+{doc}`Import 時に生成される Material をカスタマイズする </gltf/how_to_customize_material_import>`
 
 ## 3. インスタンスを使用する
 
diff --git a/docs/gltf/how_to_customize_material_import.md b/docs/gltf/how_to_customize_material_import.md
new file mode 100644
index 000000000..b78f2b75f
--- /dev/null
+++ b/docs/gltf/how_to_customize_material_import.md
@@ -0,0 +1,21 @@
+# Import 時に生成される Material をカスタマイズする
+
+`IMaterialDescriptorGenerator` を実装することで import 時に適用されるマテリアルを差し替えることができます。
+
+## materialGenerator で URP 用のマテリアルをロードする
+
+URP マテリアルを生成するようにカスタムする例です。
+
+<https://github.com/vrm-c/UniVRM/issues/1214>
+
+```csharp
+async RuntimeGltfInstance Load(GltfData data)
+{
+    IMaterialDescriptorGenerator materialGenerator = new GltfUrpMaterialDescriptorGenerator();
+    using(var loader = new UniGLTF.ImporterContext(data, materialGenerator: materialGenerator)
+    {
+        var instance = await loader.LoadAsync();
+        return instance;
+    }
+}
+```
diff --git a/docs/gltf/index.md b/docs/gltf/index.md
index c1332b2ad..b8893ffa0 100644
--- a/docs/gltf/index.md
+++ b/docs/gltf/index.md
@@ -12,7 +12,12 @@
 :maxdepth: 1
 
 0_82_glb_import
-how_to_impl_extension
+how_to_customize_material_import
 0_36_update
-format
+```
+
+```{toctree}
+:maxdepth: 1
+format
+how_to_impl_extension
 ```