---
title: 设置存储库
slug: docs/cn/43fSo0veyYDdZQ1dWSGrl
description: 通过本分步指南，了解如何为 Archbee（一个文档协作平台）设置存储库。创建一个包含变量结构的 `.archbee.yaml` 文件，并查看 `.yaml` 和 `.json` 配置文件示例。探索其重要性
createdAt: 2023-01-18T13:04:58.000Z
---

## 设置仓库

假设您已经[完成了集成](https://docs.archbee.com/github#jJpEV), 下一步是设置仓库。

您需要成功设置并配置您的仓库，以便 Archbee 可以获取其中的内容并在我们这边进行良好的设置。

:::hint{type="info"}
您可以[fork 此仓库](https://github.com/dragosbulugean/slate)。
:::

如果系统在您的仓库根目录或其他文件夹（若您使用 multipath）中发现一个`.archbee.yaml` 文件，如此处示例所示 [.yaml 文件](https://github.com/dragosbulugean/slate/blob/master/.archbee.yaml)，那么我们将使用它来组织内容。

:::hint{type="warning"}
如果您希望配置渲染 markdown 内容的文件夹（或摘要文档树层级），请密切注意此处的
:::

:::CodeblockTabs
summary.md

```markdown
- [Introduction](1.md)

## Table of contents

- [Init](init.md)
- [Configure App](config.md)
- [Config Database](config-database.md)
- [Config Redis](config-redis.md)
- [Config Elastic Search](config-es.md)
- [Swagger](swagger-v2.json)

```
:::

## 使用 GitHub 的 Markdown 语法

如果您使用特定语法，则某些内容块可以被渲染。

查看 [编辑器 Markdown 快捷方式](docId:5QfvRE_WOro_y1WBKKYLp) 以使用这些快捷方式。

## 添加多个仓库

请按照以下简单步骤添加多个仓库并将它们与 Archbee 同步：

::::WorkflowBlock
:::WorkflowBlockItem
进入与 Archbee 连接的 [GitHub](https://github.com/settings/installations) 账户，然后导航至 **设置** 页面。

在左侧侧边栏中查找 **应用程序。**

![](https://api.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/HChEov2q-7IXyJVa81Mbj_github-appconfigure-light.png "GitHub 应用程序页面")
:::

:::WorkflowBlockItem
单击 **配置 **按钮，在新页面打开后，授予访问权限：

1. *所有存储库*（这意味着您可以从 Archbee 账户选择任何仓库）
2. *仅选择存储库*（选择您想与 Archbee 同步的任何新仓库）
3. 单击保存



![](https://api.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/zspijTRLT875JPad9Cecf_image.png "选择仓库")
:::

:::WorkflowBlockItem
返回您的 Archbee 账户。

在左侧导航面板中，创建一个新的 **空间** -> 选择 **在GitHub上写作** 并选择新添加的仓库。
:::
::::

## 导入 Open Api 文件

您实际上可以通过 GitHub 导入 Open Api 文件。此功能与 [导入 OpenAPI / Swagger](docId\:a-NbWp43yWULjY3FOEReP) 功能（包括其设置）完全相同。有两个重要的设置项目：

- 要写入 `summary.md` 配置文件中的 Open Api 文件路径 (.json, .yml, .yaml)
- 要写入主配置文件中 `docTreeOptions` 下的设置：

:::CodeblockTabs
.archbee.yaml

```yaml
docsPath: ./myapp-docs
structure:
  summary: toc.md
  assets: assets
  docTreeOptions:
    openApiTryIt: false
    showDownloadOpenApiFile: true
    shouldCreateSchemaCategory: true
    shouldCreateIntro: true
    openApiLanguageExamples:
      - value: python
        label: py
      - value: javascript
        label: js
footerTemplate: ""
headerIncludes: ""

```
:::