File size: 2,641 Bytes
eb846d0
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
---
title: '设置'
description: '了解如何配置您的文档'
---

## 全局配置

所有的全局配置都在项目根目录的 `docs.json` 文件中设置。

### 名称

在配置的顶层设置文档的名称。

```json docs.json
{
  "name": "Mintlify 文档"
}
```

### Logo

您可以显示浅色和深色模式的 logo。

```json docs.json
{
  "logo": {
    "light": "/logo/light.svg",
    "dark": "/logo/dark.svg"
  }
}
```

### Favicon

```json docs.json
{
  "favicon": "/favicon.ico"
}
```

### 颜色

自定义文档的主色调以匹配您的品牌。

```json docs.json
{
  "colors": {
    "primary": "#9563FF",
    "light": "#AE87FF",
    "dark": "#9563FF"
  }
}
```

<Tip>设置一种颜色系统,通过仅更改主色调来协调您文档的配色方案。</Tip>

### 导航

您的侧边栏导航在 `navigation` 字段中设置。文档页面必须嵌套在组下,组必须嵌套在导航下。

```json docs.json
{
  "navigation": [
    {
      "group": "开始使用",
      "pages": ["introduction", "quickstart", "development"]
    }
  ]
}
```

#### 标签

您可以将页面分组为不同的标签。当您想要将概念或 API 参考组织到不同的部分时,这很有用。

```json docs.json
{
  "navigation": {
    "tabs": [
      {
        "tab": "主要",
        "groups": [
          {
            "group": "开始使用",
            "pages": ["introduction"]
          }
        ]
      },
      {
        "tab": "API 参考",
        "groups": [
          {
            "group": "端点",
            "pages": ["api-reference/users"]
          }
        ]
      }
    ]
  }
}
```

### 页脚

您可以在 `footer` 字段中配置页脚链接。

```json docs.json
{
  "footer": {
    "socials": {
      "website": "https://mintlify.com",
      "github": "https://github.com/mintlify",
      "slack": "https://mintlify.com/community"
    }
  }
}
```

### 搜索

您可以通过多种方式配置搜索,包括替换默认搜索或添加搜索锚点。

```json docs.json
{
  "search": {
    "prompt": "搜索..."
  }
}
```

## 页面配置

页面配置在每个 MDX 文件顶部的 frontmatter 中设置。

### 标题和描述

```md
---
title: '介绍'
description: '欢迎来到我们的产品!'
---
```

### 侧边栏标题

```md
---
sidebarTitle: '主页'
---
```

设置不同于页面标题的侧边栏标题。

### 图标

```md
---
icon: 'star'
---
```

为侧边栏中的页面设置 [FontAwesome](https://fontawesome.com/search?s=solid&m=free) 图标。

### 模式

```md
---
mode: 'wide'
---
```

设置页面的显示模式。选项包括 `"default"`  `"wide"`。