# 内容配置

如果你想进一步配置 Git Sync，可以添加一个 `.gitbook.yaml` 文件到仓库根目录，以告知 GitBook 如何解析你的 Git 仓库。

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

```yaml
root: ./

​结构：
  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 %}

### ​结构‌ <a href="#structure" id="structure"></a>

该结构接受两个属性：‌

* **`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 的界面创建或修改 readme 文件** 。readme 文件应仅在你的 GitHub/GitLab 仓库中管理，以避免冲突和重复问题。
{% endhint %}

### 摘要‌ <a href="#summary" id="summary"></a>

该 `summary` 文件是一个 Markdown 文件（`.md`），应具有以下结构：

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

```markdown
‌# 摘要​

## 使用标题创建像这样的页面组​

* [第一页的标题](page1/README.md)
    * [某个子页面](page1/page1-1.md)
    * [其他子页面](part1/page1-2.md)

* [第二页的标题](page2/README.md)
    * [某个子页面](page2/page2-1.md)
    * [其他子页面](part2/page2-2.md)

## 第二页组​

* [另一页](another-page.md)
```

{% endcode %}

提供自定义摘要文件是可选的。默认情况下，如果你的配置文件中指定了，GitBook 会在你的 `SUMMARY.md` 中查找名为 `root` 的文件；否则会在仓库根目录查找。

如果你没有指定摘要，而且 GitBook 没有在你的文档根目录找到一个 `SUMMARY.md` 文件，GitBook 将根据文件夹结构和下面的 Markdown 文件推断目录。‌

{% hint style="info" %}
摘要 markdown 文件是 **的镜像，反映了** **目录** ，即你的 GitBook 空间的目录。因此，即使在初次导入时未提供摘要文件，GitBook 也会创建一个，并且/或者在你使用 GitBook 编辑器更新内容时更新它。

正因为如此，在你的 `SUMMARY.md` 文件中不可能两次引用同一个 Markdown 文件，因为这意味着同一个页面在你的 GitBook 空间中会有两个不同的 URL。
{% endhint %}

#### 目录（侧边栏）标题 <a href="#sidebar-titles" id="sidebar-titles"></a>

如果你希望页面在目录侧边栏中的标题与页面本身不同，你可以定义一个可选的 **页面链接标题** 中查找名为 `SUMMARY.md` 文件的子目录。

如果你使用 Git Sync，页面链接标题是在页面链接上设置的：

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

```markdown
# Summary

* [页面主标题](page.md "页面链接标题")
```

{% endcode %}

引号内的文本（`"页面链接标题"`）将被用于：

* 在目录（侧边栏）中
* 在每个页面底部的分页按钮中
* 在你添加到该页面的任何相对链接中

页面链接标题是可选的——如果你不手动添加，GitBook 默认会在所有地方使用该页面的标准标题。