🌐 Add Japanese translation for Advanced - Path Operation Advanced Configuration ...

Co-authored-by: T. Tokusumi <41147016+tokusumi@users.noreply.github.com>

diff --git a/docs/ja/docs/advanced/path-operation-advanced-configuration.md b/docs/ja/docs/advanced/path-operation-advanced-configuration.md
new file mode 100644 (file)
index 0000000..35b381c
--- /dev/null
+++ b/docs/ja/docs/advanced/path-operation-advanced-configuration.md
@@ -0,0 +1,52 @@
+# Path Operationの高度な設定
+
+## OpenAPI operationId
+
+!!! warning "注意"
+    あなたがOpenAPIの「エキスパート」でなければ、これは必要ないかもしれません。
+
+*path operation* で `operation_id` パラメータを利用することで、OpenAPIの `operationId` を設定できます。
+
+`operation_id` は各オペレーションで一意にする必要があります。
+
+```Python hl_lines="6"
+{!../../../docs_src/path_operation_advanced_configuration/tutorial001.py!}
+```
+
+### *path operation関数* の名前をoperationIdとして使用する
+
+APIの関数名を `operationId` として利用したい場合、すべてのAPIの関数をイテレーションし、各 *path operation* の `operationId` を `APIRoute.name` で上書きすれば可能です。
+
+そうする場合は、すべての *path operation* を追加した後に行う必要があります。
+
+```Python hl_lines="2  12-21  24"
+{!../../../docs_src/path_operation_advanced_configuration/tutorial002.py!}
+```
+
+!!! tip "豆知識"
+    `app.openapi()` を手動でコールする場合、その前に`operationId`を更新する必要があります。
+
+!!! warning "注意"
+    この方法をとる場合、各 *path operation関数* が一意な名前である必要があります。
+
+    それらが異なるモジュール (Pythonファイル) にあるとしてもです。
+
+## OpenAPIから除外する
+
+生成されるOpenAPIスキーマ (つまり、自動ドキュメント生成の仕組み) から *path operation* を除外するには、 `include_in_schema` パラメータを `False` にします。
+
+```Python hl_lines="6"
+{!../../../docs_src/path_operation_advanced_configuration/tutorial003.py!}
+```
+
+## docstringによる説明の高度な設定
+
+*path operation関数* のdocstringからOpenAPIに使用する行を制限することができます。
+
+`\f` (「書式送り (Form Feed)」のエスケープ文字) を付与することで、**FastAPI** はOpenAPIに使用される出力をその箇所までに制限します。
+
+ドキュメントには表示されませんが、他のツール (例えばSphinx) では残りの部分を利用できるでしょう。
+
+```Python hl_lines="19-29"
+{!../../../docs_src/path_operation_advanced_configuration/tutorial004.py!}
+```

diff --git a/docs/ja/mkdocs.yml b/docs/ja/mkdocs.yml
index 17350be964afb5b47c7ab8745df736795493d8c5..268b7a0decc260f72fbb0b544b6ca70ddf94ffd2 100644 (file)
--- a/docs/ja/mkdocs.yml
+++ b/docs/ja/mkdocs.yml
@@ -66,6 +66,7 @@ nav:
     - tutorial/security/first-steps.md
   - tutorial/cors.md
 - 高度なユーザーガイド:
+  - advanced/path-operation-advanced-configuration.md
   - advanced/additional-status-codes.md
   - advanced/response-directly.md
   - advanced/custom-response.md