# コンテンツの設定

Git Syncをさらに設定したい場合は、リポジトリのルートに `.gitbook.yaml` ファイルを追加して、GitBookにGitリポジトリの解析方法を伝えることができます。

{% code title=".gitbook.yaml" %}

```yaml
root: ./

​structure:
  readme: README.md
  summary: SUMMARY.md​

redirects:
  previous/page: new-folder/page.md
```

{% endcode %}

### ルート

ドキュメントを探索するパスはデフォルトでリポジトリのルートディレクトリになっています。GitBookに `./docs` フォルダを参照させる方法は次のとおりです：

{% code title=".gitbook.yaml" %}

```yaml
root: ./docs/
```

{% endcode %}

{% hint style="warning" %}
**パスを指定するその他のすべてのオプションはこのルートフォルダを基準とします**。したがって、もしrootを `./docs/` と定義し、次に `structure.summary` を `./product/SUMMARY.md`と定義すると、GitBookは実際に `./docs/product/SUMMARY.md`のファイルを探します。
{% endhint %}

### ​構成（Structure）‌ <a href="#structure" id="structure"></a>

structureは2つのプロパティを受け入れます：‌

* **`readme`**： ドキュメントの最初のページ。デフォルト値は `./README.md`
* **`summary`**： ドキュメントの目次。デフォルト値は `./SUMMARY.md`

これらのプロパティの値は対応するファイルへのパスです。パスは「root」オプションを基準とします。たとえば、最初のページとサマリーのためにGitBookに `./product` フォルダを参照させる方法は次のとおりです：

{% code title=".gitbook.yaml" %}

```yaml
structure:
  readme: ./product/README.md
  summary: ./product/SUMMARY.md
```

{% endcode %}

{% hint style="warning" %}
Git Syncが有効な場合、 **GitBookのUIを通じてreadmeファイルを作成または変更しないでください** 。readmeファイルは競合や重複の問題を避けるために、GitHub/GitLabリポジトリでのみ管理されるべきです。
{% endhint %}

### サマリー（Summary）‌ <a href="#summary" id="summary"></a>

この `summary` ファイルはMarkdownファイル（`.md`）で、次の構造であるべきです：

{% code title="./SUMMARY.md" %}

```markdown
‌# Summary​

## 見出しを使ってこのようなページグループを作成します​

* [First page’s title](page1/README.md)
    * [Some child page](page1/page1-1.md)
    * [Some other child page](part1/page1-2.md)

* [Second page’s title](page2/README.md)
    * [Some child page](page2/page2-1.md)
    * [Some other child page](part2/page2-2.md)

## 二つ目のページグループ​

* [Another page](another-page.md)
```

{% endcode %}

カスタムのsummaryファイルを提供することは任意です。デフォルトでは、GitBookは `SUMMARY.md` という名前のファイルを探します `root` フォルダに（設定ファイルで指定されている場合）、あるいはそうでなければリポジトリのルートで。

summaryを指定しない場合、そしてGitBookがドキュメントのルートで `SUMMARY.md` ファイルを見つけられない場合、GitBookはフォルダ構造とその下のMarkdownファイルから目次を推測します。‌

{% hint style="info" %}
summaryのMarkdownファイルは **のミラーであり、** **の目次** です。したがって、初回インポート時にsummaryファイルが提供されていなくても、GitBookは作成および/またはGitBookエディタでコンテンツを更新するたびにそれを更新します。

このため、同じMarkdownファイルを `SUMMARY.md` ファイルで2回参照することはできません。これは単一のページがGitBook上で異なる2つのURLに存在することを意味してしまうためです。
{% endhint %}

#### 目次（サイドバー）タイトル <a href="#sidebar-titles" id="sidebar-titles"></a>

ページのタイトルをページ本体とは異なるものにしたい場合は、オプションの **ページリンクのタイトル** という名前のファイルを探します `SUMMARY.md` CODE\_OF\_CONDUCT.md

を定義できます。

{% code title="./SUMMARY.md" %}

```markdown
Git Syncを使用している場合、ページリンクのタイトルはページリンク上で設定されます：

# Summary
```

{% endcode %}

\* \[Page main title]\(page.md "Page link title")`引用符内のテキスト（`"Page link title"

* ）は次で使用されます：
* 目次（サイドバー）で
* 各ページ下部のページネーションボタンで

そのページに追加した相対リンクのどこでも

### ページリンクのタイトルは任意です — 手動で追加しない場合、GitBookはデフォルトですべての場所でページの通常のタイトルを使用します。 <a href="#redirects" id="redirects"></a>

​リダイレクト（Redirects） `.gitbook.yaml` リダイレクトを使うと、 `設定ファイルでリダイレクトを定義できます。パスは「root」オプションを基準とします。たとえば、過去のURLにアクセスするユーザーを` /help `から新しいURLの`

{% code title=".gitbook.yaml" %}

```yaml
root: ./

redirects:
  /support
```

{% endcode %}

{% hint style="info" %}
へリダイレクトするようGitBookに指示する例は次のとおりです： [サイトリダイレクト](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/publishing-documentation/site-redirects) help: support.md
{% endhint %}

{% hint style="warning" %}
スペースの設定ファイルで定義したリダイレクトは対応するスペースに限定されます。サイト全体、スペースをまたいで適用されるため、ほとんどの場合は、より広域に適用されるものを作成することを推奨します（例えば、サーバー側の設定など）。（注：原文が一部省略されているため用途に合わせて補ってあります）
{% endhint %}
