Skip to main content
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 applies. docs.json 控制什么： 导航结构、页面元数据和内容配置。 您控制什么： 样式、布局和站点的渲染方式。这些都在您的 Astro 项目的 src/ 目录下。
如果某个 docs.json 选项似乎没有任何效果，可能是因为它尚未连接到 Astro 前端。请查看 src/ 中的模板，了解配置值是如何被使用的，并在那里进行调整。

​
导航

在 docs.json 中构建您的文档导航。
docs/docs.json
{
  "navigation": {
    "tabs": [
      {
        "tab": "Docs",
        "groups": [
          {
            "group": "Getting started",
            "pages": [
              "index",
              "quickstart"
            ]
          }
        ]
      }
    ]
  }
}
页面路径是相对于 docs/ 目录的，不带 .mdx 扩展名。对于嵌套页面使用正斜杠。例如，guides/example。

​
站点元数据

在 docs.json 中设置站点名称和其他元数据。
docs/docs.json
{
  "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 等值。
当开发服务器运行时，对 src/ 中文件的更改会立即生效。