> ## Documentation Index
> Fetch the complete documentation index at: https://mydoc.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 自定义您的站点

> 了解 docs.json 控制什么以及如何自定义您的站点样式

This starter uses a custom Astro frontend with Mintlify's content tools and components. Because the frontend is yours, not every `docs.json` configuration option from the [full Mintlify reference](https://mintlify.com/docs/organize/settings) applies.

**`docs.json` 控制什么：** 导航结构、页面元数据和内容配置。

**您控制什么：** 样式、布局和站点的渲染方式。这些都在您的 Astro 项目的 `src/` 目录下。

<Note>
  如果某个 `docs.json` 选项似乎没有任何效果，可能是因为它尚未连接到 Astro 前端。请查看 `src/` 中的模板，了解配置值是如何被使用的，并在那里进行调整。
</Note>

## 导航

在 `docs.json` 中构建您的文档导航。

```json docs/docs.json theme={null}
{
  "navigation": {
    "tabs": [
      {
        "tab": "Docs",
        "groups": [
          {
            "group": "Getting started",
            "pages": [
              "index",
              "quickstart"
            ]
          }
        ]
      }
    ]
  }
}
```

页面路径是相对于 `docs/` 目录的，不带 `.mdx` 扩展名。对于嵌套页面使用正斜杠。例如，`guides/example`。

## 站点元数据

在 `docs.json` 中设置站点名称和其他元数据。

```json docs/docs.json theme={null}
{
  "name": "My Docs",
  "favicon": "/favicon.svg",
  "logo": {
    "light": "/logo/light.svg",
    "dark": "/logo/dark.svg"
  }
}
```

这些值是否生效取决于 `src/` 中的 Astro 模板如何引用它们。

## 样式和布局

由于这是一个自定义的 Astro 项目，您可以直接控制站点的外观：

| 路径                | 控制内容                  |
| ----------------- | --------------------- |
| `src/layouts/`    | 页面布局模板。               |
| `src/styles/`     | 全局 CSS 和 Tailwind 配置。 |
| `src/components/` | 自定义 Astro 和 React 组件。 |

要更改颜色、字体、间距或其他视觉属性，请直接编辑 `src/` 中的文件，而不是依赖 `docs.json` 中的 `colors` 或 `navbar` 等值。

<Tip>
  当开发服务器运行时，对 `src/` 中文件的更改会立即生效。
</Tip>