From 6ded4227ec3f2b4bfa2c148e727a564eb3f48d3a Mon Sep 17 00:00:00 2001
From: Suzana Dirla <dirla.silvia.suzana@gmail.com>
Date: Fri, 13 Sep 2019 15:29:00 +0300
Subject: [PATCH] Japanese docs - add language picker with Japanese & fix links
 (#1202)

---
 docs/extending/README.md                      |   1 +
 docs/extending/application-features.md        |   2 +-
 docs/extending/extension-format.md            |   2 +-
 docs/extending/routes.md                      |   2 +-
 docs/index.html                               | 112 ++++++++++++++----
 docs/ja/README.md                             |  11 +-
 docs/ja/extending/README.md                   |  26 ++--
 docs/ja/extending/actions.md                  |   3 +-
 docs/ja/extending/application-actions.md      |   1 +
 docs/ja/extending/application-features.md     |   9 +-
 docs/ja/extending/components.md               |   3 +-
 .../extending/creating-custom-evaluators.md   |   3 +-
 docs/ja/extending/extensibility-features.md   |   1 +
 docs/ja/extending/extension-format.md         |   3 +-
 docs/ja/extending/icons.md                    |   1 +
 .../ja/extending/redistributable-libraries.md |   1 +
 docs/ja/extending/registration.md             |   1 +
 docs/ja/extending/routes.md                   |   9 +-
 docs/ja/extending/rules.md                    |   3 +-
 docs/ja/extending/tutorials.md                |   1 +
 docs/ja/features/README.md                    |  17 +--
 docs/ja/features/document-list-layout.md      |   1 +
 docs/ja/features/file-viewer.md               |   1 +
 docs/ja/features/header.md                    |   7 +-
 docs/ja/features/info-drawer.md               |   1 +
 docs/ja/features/search-results.md            |   1 +
 docs/ja/features/side-navigation.md           |   1 +
 docs/ja/features/user-interface-layout.md     |   7 +-
 docs/ja/features/version-manager.md           |   1 +
 docs/ja/getting-started/README.md             |  17 +--
 .../getting-started/building-from-source.md   |   1 +
 docs/ja/getting-started/configuration.md      |   1 +
 docs/ja/getting-started/cors.md               |   1 +
 docs/ja/getting-started/docker.md             |   1 +
 .../getting-started/internationalization.md   |   1 +
 docs/ja/getting-started/navigation.md         |   5 +-
 docs/ja/getting-started/prerequisites.md      |   1 +
 docs/ja/getting-started/sso.md                |   1 +
 docs/ja/help.md                               |   1 +
 docs/ja/toc.md                                |  78 ++++++------
 docs/ja/tutorials/README.md                   |   7 +-
 .../tutorials/custom-route-with-parameters.md |   1 +
 docs/ja/tutorials/dialog-actions.md           |   1 +
 .../ja/tutorials/introduction-to-extending.md |   1 +
 docs/toc.md                                   |   4 +-
 45 files changed, 227 insertions(+), 127 deletions(-)

diff --git a/docs/extending/README.md b/docs/extending/README.md
index 20c56a4a4..1a4c68a45 100644
--- a/docs/extending/README.md
+++ b/docs/extending/README.md
@@ -17,6 +17,7 @@ Learn how to extend the features of the Alfresco Content Application.
 - [Application actions](/extending/application-actions)
 - [Rules](/extending/rules)
 - [Application features](/extending/application-features)
+- [Custom icons](/extending/icons)
 - [Registration](/extending/registration)
 - [Creating custom evaluators](/extending/creating-custom-evaluators)
 - [Tutorials](/extending/tutorials)
diff --git a/docs/extending/application-features.md b/docs/extending/application-features.md
index d9449fd15..1868862ac 100644
--- a/docs/extending/application-features.md
+++ b/docs/extending/application-features.md
@@ -115,7 +115,7 @@ You can populate the menu with an extra entries like in the example below:
 }
 ```
 
-Please refer to the [Content Actions](/extending/application-features#content-actions) section for more details on supported properties.
+Please refer to the [Content Actions](#content-actions) section for more details on supported properties.
 
 **Tip:** It is also possible to update or disable existing entries from within the external extension files. You will need to know the `id` of the target element to customize.
 
diff --git a/docs/extending/extension-format.md b/docs/extending/extension-format.md
index 1259eb654..24a259e06 100644
--- a/docs/extending/extension-format.md
+++ b/docs/extending/extension-format.md
@@ -201,7 +201,7 @@ Final result:
 }
 ```
 
-You can find more details in the [Disabling Content](/extending/extension-format#disabling-content) section
+You can find more details in the [Disabling Content](#disabling-content) section
 
 ### Merging arrays
 
diff --git a/docs/extending/routes.md b/docs/extending/routes.md
index 5ba8af0db..f4ea2b63a 100644
--- a/docs/extending/routes.md
+++ b/docs/extending/routes.md
@@ -31,7 +31,7 @@ To create a new route, populate the `routes` section with the corresponding entr
 | **path**      | Runtime path of the route.                                                             |
 | **component** | The main [component](/extending/components) to use for the route.                                |
 | layout        | The layout [component](/extending/components) to use for the route.                              |
-| auth          | List of [authentication guards](/extending/routes#authentication-guards). Defaults to `[ "app.auth" ]`. |
+| auth          | List of [authentication guards](#authentication-guards). Defaults to `[ "app.auth" ]`. |
 | data          | Custom property bag to carry with the route.                                           |
 
 Use the `app.layout.main` value for the `layout` property to get the default application layout,
diff --git a/docs/index.html b/docs/index.html
index a7e9579a5..7e9a280eb 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -16,34 +16,94 @@
     <script src="https://unpkg.com/docute@3/dist/docute.js"></script>
     <script src="https://unpkg.com/prismjs/components/prism-typescript.js"></script>
     <script>
+      var langs = [
+        { title: 'English', path: '/' },
+        { title: '日本語', path: '/ja/', matchPath: /^\/ja[\/$]/ }
+      ];
+
       docute.init({
-        toc: 'toc.md',
-        nav: [
-          {
-            title: 'Home',
-            path: '/'
-          },
-          {
-            title: 'App features',
-            path: '/features/'
-          },
-          {
-            title: 'Getting Started',
-            path: '/getting-started/'
-          },
-          {
-            title: 'Extending',
-            path: '/extending/'
-          },
-          {
-            title: 'Tutorials',
-            path: '/tutorials/'
-          },
-          {
-            title: 'Get Help',
-            path: '/help'
+        url: '.',
+        toc: $route => {
+          const isJapaneseLang = $route.path.split('/')[1] === 'ja';
+          const wasJapaneseLang = $route.from.path.split('/')[1] === 'ja';
+
+          if (wasJapaneseLang !== isJapaneseLang) {
+            const isFirstPageLoad =
+              $route.from.path === '/' && $route.from.meta.name !== 'home';
+            if (!isFirstPageLoad) {
+              document.location.reload();
+            }
           }
-        ],
+
+          if (isJapaneseLang) {
+            return './ja/toc.md';
+          }
+          return './toc.md';
+        },
+        nav: {
+          default: [
+            {
+              title: 'English',
+              type: 'dropdown',
+              items: langs
+            },
+            {
+              title: 'Home',
+              path: '/'
+            },
+            {
+              title: 'App features',
+              path: '/features/'
+            },
+            {
+              title: 'Getting Started',
+              path: '/getting-started/'
+            },
+            {
+              title: 'Extending',
+              path: '/extending/'
+            },
+            {
+              title: 'Tutorials',
+              path: '/tutorials/'
+            },
+            {
+              title: 'Get Help',
+              path: '/help'
+            }
+          ],
+          ja: [
+            {
+              title: '日本語',
+              type: 'dropdown',
+              items: langs
+            },
+            {
+              title: 'ホーム',
+              path: '/ja/'
+            },
+            {
+              title: 'アプリの機能',
+              path: '/ja/features/'
+            },
+            {
+              title: '入門',
+              path: '/ja/getting-started/'
+            },
+            {
+              title: '拡張',
+              path: '/ja/extending/'
+            },
+            {
+              title: 'チュートリアル',
+              path: '/ja/tutorials/'
+            },
+            {
+              title: 'ヘルプ',
+              path: '/ja/help'
+            }
+          ]
+        },
         icons: [
           {
             icon: 'github',
diff --git a/docs/ja/README.md b/docs/ja/README.md
index 95731a4b8..b2806a1c2 100644
--- a/docs/ja/README.md
+++ b/docs/ja/README.md
@@ -1,6 +1,7 @@
 ---
 Title: Alfresco Content Application
 Github only: true
+nav: ja
 ---
 
 # Alfresco Content Application
@@ -14,11 +15,11 @@ Alfresco Content Application は、[Alfresco Application Development Framework (
 
 ドキュメントは次のセクションに分かれています:
 
-- [アプリの機能](/features/): ユーザーインターフェイスとアプリの使用方法の詳細。
-- [入門](/getting-started/): 開発環境とアプリの構成。
-- [拡張](/extending/): 独自のコードでアプリの機能を拡張する方法。
-- [チュートリアル](/tutorials/): 開発技術の詳細な調査。
-- [ヘルプ](/help): さらなるヘルプとサポートの詳細が利用可能です。
+- [アプリの機能](/ja/features/): ユーザーインターフェイスとアプリの使用方法の詳細。
+- [入門](/ja/getting-started/): 開発環境とアプリの構成。
+- [拡張](/ja/extending/): 独自のコードでアプリの機能を拡張する方法。
+- [チュートリアル](/ja/tutorials/): 開発技術の詳細な調査。
+- [ヘルプ](/ja/help): さらなるヘルプとサポートの詳細が利用可能です。
 
 ## 互換性
 
diff --git a/docs/ja/extending/README.md b/docs/ja/extending/README.md
index 8ed4a8f6b..88b66c6aa 100644
--- a/docs/ja/extending/README.md
+++ b/docs/ja/extending/README.md
@@ -1,6 +1,7 @@
 ---
 Title: 拡張
 Github only: true
+nav: ja
 ---
 
 # 拡張
@@ -9,15 +10,16 @@ Alfresco Content Application の機能を拡張する方法を学びます。
 
 ## コンテンツ
 
-- [拡張機能](/extending/extensibility-features)
-- [拡張フォーマット](/extending/extension-format)
-- [ルート](/extending/routes)
-- [コンポーネント](/extending/components)
-- [アクション](/extending/actions)
-- [アプリケーションアクション](/extending/application-actions)
-- [ルール](/extending/rules)
-- [アプリケーションの機能](/extending/application-features)
-- [登録](/extending/registration)
-- [カスタムエバリュエータの作成](/extending/creating-custom-evaluators)
-- [チュートリアル](/extending/tutorials)
-- [再配布可能なライブラリ](/extending/redistributable-libraries)
+- [拡張機能](/ja/extending/extensibility-features)
+- [拡張フォーマット](/ja/extending/extension-format)
+- [ルート](/ja/extending/routes)
+- [コンポーネント](/ja/extending/components)
+- [アクション](/ja/extending/actions)
+- [アプリケーションアクション](/ja/extending/application-actions)
+- [ルール](/ja/extending/rules)
+- [アプリケーションの機能](/ja/extending/application-features)
+- [カスタムアイコン](/ja/extending/icons)
+- [登録](/ja/extending/registration)
+- [カスタムエバリュエータの作成](/ja/extending/creating-custom-evaluators)
+- [チュートリアル](/ja/extending/tutorials)
+- [再配布可能なライブラリ](/ja/extending/redistributable-libraries)
diff --git a/docs/ja/extending/actions.md b/docs/ja/extending/actions.md
index b5e82c50b..0f4935c89 100644
--- a/docs/ja/extending/actions.md
+++ b/docs/ja/extending/actions.md
@@ -1,5 +1,6 @@
 ---
 Title: アクション
+nav: ja
 ---
 
 # アクション
@@ -9,7 +10,7 @@ Title: アクション
 | プロパティ名 | 説明 |
 | -- | -- |
 | **id** | 一意の識別子。 |
-| **type** | アクションタイプ。詳細については、[アプリケーションアクション](/extending/application-actions) を参照してください。 |
+| **type** | アクションタイプ。詳細については、[アプリケーションアクション](/ja/extending/application-actions) を参照してください。 |
 | **payload** | アクションペイロード、値または式を含む文字列。 |
 
 ```json
diff --git a/docs/ja/extending/application-actions.md b/docs/ja/extending/application-actions.md
index c61024154..f7e01ad9e 100644
--- a/docs/ja/extending/application-actions.md
+++ b/docs/ja/extending/application-actions.md
@@ -1,5 +1,6 @@
 ---
 Title: アプリケーションアクション
+nav: ja
 ---
 
 # アプリケーションアクション
diff --git a/docs/ja/extending/application-features.md b/docs/ja/extending/application-features.md
index 0c1228e20..cbb443d20 100644
--- a/docs/ja/extending/application-features.md
+++ b/docs/ja/extending/application-features.md
@@ -1,5 +1,6 @@
 ---
 Title: アプリケーションの機能
+nav: ja
 ---
 
 # アプリケーションの機能
@@ -115,7 +116,7 @@ interface ContentActionRef {
 }
 ```
 
-サポートされているプロパティの詳細については、[コンテンツアクション](/extending/application-features#content-actions) セクションを参照してください。
+サポートされているプロパティの詳細については、[コンテンツアクション](#コンテンツアクション) セクションを参照してください。
 
 **Tip:** 外部拡張ファイル内から既存のエントリを更新または無効にすることもできます。カスタマイズするには、ターゲット要素の `id` を知る必要があります。
 
@@ -234,14 +235,14 @@ export interface NavBarLinkRef {
 対応するすべてのコンポーネントは、実行環境で使用するために登録する必要があります。
 
 **Tip:** 実行時に再利用される独自のエントリを登録する方法の詳細については、
-[登録](/extending/registration) セクションを参照してください。
+[登録](/ja/extending/registration) セクションを参照してください。
 
 ### タブプロパティ
 
 | プロパティ名          | 説明                                                       |
 | ------------- | ----------------------------------------------------------------- |
 | **id**        | 一意の識別子。                                                |
-| **component** | ルートに使用するメインの[コンポーネント](/extending/components)。 |
+| **component** | ルートに使用するメインの[コンポーネント](/ja/extending/components)。 |
 | **title**     | タブのタイトルまたはリソースのキー                                       |
 | icon          | タブのアイコン                                                          |
 | disabled      | 無効状態を切り替えます。他のプラグインから割り当てることができます。       |
@@ -584,7 +585,7 @@ export interface ViewerRules {
 
 `app.extensions.json` からこれらのプリセットを設定すると、デフォルトのアプリケーション設定が上書きされます。
 カスタムプラグインから設定すると、これらのプリセットを無効化、更新、または拡張できます。
-拡張機能のマージに関する詳細はこちらをご覧ください[here](/extending/extension-format#merging-properties)。
+拡張機能のマージに関する詳細はこちらをご覧ください[here](/ja/extending/extension-format#プロパティのマージ)。
 
 `content-metadata-presets` 要素は、`disabled` プロパティを設定することでオフにできます。
 これはネストされたアイテムにも適用でき、アスペクトレベルまで無効にできます。
diff --git a/docs/ja/extending/components.md b/docs/ja/extending/components.md
index 65ccae6d6..4e354643c 100644
--- a/docs/ja/extending/components.md
+++ b/docs/ja/extending/components.md
@@ -1,5 +1,6 @@
 ---
 Title: コンポーネント
+nav: ja
 ---
 
 # コンポーネント
@@ -22,7 +23,7 @@ Title: コンポーネント
 | app.toolbar.viewNode              | ViewNodeComponent              | ファイルを表示するアクションコンポーネント。                                                                                  |
 
 実行時に再利用される独自のエントリを登録する方法の詳細については、
-[登録](/extending/registration) セクションを参照してください。
+[登録](/ja/extending/registration) セクションを参照してください。
 
 カスタム拡張機能は、新しいコンポーネントを登録するだけでなく、
 実行時に既存のコンポーネントを既知の識別子で置き換えることもできます。
diff --git a/docs/ja/extending/creating-custom-evaluators.md b/docs/ja/extending/creating-custom-evaluators.md
index e97f83672..f7242b273 100644
--- a/docs/ja/extending/creating-custom-evaluators.md
+++ b/docs/ja/extending/creating-custom-evaluators.md
@@ -1,5 +1,6 @@
 ---
 Title: カスタムエバリュエータの作成
+nav: ja
 ---
 
 # カスタムエバリュエータの作成
@@ -66,4 +67,4 @@ extensions.setEvaluators({
 `core.every` のような複合ルールの一部として使用したりできます。
 
 **Tip:** 実行時に再利用される独自のエントリを登録する方法の詳細については、
-[登録](/extending/registration) セクションを参照してください。
+[登録](/ja/extending/registration) セクションを参照してください。
diff --git a/docs/ja/extending/extensibility-features.md b/docs/ja/extending/extensibility-features.md
index 20f04cc4f..de76afff5 100644
--- a/docs/ja/extending/extensibility-features.md
+++ b/docs/ja/extending/extensibility-features.md
@@ -1,5 +1,6 @@
 ---
 Title: 拡張機能
+nav: ja
 ---
 
 # 拡張機能
diff --git a/docs/ja/extending/extension-format.md b/docs/ja/extending/extension-format.md
index 6a79754e6..5a8b26756 100644
--- a/docs/ja/extending/extension-format.md
+++ b/docs/ja/extending/extension-format.md
@@ -1,5 +1,6 @@
 ---
 Title: 拡張フォーマット
+nav: ja
 ---
 
 # 拡張フォーマット
@@ -201,7 +202,7 @@ JSON 構造およびネストのレベルに制限はありません。
 }
 ```
 
-詳細については、[コンテンツの無効化](/extending/extension-format#disabling-content) セクションをご覧ください。
+詳細については、[コンテンツの無効化](#コンテンツを無効にする) セクションをご覧ください。
 
 ### 配列のマージ
 
diff --git a/docs/ja/extending/icons.md b/docs/ja/extending/icons.md
index 1690ced8b..0bc67fe19 100644
--- a/docs/ja/extending/icons.md
+++ b/docs/ja/extending/icons.md
@@ -1,5 +1,6 @@
 ---
 Title: カスタムアイコン
+nav: ja
 ---
 
 # カスタムアイコン
diff --git a/docs/ja/extending/redistributable-libraries.md b/docs/ja/extending/redistributable-libraries.md
index e9c0b739d..56f4b3536 100644
--- a/docs/ja/extending/redistributable-libraries.md
+++ b/docs/ja/extending/redistributable-libraries.md
@@ -1,5 +1,6 @@
 ---
 Title: 再配布可能なライブラリ
+nav: ja
 ---
 
 # 再配布可能なライブラリ
diff --git a/docs/ja/extending/registration.md b/docs/ja/extending/registration.md
index 468362158..d55a485a3 100644
--- a/docs/ja/extending/registration.md
+++ b/docs/ja/extending/registration.md
@@ -1,5 +1,6 @@
 ---
 Title: 登録
+nav: ja
 ---
 
 # 登録
diff --git a/docs/ja/extending/routes.md b/docs/ja/extending/routes.md
index e0de05ad1..2235404f8 100644
--- a/docs/ja/extending/routes.md
+++ b/docs/ja/extending/routes.md
@@ -1,5 +1,6 @@
 ---
 Title: ルート
+nav: ja
 ---
 
 # ルート
@@ -29,9 +30,9 @@ Title: ルート
 | ------------- | -------------------------------------------------------------------------------------- |
 | **id**        | 一意の識別子。                                                                     |
 | **path**      | ルートの実行パス。                                                             |
-| **component** | ルートに使用するメインの[コンポーネント](/extending/components)。                                |
-| layout        | ルートに使用するレイアウト[コンポーネント](/extending/components)。                              |
-| auth          | [認証ガード](/extending/routes#authentication-guards)のリスト。デフォルトは `[ "app.auth" ]` です。 |
+| **component** | ルートに使用するメインの[コンポーネント](/ja/extending/components)。                                |
+| layout        | ルートに使用するレイアウト[コンポーネント](/ja/extending/components)。                              |
+| auth          | [認証ガード](#認証ガード)のリスト。デフォルトは `[ "app.auth" ]` です。 |
 | data          | ルートとともに移すカスタムプロパティバッグ。                                           |
 
 レイアウトプロパティの `app.layout.main` の値を使用して、
@@ -76,4 +77,4 @@ Title: ルート
 | app.auth | AuthGuardEcm | ADF ガードは、ACS の認証を検証し、必要に応じてログインにリダイレクトします。 |
 
 カスタムエクステンション内からこれらのガードを参照するか、
-カスタム実装を [登録](/extending/registration) できます。
+カスタム実装を [登録](/ja/extending/registration) できます。
diff --git a/docs/ja/extending/rules.md b/docs/ja/extending/rules.md
index eb8118c41..67f2e829f 100644
--- a/docs/ja/extending/rules.md
+++ b/docs/ja/extending/rules.md
@@ -1,5 +1,6 @@
 ---
 Title: ルール
+nav: ja
 ---
 
 # ルール
@@ -200,7 +201,7 @@ Title: ルール
 | 1.7.0   | app.navigation.isLibraryFiles     | 現在のページは**ライブラリファイル**です。                               |
 
 **Tip:** 実行時に再利用される独自のエントリを登録する方法の詳細については、
-[登録](/extending/registration) セクションを参照してください。
+[登録](/ja/extending/registration) セクションを参照してください。
 
 ### 例
 
diff --git a/docs/ja/extending/tutorials.md b/docs/ja/extending/tutorials.md
index 7719d7de2..970e87fdc 100644
--- a/docs/ja/extending/tutorials.md
+++ b/docs/ja/extending/tutorials.md
@@ -1,5 +1,6 @@
 ---
 Title: チュートリアル
+nav: ja
 ---
 
 # チュートリアル
diff --git a/docs/ja/features/README.md b/docs/ja/features/README.md
index f6cf83e15..1d9b11d9d 100644
--- a/docs/ja/features/README.md
+++ b/docs/ja/features/README.md
@@ -1,6 +1,7 @@
 ---
 Title: アプリの機能
 Github only: true
+nav: ja
 ---
 
 # アプリの機能
@@ -16,11 +17,11 @@ Github only: true
 
 ## コンテンツ
 
-- [ユーザーインターフェイスのレイアウト](/features/user-interface-layout)
-- [ヘッダー](/features/header)
-- [サイドナビゲーション](/features/side-navigation)
-- [ドキュメントリストのレイアウト](/features/document-list-layout)
-- [ファイルビューア](/features/file-viewer)
-- [情報ドロワー](/features/info-drawer)
-- [バージョンマネージャ](/features/version-manager)
-- [検索結果](/features/search-results)
+- [ユーザーインターフェイスのレイアウト](/ja/features/user-interface-layout)
+- [ヘッダー](/ja/features/header)
+- [サイドナビゲーション](/ja/features/side-navigation)
+- [ドキュメントリストのレイアウト](/ja/features/document-list-layout)
+- [ファイルビューア](/ja/features/file-viewer)
+- [情報ドロワー](/ja/features/info-drawer)
+- [バージョンマネージャ](/ja/features/version-manager)
+- [検索結果](/ja/features/search-results)
diff --git a/docs/ja/features/document-list-layout.md b/docs/ja/features/document-list-layout.md
index b7db4e261..27cd6bfa9 100644
--- a/docs/ja/features/document-list-layout.md
+++ b/docs/ja/features/document-list-layout.md
@@ -1,5 +1,6 @@
 ---
 Title: ドキュメントリストのレイアウト
+nav: ja
 ---
 
 # ドキュメントリストのレイアウト
diff --git a/docs/ja/features/file-viewer.md b/docs/ja/features/file-viewer.md
index 4cdffb4bb..f52a340ee 100644
--- a/docs/ja/features/file-viewer.md
+++ b/docs/ja/features/file-viewer.md
@@ -1,5 +1,6 @@
 ---
 Title: ファイルビューア
+nav: ja
 ---
 
 # ファイルビューア
diff --git a/docs/ja/features/header.md b/docs/ja/features/header.md
index 133694136..297cc4efe 100644
--- a/docs/ja/features/header.md
+++ b/docs/ja/features/header.md
@@ -1,14 +1,15 @@
 ---
 Title: Header
+nav: ja
 ---
 
 # ヘッダー
 
 アプリケーションの [ヘッダー](../../src/app/components/header) には3つの主要な要素があります。
 
-1. [ロゴと色](#logo-and-color)
-2. [検索](#search)
-3. [現在のユーザ](#current-user)
+1. [ロゴと色](#ロゴと色)
+2. [検索](#検索)
+3. [現在のユーザ](#現在のユーザ)
 
 ![Header](../images/header.png)
 
diff --git a/docs/ja/features/info-drawer.md b/docs/ja/features/info-drawer.md
index 347ed29f2..aa0479859 100644
--- a/docs/ja/features/info-drawer.md
+++ b/docs/ja/features/info-drawer.md
@@ -1,5 +1,6 @@
 ---
 Title: 情報ドロワー
+nav: ja
 ---
 
 # 情報ドロワー
diff --git a/docs/ja/features/search-results.md b/docs/ja/features/search-results.md
index ac0470bcb..afe0d061b 100644
--- a/docs/ja/features/search-results.md
+++ b/docs/ja/features/search-results.md
@@ -1,5 +1,6 @@
 ---
 Title: 検索結果
+nav: ja
 ---
 
 # 検索結果
diff --git a/docs/ja/features/side-navigation.md b/docs/ja/features/side-navigation.md
index 60c946e86..4e595072d 100644
--- a/docs/ja/features/side-navigation.md
+++ b/docs/ja/features/side-navigation.md
@@ -1,5 +1,6 @@
 ---
 Title: サイドナビゲーション
+nav: ja
 ---
 
 # サイドナビゲーション
diff --git a/docs/ja/features/user-interface-layout.md b/docs/ja/features/user-interface-layout.md
index 048b0d858..a3b938876 100644
--- a/docs/ja/features/user-interface-layout.md
+++ b/docs/ja/features/user-interface-layout.md
@@ -1,13 +1,14 @@
 ---
 Title: ユーザーインターフェイス - レイアウト
+nav: ja
 ---
 
 # ユーザーインターフェイス - レイアウト
 
 [Layout component](../../src/app/components/layout) によって制御されるアプリケーションの3つの主要な領域があります:
 
-1. [アプリケーションヘッダー](/features/header)
-2. [サイドナビゲーション](/features/side-navigation)
-3. [ドキュメントリスト](/features/document-list-layout)
+1. [アプリケーションヘッダー](/ja/features/header)
+2. [サイドナビゲーション](/ja/features/side-navigation)
+3. [ドキュメントリスト](/ja/features/document-list-layout)
 
 ![機能](../images/features-01.png)
diff --git a/docs/ja/features/version-manager.md b/docs/ja/features/version-manager.md
index b6fd78d85..948920c1f 100644
--- a/docs/ja/features/version-manager.md
+++ b/docs/ja/features/version-manager.md
@@ -1,5 +1,6 @@
 ---
 Title: バージョンマネージャ
+nav: ja
 ---
 
 # バージョンマネージャ
diff --git a/docs/ja/getting-started/README.md b/docs/ja/getting-started/README.md
index 5c2441117..b7d9dfcda 100644
--- a/docs/ja/getting-started/README.md
+++ b/docs/ja/getting-started/README.md
@@ -1,6 +1,7 @@
 ---
 Title: 入門
 Github only: true
+nav: ja
 ---
 
 # 入門
@@ -9,11 +10,11 @@ Alfresco Content Application で開発を開始する方法を学びます。
 
 ## コンテンツ
 
-- [前提条件](/getting-started/prerequisites)
-- [ソースからビルド](/getting-started/building-from-source)
-- [国際化 (i18n)](/getting-started/internationalization)
-- [CORS](/getting-started/cors)
-- [シングルサインオン](/getting-started/sso)
-- [設定](/getting-started/configuration)
-- [ナビゲーション](/getting-started/navigation)
-- [Docker](/getting-started/docker)
+- [前提条件](/ja/getting-started/prerequisites)
+- [ソースからビルド](/ja/getting-started/building-from-source)
+- [国際化 (i18n)](/ja/getting-started/internationalization)
+- [CORS](/ja/getting-started/cors)
+- [シングルサインオン](/ja/getting-started/sso)
+- [設定](/ja/getting-started/configuration)
+- [ナビゲーション](/ja/getting-started/navigation)
+- [Docker](/ja/getting-started/docker)
diff --git a/docs/ja/getting-started/building-from-source.md b/docs/ja/getting-started/building-from-source.md
index 55dd0bbbe..5ee6da586 100644
--- a/docs/ja/getting-started/building-from-source.md
+++ b/docs/ja/getting-started/building-from-source.md
@@ -1,5 +1,6 @@
 ---
 Title: ソースからビルド
+nav: ja
 ---
 
 # ソースからビルド
diff --git a/docs/ja/getting-started/configuration.md b/docs/ja/getting-started/configuration.md
index 96511c00c..548431557 100644
--- a/docs/ja/getting-started/configuration.md
+++ b/docs/ja/getting-started/configuration.md
@@ -1,5 +1,6 @@
 ---
 Title: 設定
+nav: ja
 ---
 
 # 設定
diff --git a/docs/ja/getting-started/cors.md b/docs/ja/getting-started/cors.md
index 5337d51da..f253de08d 100644
--- a/docs/ja/getting-started/cors.md
+++ b/docs/ja/getting-started/cors.md
@@ -1,5 +1,6 @@
 ---
 Title: CORS
+nav: ja
 ---
 
 # CORS
diff --git a/docs/ja/getting-started/docker.md b/docs/ja/getting-started/docker.md
index f64f0f958..4b6468e7f 100644
--- a/docs/ja/getting-started/docker.md
+++ b/docs/ja/getting-started/docker.md
@@ -1,5 +1,6 @@
 ---
 Title: Docker
+nav: ja
 ---
 
 # Docker
diff --git a/docs/ja/getting-started/internationalization.md b/docs/ja/getting-started/internationalization.md
index df646b7d1..18dd9226b 100644
--- a/docs/ja/getting-started/internationalization.md
+++ b/docs/ja/getting-started/internationalization.md
@@ -1,5 +1,6 @@
 ---
 Title: 国際化
+nav: ja
 ---
 
 # 国際化 (i18n)
diff --git a/docs/ja/getting-started/navigation.md b/docs/ja/getting-started/navigation.md
index 15b76631f..eb99fff89 100644
--- a/docs/ja/getting-started/navigation.md
+++ b/docs/ja/getting-started/navigation.md
@@ -1,5 +1,6 @@
 ---
 Title: ナビゲーション
+nav: ja
 ---
 
 # ナビゲーション
@@ -76,7 +77,7 @@ Title: ナビゲーション
 }
 ```
 
-国際化の詳細については、[国際化 (i18n)](/getting-started/internationalization) セクションを参照してください。
+国際化の詳細については、[国際化 (i18n)](/ja/getting-started/internationalization) セクションを参照してください。
 
 ## ユーザー定義のナビゲーション
 
@@ -210,4 +211,4 @@ export class CustomPage {
 
 コンポーネントは app モジュールの下で entryComponents として宣言する必要があることに注意してください。
 
-カスタムページのコンテンツの詳細については、[ドキュメントリストのレイアウト](/features/document-list-layout) セクションを参照してください。
+カスタムページのコンテンツの詳細については、[ドキュメントリストのレイアウト](/ja/features/document-list-layout) セクションを参照してください。
diff --git a/docs/ja/getting-started/prerequisites.md b/docs/ja/getting-started/prerequisites.md
index 5f101a95b..7caba3cc0 100644
--- a/docs/ja/getting-started/prerequisites.md
+++ b/docs/ja/getting-started/prerequisites.md
@@ -1,5 +1,6 @@
 ---
 Title: 前提条件
+nav: ja
 ---
 
 # 前提条件
diff --git a/docs/ja/getting-started/sso.md b/docs/ja/getting-started/sso.md
index 9f4ace3c7..50afc0aa5 100644
--- a/docs/ja/getting-started/sso.md
+++ b/docs/ja/getting-started/sso.md
@@ -1,5 +1,6 @@
 ---
 Title: シングルサインオン
+nav: ja
 ---
 
 # シングルサインオン
diff --git a/docs/ja/help.md b/docs/ja/help.md
index cff833b7d..a1cf2e72e 100644
--- a/docs/ja/help.md
+++ b/docs/ja/help.md
@@ -1,5 +1,6 @@
 ---
 Title: 助けを求める
+nav: ja
 ---
 
 # 助けを得る場所
diff --git a/docs/ja/toc.md b/docs/ja/toc.md
index eeeceddff..af2533ae8 100644
--- a/docs/ja/toc.md
+++ b/docs/ja/toc.md
@@ -1,39 +1,39 @@
-- [ホーム](/)
-  - [ドキュメント](/#documentation)
-  - [貢献する方法](/#how-to-contribute)
-- [アプリの機能](/features/)
-  - [ユーザーインターフェイスのレイアウト](/features/user-interface-layout)
-  - [ヘッダー](/features/header)
-  - [サイドナビゲーション](/features/side-navigation)
-  - [ドキュメントリストのレイアウト](/features/document-list-layout)
-  - [ファイルビューア](/features/file-viewer)
-  - [情報ドロワー](/features/info-drawer)
-  - [バージョンマネージャ](/features/version-manager)
-  - [検索結果](/features/search-results)
-- [入門](/getting-started/)
-  - [前提条件](/getting-started/prerequisites)
-  - [ソースからビルド](/getting-started/building-from-source)
-  - [国際化 (i18n)](/getting-started/internationalization)
-  - [CORS](/getting-started/cors)
-  - [設定](/getting-started/configuration)
-  - [ナビゲーション](/getting-started/navigation)
-  - [Docker](/getting-started/docker)
-- [拡張](/extending/)
-  - [拡張機能](/extending/extensibility-features)
-  - [拡張フォーマット](/extending/extension-format)
-  - [ルート](/extending/routes)
-  - [コンポーネント](/extending/components)
-  - [アクション](/extending/actions)
-  - [アプリケーションアクション](/extending/application-actions)
-  - [ルール](/extending/rules)
-  - [アプリケーション機能](/extending/application-features)
-  - [カスタムアイコン](/extending/icons)
-  - [レジストレーション](/extending/registration)
-  - [カスタムエバリュエーターの作成](/extending/creating-custom-evaluators)
-  - [チュートリアル](/extending/tutorials)
-  - [再配布可能なライブラリ](/extending/redistributable-libraries)
-- [チュートリアル](/tutorials/)
-  - [ACAの拡張の概要](/tutorials/introduction-to-extending)
-  - [パラメータ付きのカスタムルート](/tutorials/custom-route-with-parameters)
-  - [ダイアログアクション](/tutorials/dialog-actions)
-- [助けを求める](/help)
+- [ホーム](/ja/)
+  - [ドキュメント](/ja/READMe#ドキュメント)
+  - [貢献する方法](/ja/README#貢献する方法)
+- [アプリの機能](/ja/features/)
+  - [ユーザーインターフェイスのレイアウト](/ja/features/user-interface-layout)
+  - [ヘッダー](/ja/features/header)
+  - [サイドナビゲーション](/ja/features/side-navigation)
+  - [ドキュメントリストのレイアウト](/ja/features/document-list-layout)
+  - [ファイルビューア](/ja/features/file-viewer)
+  - [情報ドロワー](/ja/features/info-drawer)
+  - [バージョンマネージャ](/ja/features/version-manager)
+  - [検索結果](/ja/features/search-results)
+- [入門](/ja/getting-started/)
+  - [前提条件](/ja/getting-started/prerequisites)
+  - [ソースからビルド](/ja/getting-started/building-from-source)
+  - [国際化 (i18n)](/ja/getting-started/internationalization)
+  - [CORS](/ja/getting-started/cors)
+  - [設定](/ja/getting-started/configuration)
+  - [ナビゲーション](/ja/getting-started/navigation)
+  - [Docker](/ja/getting-started/docker)
+- [拡張](/ja/extending/)
+  - [拡張機能](/ja/extending/extensibility-features)
+  - [拡張フォーマット](/ja/extending/extension-format)
+  - [ルート](/ja/extending/routes)
+  - [コンポーネント](/ja/extending/components)
+  - [アクション](/ja/extending/actions)
+  - [アプリケーションアクション](/ja/extending/application-actions)
+  - [ルール](/ja/extending/rules)
+  - [アプリケーション機能](/ja/extending/application-features)
+  - [カスタムアイコン](/ja/extending/icons)
+  - [レジストレーション](/ja/extending/registration)
+  - [カスタムエバリュエーターの作成](/ja/extending/creating-custom-evaluators)
+  - [チュートリアル](/ja/extending/tutorials)
+  - [再配布可能なライブラリ](/ja/extending/redistributable-libraries)
+- [チュートリアル](/ja/tutorials/)
+  - [ACAの拡張の概要](/ja/tutorials/introduction-to-extending)
+  - [パラメータ付きのカスタムルート](/ja/tutorials/custom-route-with-parameters)
+  - [ダイアログアクション](/ja/tutorials/dialog-actions)
+- [助けを求める](/ja/help)
diff --git a/docs/ja/tutorials/README.md b/docs/ja/tutorials/README.md
index 883fc013c..cc9fca647 100644
--- a/docs/ja/tutorials/README.md
+++ b/docs/ja/tutorials/README.md
@@ -1,6 +1,7 @@
 ---
 Title: チュートリアル
 Github only: true
+nav: ja
 ---
 
 # チュートリアル
@@ -9,6 +10,6 @@ Alfresco Content Application を使用した開発の詳細を学習しましょ
 
 ## コンテンツ
 
-- [ACA の拡張の概要](/tutorials/introduction-to-extending)
-- [パラメータ付きのカスタムルート](/tutorials/custom-route-with-parameters)
-- [ダイアログアクション](/tutorials/dialog-actions)
\ No newline at end of file
+- [ACA の拡張の概要](/ja/tutorials/introduction-to-extending)
+- [パラメータ付きのカスタムルート](/ja/tutorials/custom-route-with-parameters)
+- [ダイアログアクション](/ja/tutorials/dialog-actions)
diff --git a/docs/ja/tutorials/custom-route-with-parameters.md b/docs/ja/tutorials/custom-route-with-parameters.md
index 60ef8375f..48e56f6e7 100644
--- a/docs/ja/tutorials/custom-route-with-parameters.md
+++ b/docs/ja/tutorials/custom-route-with-parameters.md
@@ -1,5 +1,6 @@
 ---
 Title: パラメータ付きのカスタムルート
+nav: ja
 ---
 
 # パラメータ付きのカスタムルート
diff --git a/docs/ja/tutorials/dialog-actions.md b/docs/ja/tutorials/dialog-actions.md
index b8b79e079..461dd0f68 100644
--- a/docs/ja/tutorials/dialog-actions.md
+++ b/docs/ja/tutorials/dialog-actions.md
@@ -1,5 +1,6 @@
 ---
 Title: ダイアログアクション
+nav: ja
 ---
 
 # ダイアログアクション
diff --git a/docs/ja/tutorials/introduction-to-extending.md b/docs/ja/tutorials/introduction-to-extending.md
index 8b1f86316..51f496d66 100644
--- a/docs/ja/tutorials/introduction-to-extending.md
+++ b/docs/ja/tutorials/introduction-to-extending.md
@@ -1,5 +1,6 @@
 ---
 Title: ACA の拡張の概要
+nav: ja
 ---
 
 # Alfresco Content Application の拡張の概要
diff --git a/docs/toc.md b/docs/toc.md
index 653415e0b..0a7a963f1 100644
--- a/docs/toc.md
+++ b/docs/toc.md
@@ -1,6 +1,6 @@
 - [Home](/)
-  - [Documentation](/#documentation)
-  - [How to contribute](/#how-to-contribute)
+  - [Documentation](/READMe#documentation)
+  - [How to contribute](/README#how-to-contribute)
 - [App features](/features/)
   - [User interface layout](/features/user-interface-layout)
   - [Header](/features/header)