diff --git a/translations/fr/docs/pages/api-references/customize-api-ref.mdx b/translations/fr/docs/pages/api-references/customize-api-ref.mdx
new file mode 100644
index 000000000..aff8e197f
--- /dev/null
+++ b/translations/fr/docs/pages/api-references/customize-api-ref.mdx
@@ -0,0 +1,54 @@
+---
+title: Personnaliser la mise en page de la référence API
+description: Personnalisez la mise en page de votre référence API avec Fern. Configurez les options, ordonnez les sections et endpoints, aplatissez la navigation, masquez des endpoints, affichez les erreurs et ajoutez du contenu personnalisé.
+---
+
+
+Lorsque vous [incluez une API dans votre fichier `docs.yml`](/learn/docs/api-references/generate-api-ref), vous pouvez personnaliser la façon dont les endpoints et les sections sont affichés dans la navigation latérale. Par défaut, la référence génère une hiérarchie de navigation basée sur la structure de la spécification API, mais plusieurs personnalisations peuvent être configurées.
+
+
+Si vous utilisez une spécification OpenAPI, les sections sont créées à partir de la propriété `tags`, convertie en convention `lowerCamelCase` (ex. : createUser). Si vous utilisez une Fern Definition, les sections sont créées à partir des noms de fichiers [`service`](/learn/api-definitions/ferndef/endpoints/overview#service-definition).
+
+
+Si vous souhaitez n'afficher qu'un sous-ensemble d'endpoints, consultez la propriété Audiences pour les [spécifications OpenAPI](/learn/api-definitions/openapi/extensions/audiences) ou les [Fern Definitions](/learn/api-definitions/ferndef/audiences).
+
+## Ordonner la référence API
+
+### Tri alphabétique des endpoints et sections
+
+Pour trier tous les sections et endpoints par ordre alphabétique, sauf ceux explicitement ordonnés dans `layout`, définissez `alphabetized` sur `true`.
+
+```yaml title="docs.yml"
+navigation:
+ - api: API Reference
+ alphabetized: true
+```
+
+### Ordonner les sections de premier niveau
+
+L'option `layout` vous permet de spécifier l'ordre des sous-packages, sections, endpoints et pages au premier niveau de votre référence API.
+
+
+
+ ```yaml title="docs.yml"
+ navigation:
+ - api: API Reference
+ layout:
+ - POST /user
+ - user
+ - store
+ - plant
+ ```
+
+
+ ```yaml title="docs.yml"
+ navigation:
+ - api: API Reference
+ layout:
+ - user.create
+ - user
+ - store
+ - plant
+ ```
+
+
diff --git a/translations/fr/docs/pages/api-references/generate-api-ref.mdx b/translations/fr/docs/pages/api-references/generate-api-ref.mdx
new file mode 100644
index 000000000..9bb3df0c6
--- /dev/null
+++ b/translations/fr/docs/pages/api-references/generate-api-ref.mdx
@@ -0,0 +1,106 @@
+---
+title: Générer une référence API REST
+description: Utilisez Fern Docs pour générer une documentation de référence API REST à partir d'une spécification OpenAPI ou d'une Fern Definition.
+---
+
+
+Fern génère une documentation de référence API REST à partir d'une [spécification OpenAPI](/learn/api-definitions/openapi/overview) ou d'une [Fern Definition](/learn/api-definitions/ferndef/overview). Une fois la définition de l'API configurée, il suffit d'ajouter une seule ligne de configuration pour l'intégrer à la documentation.
+
+
+ Fern prend également en charge les références [gRPC](/learn/docs/api-references/generate-grpc-ref), [WebSocket](/learn/docs/api-references/generate-websocket-ref) (AsyncAPI ou Fern Definition), [OpenRPC](/learn/docs/api-references/generate-openrpc-ref) et [Webhook](/learn/docs/api-references/generate-webhook-ref).
+
+
+## Configuration
+
+
+
+
+Pour **OpenAPI/AsyncAPI** : Ajoutez votre fichier de spécification à votre répertoire `/fern` et créez un `generators.yml` qui le référence dans la section `api.specs`
+
+Pour **Fern Definition** : Ajoutez un répertoire `definition/` avec vos fichiers de définition d'API (Fern le détecte automatiquement)
+
+```yaml generators.yml
+api:
+ specs:
+ - openapi: "./openapi.yml"
+```
+
+
+
+
+
+Ajoutez `- api: API Reference` à votre navigation dans `docs.yml` :
+
+```yml docs.yml
+navigation:
+ - api: API Reference
+```
+
+Fern remplira automatiquement vos endpoints, types et extraits de code à partir de votre définition d'API. Les exemples de requêtes et de réponses sont [générés par IA](/learn/docs/ai-features/ai-examples) pour afficher des données réalistes au lieu de valeurs fictives.
+
+
+
+Pour une liste complète des options de configuration et des personnalisations de mise en page, consultez [Personnaliser la mise en page de la référence API](/learn/docs/api-references/customize-api-reference-layout).
+
+
+
+
+### Inclure plusieurs références API
+
+Pour inclure plusieurs définitions d'API distinctes dans votre documentation, utilisez la propriété `api-name`. Le `api-name` correspond au nom du dossier contenant votre définition d'API.
+
+Cela fonctionne avec n'importe quelle combinaison de formats OpenAPI et Fern Definition. Par exemple :
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Pour une configuration simple sans onglets, vous pouvez inclure plusieurs références API directement dans votre navigation :
+
+```yaml title="docs.yml"
+navigation:
+ - api: Plant Store
+ api-name: plant-api # Correspond au nom du dossier contenant votre définition d'API
+ - api: Garden
+ api-name: garden-api # Correspond au nom du dossier contenant votre définition d'API
+```
+
+
+Lors de l'utilisation d'onglets, chaque référence API doit être placée dans le `layout` d'un onglet :
+
+```yaml title="docs.yml" {12, 17}
+tabs:
+ plant-api:
+ display-name: Plant Store API
+ icon: leaf
+ garden-api:
+ display-name: Garden API
+ icon: tree
+navigation:
+ - tab: plant-api
+ layout:
+ - api: Plant Store API
+ api-name: plant-api
+ skip-slug: true
+ - tab: garden-api
+ layout:
+ - api: Garden API
+ api-name: garden-api
+ skip-slug: true
+```
+
+
diff --git a/translations/fr/docs/pages/api-references/generate-graphql-ref.mdx b/translations/fr/docs/pages/api-references/generate-graphql-ref.mdx
new file mode 100644
index 000000000..f743e94d0
--- /dev/null
+++ b/translations/fr/docs/pages/api-references/generate-graphql-ref.mdx
@@ -0,0 +1,83 @@
+---
+title: Générer une référence GraphQL
+description: Utilisez Fern Docs pour générer une documentation de référence API GraphQL à partir d'un schéma GraphQL.
+availability: pre-release
+---
+
+La référence API GraphQL n'est pas activement maintenue. [Contactez-nous](https://buildwithfern.com/contact) si vous avez des questions.
+
+Fern génère une documentation de référence API à partir d'un [schéma GraphQL](https://graphql.org/learn/schema/). Ajoutez votre fichier de schéma à votre projet Fern et Fern affiche les requêtes, mutations, abonnements et types sous forme de référence interactive.
+
+## Configuration
+
+
+
+
+Ajoutez votre fichier de schéma GraphQL à votre répertoire `/fern` et créez un `generators.yml` qui le référence :
+
+```yaml generators.yml
+api:
+ specs:
+ - graphql: plants.schema.graphql
+ name: Plants
+ origin: https://api.example.com/plants/graphql
+```
+
+
+
+
+Ajoutez `- api: API Reference` à votre navigation dans `docs.yml` :
+
+```yml docs.yml
+navigation:
+ - api: API Reference
+```
+
+
+
+
+Pour une liste complète des options de configuration et des personnalisations de mise en page, consultez [Personnaliser la mise en page de la référence API](/learn/docs/api-references/customize-api-reference-layout).
+
+
+
+
+### Inclure plusieurs références GraphQL
+
+Pour inclure plusieurs définitions GraphQL dans votre documentation, utilisez la propriété `api-name`. Le `api-name` correspond au nom du dossier contenant votre schéma GraphQL.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+```yaml title="docs.yml"
+navigation:
+ - api: Plant GraphQL API
+ api-name: plant-graphql
+ - api: Garden GraphQL API
+ api-name: garden-graphql
+```
+
+### Propriétés de configuration
+
+
+ Chemin vers votre fichier de schéma GraphQL. Vous pouvez inclure plusieurs spécifications GraphQL si votre projet expose plus d'une API GraphQL.
+
+
+
+ Nom du dossier sous lequel les opérations de cette spécification apparaissent dans la barre latérale de la référence API. Utilisez ceci pour regrouper les opérations GraphQL associées.
+
+
+
+ URL de votre endpoint API GraphQL. Fern effectue une [introspection](https://graphql.org/learn/introspection/) sur cet endpoint pour récupérer le schéma. Lorsque défini, l'exécution de [`fern api update`](/learn/cli-api-reference/cli-reference/commands#fern-api-update) met à jour le schéma local depuis cet endpoint.
+
diff --git a/translations/fr/docs/pages/navigation/hiding-content.mdx b/translations/fr/docs/pages/navigation/hiding-content.mdx
new file mode 100644
index 000000000..d6927a872
--- /dev/null
+++ b/translations/fr/docs/pages/navigation/hiding-content.mdx
@@ -0,0 +1,98 @@
+---
+title: Masquer du contenu sur votre site
+description: Contrôlez la visibilité des pages, sections, versions et endpoints API en les masquant de votre barre latérale et des résultats de recherche.
+---
+
+Fern vous offre deux outils principaux pour contrôler la visibilité du contenu : `hidden: true` dans `docs.yml` supprime le contenu de la barre latérale et des résultats de recherche de votre site, tandis que `noindex: true` dans le frontmatter d'une page exclut une page de la recherche sans affecter la navigation.
+
+## Masquer une page
+
+### Accessible uniquement par URL directe
+
+Définissez `hidden: true` dans `docs.yml` pour supprimer une page de la barre latérale, des résultats de recherche et de [llms.txt](/learn/docs/ai-features/llms-txt) tout en la gardant accessible via un lien direct. Ceci est utile pour partager des brouillons de documentation avec des réviseurs ou pour créer des liens depuis des outils externes comme les tickets de support. Il n'est pas nécessaire de définir également `noindex` — `hidden: true` gère les deux automatiquement.
+
+```yaml title="docs.yml" {4}
+navigation:
+ - section: Introduction
+ contents:
+ - page: My Page
+ path: ./pages/my-page.mdx
+ - page: Hide and Seek
+ hidden: true
+ path: ./pages/hide-and-seek.mdx
+ - api: API Reference
+```
+
+
+Cette page est masquée de la barre latérale et des moteurs de recherche, mais vous pouvez y accéder par lien direct.
+
+
+### Exclue de la recherche uniquement
+
+Définissez `noindex: true` dans le frontmatter d'une page pour l'exclure des moteurs de recherche et de [llms.txt](/learn/docs/ai-features/llms-txt) tout en la gardant découvrable sur votre site. Ceci est utile pour la documentation en accès anticipé ou le contenu que vous souhaitez que les lecteurs trouvent via la navigation mais pas via la recherche ou les outils IA.
+
+```mdx title="early-access-feature.mdx" {3}
+---
+title: Fonctionnalité en accès anticipé
+noindex: true
+---
+```
+
+Pour plus d'options liées au SEO, consultez [Métadonnées SEO](/learn/docs/seo/setting-seo-metadata).
+
+## Masquer un endpoint API
+
+Définissez `hidden: true` dans la configuration de mise en page de l'endpoint dans `docs.yml` pour le masquer de la barre latérale. Comme pour `hidden` au niveau de la page, les endpoints masqués sont automatiquement exclus de l'indexation des moteurs de recherche, il n'est donc pas nécessaire de définir `noindex: true`.
+
+```yaml title="docs.yml" {6}
+navigation:
+ - api: API Reference
+ layout:
+ - plants:
+ - endpoint: POST /plants/{plantId}
+ hidden: true
+```
+
+Pour les détails complets de configuration, y compris des exemples pour OpenAPI, Fern Definition et les endpoints WebSocket, consultez [Masquer des endpoints](/learn/docs/api-references/customize-api-reference-layout#hiding-endpoints).
+
+## Masquer une section ou une version
+
+Masquez une section entière ou une version de la barre latérale — par exemple, une version d'API héritée ou une section de documentation d'outils internes.
+
+Contrairement au masquage d'une page ou d'un endpoint, masquer une section ou une version ne supprime que le groupe de la barre latérale. Les pages individuelles qu'elle contient restent indexées par les moteurs de recherche et l'IA car `hidden` s'applique au regroupement de la section, pas à chaque page. Pour exclure également les pages individuelles des résultats de recherche, ajoutez `noindex: true` au frontmatter de chaque page.
+
+
+
+```yaml title="docs.yml" {8}
+navigation:
+ - section: Introduction
+ contents:
+ - page: My Page
+ path: ./pages/my-page.mdx
+ - api: API Reference
+ - section: Hidden Section
+ hidden: true
+ contents:
+ - page: Hide and Seek
+ path: ./pages/hide-and-seek.mdx
+```
+
+
+
+
+
+
+```yaml title="docs.yml" {8}
+versions:
+ - display-name: v3
+ path: ./versions/v3.yml
+ - display-name: v2
+ path: ./versions/v2.yml
+ - display-name: v1 (Legacy)
+ path: ./versions/v1.yml
+ hidden: true
+```
+
+La version par défaut (la première version de votre liste `versions`) ne peut pas être masquée.
+
+
diff --git a/translations/ja/docs/pages/api-references/customize-api-ref.mdx b/translations/ja/docs/pages/api-references/customize-api-ref.mdx
new file mode 100644
index 000000000..95fd29529
--- /dev/null
+++ b/translations/ja/docs/pages/api-references/customize-api-ref.mdx
@@ -0,0 +1,450 @@
+---
+title: APIリファレンスレイアウトのカスタマイズ
+description: Fern でAPIリファレンスレイアウトをカスタマイズ。オプションの設定、セクションとエンドポイントの並べ替え、ナビゲーションのフラット化、エンドポイントの非表示、エラーの表示、カスタムコンテンツの追加が可能です。
+---
+
+
+[`docs.yml`ファイルにAPIを含める](/learn/docs/api-references/generate-api-ref)と、サイドバーナビゲーションでのエンドポイントとセクションの表示方法をカスタマイズできます。デフォルトでは、API仕様の構造に基づいてナビゲーション階層が生成されますが、いくつかのカスタマイズが設定可能です。
+
+
+OpenAPI仕様を使用している場合、セクションは`tags`プロパティに基づいて作成され、`lowerCamelCase`規則（例：createUser）に変換されます。Fern Definitionを使用している場合、セクションは[`service`](/learn/api-definitions/ferndef/endpoints/overview#service-definition)ファイル名に基づいて作成されます。
+
+
+エンドポイントのサブセットのみを表示したい場合は、[OpenAPI仕様](/learn/api-definitions/openapi/extensions/audiences)または[Fern Definition](/learn/api-definitions/ferndef/audiences)のAudiencesプロパティについてお読みください。
+
+## APIリファレンスの並べ替え
+
+### エンドポイントとセクションのアルファベット順並べ替え
+
+`layout`で明示的に順序指定されていない限り、すべてのセクションとエンドポイントをアルファベット順に並べるには、`alphabetized`を`true`に設定します。
+
+```yaml title="docs.yml"
+navigation:
+ - api: API Reference
+ alphabetized: true
+```
+
+### トップレベルセクションの並べ替え
+
+`layout`オプションを使用すると、APIリファレンスのトップレベルにあるサブパッケージ、セクション、エンドポイント、ページの順序を指定できます。
+
+
+
+ ```yaml title="docs.yml"
+ navigation:
+ - api: API Reference
+ layout:
+ - POST /user
+ - user
+ - store
+ - plant
+ ```
+
+ APIが[ネームスペース](/learn/api-definitions/overview/project-structure#combined-sdks-from-multiple-apis)を使用している場合、エンドポイントにネームスペースと`::`をプレフィックスとして付けます：
+ ```yaml title="docs.yml"
+ navigation:
+ - api: API Reference
+ layout:
+ - payments::POST /user
+ - user
+ - store
+ ```
+
+
+ ```yaml title="docs.yml"
+ navigation:
+ - api: API Reference
+ layout:
+ - user.create
+ - user
+ - store
+ - plant
+ ```
+
+
+
+
+
+
+
+### セクション内容の並べ替え
+
+
+
+ `METHOD /path`形式でエンドポイントを参照できます。
+ ```yaml title="docs.yml"
+ navigation:
+ - api: API Reference
+ layout:
+ - user:
+ - POST /user
+ - PUT /user/{username}
+ - DELETE /user/{username}
+ ```
+
+
+ `serviceName.endpointName`形式でエンドポイントを参照できます。
+ ```yaml title="docs.yml"
+ navigation:
+ - api: API Reference
+ layout:
+ - user:
+ - user.create
+ - user.update
+ - user.delete
+ ```
+
+
+ `WSS /path/name`形式でWebSocketエンドポイントを参照できます。
+ ```yaml title="docs.yml"
+ navigation:
+ - api: API Reference
+ layout:
+ - plants:
+ - GET /plants
+ - WSS /plants/live-updates
+ - WSS /plants/growth-monitor
+ ```
+
+
+
+
+
+
+
+## APIリファレンスのカスタマイズ
+
+### セクション名の変更
+
+デフォルトでは、セクション表示名は仕様の[サービスファイル名](/api-definitions/ferndef/endpoints/overview#service-definition)（Fern Definition）またはタグ名（OpenAPI）から取得されます。
+
+セクションの表示名を上書きするには、`docs.yml`で`section`プロパティを使用します。
+
+
+
+ ```yaml title="docs.yml" {4-6}
+ navigation:
+ - api: API Reference
+ layout:
+ - section: "Billing" # 新しいセクション表示名
+ referenced-packages:
+ - billing # 仕様の元のタグ名のlowerCamelCaseバージョン
+ contents: []
+ - section: "Bank Accounts"
+ referenced-packages:
+ - bankAccounts
+ contents: []
+ ```
+
+ 仕様（またはオーバーレイファイル）で[`x-displayName`拡張](/api-definitions/openapi/extensions/tag-display-names)を使用してタグ表示名を直接カスタマイズすることもできます。
+
+
+
+ ```yaml title="docs.yml" {4-6}
+ navigation:
+ - api: API Reference
+ layout:
+ - section: "Billing" # 新しいセクション表示名
+ referenced-packages:
+ - billing # 仕様の元のサービスファイル名のlowerCamelCaseバージョン
+ contents: []
+ - section: "Bank Accounts"
+ referenced-packages:
+ - bankAccounts
+ contents: []
+ ```
+
+
+
+### セクションのフラット化
+
+APIリファレンスのタイトルを削除してセクション内容を表示するには、`flattened`を`true`に設定します。
+
+```yaml title="docs.yml"
+navigation:
+ - api: API Reference
+ flattened: true
+```
+
+
+
+
+
+### エンドポイントのスタイリング
+
+エンドポイントの表示をカスタマイズするには、`title`を追加できます。`slug`を使用してエンドポイントURLをカスタマイズすることもできます。
+
+
+
+ ```yaml title="docs.yml" {6-7}
+ navigation:
+ - api: API Reference
+ layout:
+ - user:
+ - endpoint: POST /user
+ title: Create a User
+ slug: user-creation
+ - DELETE /user/{username}
+ ```
+
+
+ ```yaml title="docs.yml" {6-7}
+ navigation:
+ - api: API Reference
+ layout:
+ - user:
+ - endpoint: user.create
+ title: Create a User
+ slug: user-creation
+ - user.delete
+ ```
+
+
+ ```yaml title="docs.yml" {5-7}
+ navigation:
+ - api: API Reference
+ layout:
+ - plants:
+ - endpoint: WSS /plants/live-updates
+ title: Live plant updates
+ slug: live-updates
+ ```
+
+
+
+
+
+
+
+### エンドポイントの非表示
+
+`hidden`を`true`に設定することで、APIリファレンスからエンドポイントを非表示にできます。エンドポイントはURLでアクセス可能ですが、検索エンジンのインデックスから自動的に除外されます（`noindex`）。そのため[`noindex`を設定する必要はありません](/learn/docs/customization/hiding-content#hiding-an-api-endpoint)。
+
+
+
+ ```yaml title="docs.yml" {10}
+ navigation:
+ - api: API Reference
+ layout:
+ - user:
+ - endpoint: POST /user
+ title: Create a User
+ slug: user-creation
+ - endpoint: DELETE /user/{username}
+ hidden: true
+ ```
+
+
+ ```yaml title="docs.yml" {10}
+ navigation:
+ - api: API Reference
+ layout:
+ - user:
+ - endpoint: user.create
+ title: Create a User
+ slug: user-creation
+ - endpoint: user.delete
+ hidden: true
+ ```
+
+
+ ```yaml title="docs.yml" {6}
+ navigation:
+ - api: API Reference
+ layout:
+ - plants:
+ - endpoint: WSS /plants/live-updates
+ hidden: true
+ ```
+
+
+
+### カスタムセクションの追加
+
+`section`をAPIリファレンスレイアウトに追加することで、サイドバーに任意のフォルダを追加できます。セクションはエンドポイントのグループ全体、個々のエンドポイント、またはMarkdownページだけで構成できます。セクションは`icon`、`summary`、`slug`（または`skip-slug`）、`availability`、`contents`などのプロパティを追加してカスタマイズできます。
+
+
+
+ ```yaml title="docs.yml"
+ navigation:
+ - api: API Reference
+ layout:
+ - section: My Section
+ icon: flower
+ contents:
+ - PUT /user/{username}
+ - plant
+ - plantInfo # タグ名はcamelCase規則に変換されます
+ ```
+
+
+ ```yaml title="docs.yml"
+ navigation:
+ - api: API Reference
+ layout:
+ - section: My Section
+ icon: flower
+ contents:
+ - user.update
+ - plant
+ ```
+
+
+
+
+
+
+
+### セクション概要の追加
+
+APIリファレンスまたは個々のセクションに概要ページを2つの方法で追加できます：
+
+
+
+ `summary`プロパティを使用して、`.md`または`.mdx`ページを概要として追加できます。
+
+ ```yaml title="docs.yml"
+ navigation:
+ - api: API Reference
+ summary: pages/api-overview.mdx
+ layout:
+ - user:
+ summary: pages/user-overview.mdx
+ ```
+
+
+ OpenAPI仕様を使用している場合、`tag-description-pages: true`を設定すると、タグの説明を各セクションのサマリーページとして使用できます。
+
+ ```yaml title="docs.yml"
+ navigation:
+ - api: API Reference
+ tag-description-pages: true
+ ```
+
+
+ `tag-description-pages: true`を有効にし、セクションに手動で`summary`を指定した場合、手動のサマリーが優先されます。
+
+
+
+
+
+
+
+
+### ページとリンクの追加
+
+APIリファレンス内に通常のページと外部リンクを追加できます。
+
+```yaml title="docs.yml"
+navigation:
+ - api: API Reference
+ layout:
+ - user:
+ contents:
+ - page: User Guide
+ path: ./docs/pages/user-guide.mdx
+ - link: Link Title
+ href: http://google.com
+```
+
+### 可用性の追加
+
+APIリファレンス全体または特定のセクションに可用性を設定できます。オプション：`stable`、`generally-available`、`in-development`、`pre-release`、`deprecated`、`beta`。
+
+```yaml title="docs.yml" {3, 6}
+navigation:
+ - api: API Reference
+ availability: generally-available
+ layout:
+ - section: My Section
+ availability: beta
+ icon: flower
+ contents:
+ # エンドポイントをここに配置
+```
+
+セクションに可用性を設定すると、そのセクション内のすべてのエンドポイントは、API定義で明示的に上書きされない限り、セクションレベルの可用性を継承します。
+
+
+ `docs.yml`で個々のOpenAPIおよびFern Definitionエンドポイントに可用性を設定することはできません — エンドポイントの可用性はAPI定義で直接設定する必要があります。[OpenAPI](/learn/api-definitions/openapi/extensions/availability)または[Fern Definition](/learn/api-definitions/ferndef/availability)の可用性について詳しくはこちら。
+
+
+### エンドポイントエラーの表示
+
+`display-errors`を`true`に設定すると、エンドポイントページにエラースキーマを表示します。エラー名、ステータスコード、レスポンスオブジェクトはAPI定義から取得されます。
+
+```yaml title="docs.yml"
+navigation:
+ - api: API Reference
+ display-errors: true
+```
+
+
+
+
+
+エラーをクリックすると展開され、エラー名、コード、返されるオブジェクトが表示されます。レスポンスもエラーオブジェクトを表示するように更新されます。
+
+
+
+
+
+## 設定オプションリファレンス
+
+以下のプロパティは`docs.yml`ナビゲーションの`- api`エントリで設定できます。
+
+
+ `true`の場合、すべてのセクションとエンドポイントをアルファベット順に整理します。
+
+
+
+ APIリファレンスセクションのタイトル。
+
+
+
+ APIリファレンスに表示されるエンドポイント、スキーマ、プロパティを決定する[オーディエンス](/learn/docs/api-references/audiences)のリスト。
+
+
+
+ APIリファレンス全体または特定のセクションの[可用性ステータス](#adding-availability)を設定します。
+
+
+
+ APIリファレンスのエンドポイントページに[エラースキーマ](#displaying-endpoint-errors)を表示します。
+
+
+
+ すべてのエンドポイントをトップレベルに表示し、APIリファレンスセクションのタイトルを非表示にします。
+
+
+
+ ナビゲーションのAPIセクションの横に表示するアイコン。
+
+
+
+ APIエンドポイントがドキュメントサイトに表示される順序をカスタマイズします。詳細は[APIリファレンスの並べ替え](#ordering-the-api-reference)を参照してください。
+
+
+
+ すべてのエンドポイントを個別のページに表示します。デフォルトでは、エンドポイントは1つの長いページに表示されます。
+
+
+
+ `true`の場合、APIセクションのスラグ生成をスキップします。
+
+
+
+ APIセクションのスラグをカスタマイズします。デフォルトでは、スラグはAPIタイトルから生成されます。
+
+
+
+ APIセクションの上部に表示されるMarkdownファイルへの相対パス。
+
+
+
+ `true`の場合、OpenAPIタグの説明を各セクションのサマリーページとして使用します。
+
+
+
+ プロジェクトに[複数のAPI](/learn/docs/api-references/generate-api-ref#include-more-than-one-api-reference)がある場合のみ使用。値はAPI定義を含むフォルダ名と一致する必要があります。単一のAPIのみの場合はこのプロパティを設定しないでください。エラーの原因となります。
+
diff --git a/translations/ja/docs/pages/api-references/generate-api-ref.mdx b/translations/ja/docs/pages/api-references/generate-api-ref.mdx
new file mode 100644
index 000000000..2ebb760c7
--- /dev/null
+++ b/translations/ja/docs/pages/api-references/generate-api-ref.mdx
@@ -0,0 +1,106 @@
+---
+title: REST APIリファレンスの生成
+description: Fern Docsを使用して、OpenAPI仕様またはFern DefinitionからREST APIリファレンスドキュメントを生成します。
+---
+
+
+FernはREST APIリファレンスドキュメントを[OpenAPI仕様](/learn/api-definitions/openapi/overview)または[Fern Definition](/learn/api-definitions/ferndef/overview)から生成します。API定義のセットアップが完了したら、1行の設定を追加するだけでドキュメントに組み込めます。
+
+
+ Fernは[gRPC](/learn/docs/api-references/generate-grpc-ref)、[WebSocket](/learn/docs/api-references/generate-websocket-ref)（AsyncAPIまたはFern Definition）、[OpenRPC](/learn/docs/api-references/generate-openrpc-ref)、[Webhook](/learn/docs/api-references/generate-webhook-ref)リファレンスもサポートしています。
+
+
+## 設定
+
+
+
+
+**OpenAPI/AsyncAPI**の場合：仕様ファイルを`/fern`ディレクトリに追加し、`api.specs`セクションで参照する`generators.yml`を作成します
+
+**Fern Definition**の場合：API定義ファイルを含む`definition/`ディレクトリを追加します（Fernが自動検出します）
+
+```yaml generators.yml
+api:
+ specs:
+ - openapi: "./openapi.yml"
+```
+
+
+
+
+
+`docs.yml`のナビゲーションに`- api: API Reference`を追加します：
+
+```yml docs.yml
+navigation:
+ - api: API Reference
+```
+
+Fernは、API定義からエンドポイント、型、コードスニペットを自動的に設定します。リクエストとレスポンスの例は、プレースホルダー値の代わりにリアルなデータを表示するために[AIを使用して生成](/learn/docs/ai-features/ai-examples)されます。
+
+
+
+設定オプションとレイアウトのカスタマイズの一覧については、[APIリファレンスレイアウトのカスタマイズ](/learn/docs/api-references/customize-api-reference-layout)を参照してください。
+
+
+
+
+### 複数のAPIリファレンスを含める
+
+ドキュメントに複数の異なるAPI定義を含めるには、`api-name`プロパティを使用します。`api-name`はAPI定義を含むフォルダ名に対応します。
+
+これは、OpenAPIとFern Definitionフォーマットの任意の組み合わせで動作します。例：
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+タブを使わないシンプルな設定では、複数のAPIリファレンスをナビゲーションに直接含めることができます：
+
+```yaml title="docs.yml"
+navigation:
+ - api: Plant Store
+ api-name: plant-api # API定義を含むフォルダ名と一致
+ - api: Garden
+ api-name: garden-api # API定義を含むフォルダ名と一致
+```
+
+
+タブを使用する場合、各APIリファレンスはタブの`layout`内に配置する必要があります：
+
+```yaml title="docs.yml" {12, 17}
+tabs:
+ plant-api:
+ display-name: Plant Store API
+ icon: leaf
+ garden-api:
+ display-name: Garden API
+ icon: tree
+navigation:
+ - tab: plant-api # 上で定義したタブを参照
+ layout:
+ - api: Plant Store API
+ api-name: plant-api # API定義を含むフォルダ名と一致
+ skip-slug: true
+ - tab: garden-api # 上で定義したタブを参照
+ layout:
+ - api: Garden API
+ api-name: garden-api # API定義を含むフォルダ名と一致
+ skip-slug: true
+```
+
+
diff --git a/translations/ja/docs/pages/api-references/generate-graphql-ref.mdx b/translations/ja/docs/pages/api-references/generate-graphql-ref.mdx
new file mode 100644
index 000000000..9e722b8b4
--- /dev/null
+++ b/translations/ja/docs/pages/api-references/generate-graphql-ref.mdx
@@ -0,0 +1,83 @@
+---
+title: GraphQLリファレンスの生成
+description: Fern Docsを使用して、GraphQLスキーマからGraphQL APIリファレンスドキュメントを生成します。
+availability: pre-release
+---
+
+GraphQL APIリファレンスは現在積極的にメンテナンスされていません。ご質問がある場合は[お問い合わせ](https://buildwithfern.com/contact)ください。
+
+Fernは[GraphQLスキーマ](https://graphql.org/learn/schema/)からAPIリファレンスドキュメントを生成します。スキーマファイルをFernプロジェクトに追加すると、Fernがクエリ、ミューテーション、サブスクリプション、型をインタラクティブなリファレンスとしてレンダリングします。
+
+## 設定
+
+
+
+
+GraphQLスキーマファイルを`/fern`ディレクトリに追加し、それを参照する`generators.yml`を作成します：
+
+```yaml generators.yml
+api:
+ specs:
+ - graphql: plants.schema.graphql
+ name: Plants
+ origin: https://api.example.com/plants/graphql
+```
+
+
+
+
+`docs.yml`のナビゲーションに`- api: API Reference`を追加します：
+
+```yml docs.yml
+navigation:
+ - api: API Reference
+```
+
+
+
+
+設定オプションとレイアウトのカスタマイズの一覧については、[APIリファレンスレイアウトのカスタマイズ](/learn/docs/api-references/customize-api-reference-layout)を参照してください。
+
+
+
+
+### 複数のGraphQLリファレンスを含める
+
+ドキュメントに複数のGraphQL定義を含めるには、`api-name`プロパティを使用します。`api-name`はGraphQLスキーマを含むフォルダ名に対応します。
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+```yaml title="docs.yml"
+navigation:
+ - api: Plant GraphQL API
+ api-name: plant-graphql
+ - api: Garden GraphQL API
+ api-name: garden-graphql
+```
+
+### 設定プロパティ
+
+
+ GraphQLスキーマファイルへのパス。プロジェクトが複数のGraphQL APIを公開している場合、複数のGraphQL仕様を含めることができます。
+
+
+
+ この仕様のオペレーションがAPIリファレンスサイドバーに表示されるフォルダの名前。関連するGraphQLオペレーションをグループ化するために使用します。
+
+
+
+ GraphQL APIエンドポイントのURL。Fernはこのエンドポイントに対して[イントロスペクション](https://graphql.org/learn/introspection/)を実行してスキーマを取得します。設定すると、[`fern api update`を実行する](/learn/cli-api-reference/cli-reference/commands#fern-api-update)ことでこのエンドポイントからローカルスキーマが更新されます。
+
diff --git a/translations/ja/docs/pages/navigation/hiding-content.mdx b/translations/ja/docs/pages/navigation/hiding-content.mdx
new file mode 100644
index 000000000..8c3fc9669
--- /dev/null
+++ b/translations/ja/docs/pages/navigation/hiding-content.mdx
@@ -0,0 +1,98 @@
+---
+title: サイト内のコンテンツを非表示にする
+description: ページ、セクション、バージョン、APIエンドポイントをサイドバーや検索結果から非表示にして、表示を制御します。
+---
+
+Fernにはコンテンツの表示を制御する2つの主要なツールがあります：`docs.yml`の`hidden: true`はサイトのサイドバーと検索結果からコンテンツを削除し、ページのフロントマターの`noindex: true`はナビゲーションに影響を与えずにページを検索から除外します。
+
+## ページを非表示にする
+
+### 直接URLでのみアクセス可能
+
+`docs.yml`で`hidden: true`を設定すると、ページをサイドバー、検索結果、[llms.txt](/learn/docs/ai-features/llms-txt)から削除しつつ、直接リンクでアクセス可能な状態を維持します。これは、レビュー担当者とドラフトドキュメントを共有したり、サポートチケットなどの外部ツールからリンクする際に便利です。`noindex`を別途設定する必要はありません — `hidden: true`が自動的に両方を処理します。
+
+```yaml title="docs.yml" {4}
+navigation:
+ - section: Introduction
+ contents:
+ - page: My Page
+ path: ./pages/my-page.mdx
+ - page: Hide and Seek
+ hidden: true
+ path: ./pages/hide-and-seek.mdx
+ - api: API Reference
+```
+
+
+このページはサイドバーと検索エンジンから非表示ですが、直接リンクでアクセスできます。
+
+
+### 検索からのみ除外
+
+ページのフロントマターで`noindex: true`を設定すると、検索エンジンと[llms.txt](/learn/docs/ai-features/llms-txt)から除外しつつ、サイト上で発見可能な状態を維持します。これは、早期アクセスドキュメントや、読者にはナビゲーションから見つけてほしいが検索やAIツールからは見つけてほしくないコンテンツに便利です。
+
+```mdx title="early-access-feature.mdx" {3}
+---
+title: 早期アクセス機能
+noindex: true
+---
+```
+
+SEO関連のオプションについては、[SEOメタデータ](/learn/docs/seo/setting-seo-metadata)を参照してください。
+
+## APIエンドポイントを非表示にする
+
+`docs.yml`のエンドポイントのレイアウト設定で`hidden: true`を設定すると、サイドバーから非表示にできます。ページレベルの`hidden`と同様に、非表示のエンドポイントは検索エンジンのインデックスから自動的に除外されるため、`noindex: true`を設定する必要はありません。
+
+```yaml title="docs.yml" {6}
+navigation:
+ - api: API Reference
+ layout:
+ - plants:
+ - endpoint: POST /plants/{plantId}
+ hidden: true
+```
+
+OpenAPI、Fern Definition、WebSocketエンドポイントの例を含む完全な設定の詳細については、[エンドポイントの非表示](/learn/docs/api-references/customize-api-reference-layout#hiding-endpoints)を参照してください。
+
+## セクションまたはバージョンを非表示にする
+
+セクション全体またはバージョンをサイドバーから非表示にします — 例えば、レガシーAPIバージョンや内部ツールドキュメントのセクションなど。
+
+ページやエンドポイントの非表示とは異なり、セクションやバージョンの非表示はグループをサイドバーから削除するだけです。その中の個々のページは検索エンジンやAIによってインデックスされたままです。`hidden`はセクションのグループに適用され、各ページには適用されないためです。個々のページも検索結果から除外するには、各ページのフロントマターに`noindex: true`を追加してください。
+
+
+
+```yaml title="docs.yml" {8}
+navigation:
+ - section: Introduction
+ contents:
+ - page: My Page
+ path: ./pages/my-page.mdx
+ - api: API Reference
+ - section: Hidden Section
+ hidden: true
+ contents:
+ - page: Hide and Seek
+ path: ./pages/hide-and-seek.mdx
+```
+
+
+
+
+
+
+```yaml title="docs.yml" {8}
+versions:
+ - display-name: v3
+ path: ./versions/v3.yml
+ - display-name: v2
+ path: ./versions/v2.yml
+ - display-name: v1 (Legacy)
+ path: ./versions/v1.yml
+ hidden: true
+```
+
+デフォルトバージョン（`versions`リストの最初のバージョン）は非表示にできません。
+
+