-
-
-
- 色相:{hue}°
- setHue(Number.parseInt(e.target.value))}
- className="w-full h-2 bg-zinc-950/20 rounded-lg appearance-none cursor-pointer dark:bg-white/20 mt-1"
- style={{
- background: `linear-gradient(to right,
- hsl(0, ${saturation}%, ${lightness}%),
- hsl(60, ${saturation}%, ${lightness}%),
- hsl(120, ${saturation}%, ${lightness}%),
- hsl(180, ${saturation}%, ${lightness}%),
- hsl(240, ${saturation}%, ${lightness}%),
- hsl(300, ${saturation}%, ${lightness}%),
- hsl(360, ${saturation}%, ${lightness}%))`,
- }}
- />
-
-
-
- 饱和度:{saturation}%
- setSaturation(Number.parseInt(e.target.value))}
- className="w-full h-2 bg-zinc-950/20 rounded-lg appearance-none cursor-pointer dark:bg-white/20 mt-1"
- style={{
- background: `linear-gradient(to right,
- hsl(${hue}, 0%, ${lightness}%),
- hsl(${hue}, 50%, ${lightness}%),
- hsl(${hue}, 100%, ${lightness}%))`,
- }}
- />
-
-
-
- 明度:{lightness}%
- setLightness(Number.parseInt(e.target.value))}
- className="w-full h-2 bg-zinc-950/20 rounded-lg appearance-none cursor-pointer dark:bg-white/20 mt-1"
- style={{
- background: `linear-gradient(to right,
- hsl(${hue}, ${saturation}%, 0%),
- hsl(${hue}, ${saturation}%, 50%),
- hsl(${hue}, ${saturation}%, 100%))`,
- }}
- />
-
-
-
-
- {colors.map((color, idx) => (
-
copyToClipboard(color)}
- />
- ))}
-
-
-
-
- 基础颜色:hsl({hue}, {saturation}%, {lightness}%)
-
-
-
-
- )
-}
-```
-
-导入 `ColorGenerator` 组件,并在 `MDX` 文件中使用它:
-
-```mdx
-import { ColorGenerator } from "/snippets/color-generator.jsx"
-
-
-```
-
-颜色生成器会以交互式 React 组件的形式呈现。
-
-
-
-
- ## 注意事项
-
-
-
-
- React Hook 组件在客户端渲染,这带来以下影响:
-
- * **SEO(搜索引擎优化)**:搜索引擎可能无法完整索引动态内容。
- * **初始加载**:在组件渲染前,访客可能会看到内容加载的闪烁。
- * **无障碍**:确保动态内容的变化能够被屏幕阅读器正确播报。
-
-
-
- * **优化依赖数组**:在 `useEffect` 的依赖数组中仅包含必要的依赖。
- * **记忆化复杂计算**:对开销较大的操作使用 `useMemo` 或 `useCallback`。
- * **减少重复渲染**:将大型组件拆分为更小的组件以避免级联式重复渲染。
- * **懒加载**:考虑对复杂组件进行懒加载,以改善页面的初始加载时间。
-
-
diff --git a/zh/reusable-snippets.mdx b/zh/reusable-snippets.mdx
deleted file mode 100644
index 933e7945e..000000000
--- a/zh/reusable-snippets.mdx
+++ /dev/null
@@ -1,129 +0,0 @@
----
-title: '可复用片段'
-description: '复用自定义片段,保持内容一致'
-icon: 'recycle'
----
-
-软件开发的核心原则之一是 DRY(Don't Repeat Yourself,不要重复),这同样适用于文档。如果你发现在多个位置重复相同的内容,应该创建自定义片段以保持内容一致。
-
-
- ## 创建自定义片段
-
-
-**前置条件**:必须在 `snippets` 目录中创建片段文件,导入才能生效。
-
-`snippets` 目录中的任何页面都会被视为片段,不会被渲染为独立页面。若要基于该片段创建独立页面,请将其导入到另一个文件中,并以组件形式调用。
-
-
- ### 默认导出
-
-
-1. 将你希望复用的内容添加到片段文件中。你也可以添加变量,在导入片段时通过 props 进行填充。在此示例中,我们的变量是 word。
-
-```typescript snippets/my-snippet.mdx
-你好世界!这是我想要在各个页面中重复使用的内容。
-```
-
-2. 将该代码片段导入到目标文件中。
-
-```typescript destination-file.mdx
----
-title: 我的标题
-description: 我的说明
----
-
-import MySnippet from '/snippets/path/to/my-snippet.mdx';
-
-## 标题
-
-Lorem ipsum dolor sit amet.
-
-
-
-```
-
-
- ### 使用变量导出
-
-
-1. 你也可以选择添加一些变量,在导入该片段时通过 props 传入并填充。在本示例中,我们的变量是 word。
-
-```typescript snippets/my-snippet.mdx
-我今天的关键词是 {word}。
-```
-
-2. 在目标文件中使用该变量导入代码片段。该属性会根据你的设定自动填充。
-
-```typescript destination-file.mdx
----
-title: 我的标题
-description: 我的说明
----
-
-import MySnippet from '/snippets/path/to/my-snippet.mdx';
-
-## 标题
-
-Lorem ipsum dolor sit amet.
-
-
-
-```
-
-
- ### 可重用变量
-
-
-1. 从你的代码片段(snippet)文件中导出一个变量:
-
-```typescript snippets/path/to/custom-variables.mdx
-export const myName = '我的名字';
-
-export const myObject = { fruit: '草莓' };
-```
-
-2. 从目标文件导入该代码片段,并使用该变量:
-
-```typescript destination-file.mdx
----
-title: 我的标题
-description: 我的说明
----
-
-import { myName, myObject } from '/snippets/path/to/custom-variables.mdx';
-
-你好,我的名字是 {myName},我喜欢 {myObject.fruit}。
-```
-
-
- ### JSX 片段
-
-
-1. 从片段文件中导出一个 JSX 组件。(参见[React 组件](/zh/react-components)了解更多信息):
-
-```js icon=square-js snippets/my-jsx-snippet.jsx
-export const MyJSXSnippet = () => {
- return (
-
-
你好,世界!
-
- )
-}
-```
-
-
- 重要:创建 JSX 代码片段时,请使用箭头函数语法(`=>`),不要使用函数声明。在此 context 中不支持 `function` 关键字。
-
-
-2. 从目标文件中导入该片段,并使用该组件:
-
-```typescript destination-file.mdx
----
-title: 我的标题
-description: 我的说明
----
-
-import { MyJSXSnippet } from '/snippets/my-jsx-snippet.jsx';
-
-
-```
diff --git a/zh/settings.mdx b/zh/settings.mdx
deleted file mode 100644
index 303bab6ed..000000000
--- a/zh/settings.mdx
+++ /dev/null
@@ -1,1620 +0,0 @@
----
-title: "全局设置"
-description: "使用 `docs.json` 文件配置全站设置"
-icon: "settings-2"
-keywords: ["docs.json", "设置", "自定义", "配置"]
----
-
-import IconsOptional from "/snippets/zh/icons-optional.mdx";
-
-`docs.json` 文件可将一组 Markdown 文件构建成可导航、可自定义的文档站点。这个必需的配置文件控制样式、navigation、integrations 等设置,是你的文档的蓝图。
-
-`docs.json` 中的设置会全局作用于所有页面。
-
-
- ## 配置你的 `docs.json`
-
-
-开始时,你只需指定 `theme`、`name`、`colors.primary` 和 `navigation`。其他字段是可选的,可随着文档需求的增长逐步添加。
-
-为获得最佳编辑体验,请在 `docs.json` 文件开头加入模式(schema)引用。这样可在大多数代码编辑器中启用自动补全、校验和实用的悬浮提示:
-
-```json
-{
- "$schema": "https://mintlify.com/docs.json",
- "theme": "mint",
- "name": "您的文档",
- "colors": {
- "primary": "#ff0000"
- },
- "navigation": {
- // 您的导航结构
- }
- // 配置的其余部分
-}
-```
-
-
- ## 参考
-
-
-本节提供 `docs.json` 文件的完整参考资料。
-
-
- ### 自定义
-
-
-
- 站点的布局主题。
-
- 可选项:`mint`、`maple`、`palm`、`willow`、`linden`、`almond`、`aspen`。
-
- 详见 [Themes](zh/themes)。
-
-
-
- 您的项目、组织或产品名称。
-
-
-
- 文档中使用的配色。不同主题的应用方式不同。若仅提供主色,将用于所有相关颜色元素。
-
-
-
- 文档的主色。通常用于浅色模式中的强调效果,具体随主题有所差异。
-
- 必须为以 `#` 开头的十六进制色值。
-
-
-
- 深色模式下用于强调的颜色。
-
- 必须为以 `#` 开头的十六进制色值。
-
-
-
- 浅色与深色模式下按钮与悬停状态所用的颜色,具体随主题有所差异。
-
- 必须为以 `#` 开头的十六进制色值。
-
-
-
-
-
- 面向 SEO(搜索引擎优化)与 AI 索引编入的站点说明。
-
-
-
- 适用于浅色与深色模式的徽标。
-
-
-
- 指向浅色模式徽标文件的路径,需包含文件扩展名。示例:`/logo.png`
-
-
-
- 指向深色模式徽标文件的路径,需包含文件扩展名。示例:`/logo-dark.png`
-
-
-
- 点击徽标时跳转的 URL。如未提供,徽标将链接至您的首页。示例:`https://mintlify.com`
-
-
-
-
-
- 指向 favicon 文件的路径,需包含文件扩展名。将自动调整为合适的 favicon 尺寸。
- 可为单个文件,或分别为浅色/深色模式提供文件。示例:`/favicon.png`
-
-
-
- 指向浅色模式 favicon 文件的路径,需包含文件扩展名。示例:`/favicon.png`
-
-
-
- 指向深色模式 favicon 文件的路径,需包含文件扩展名。示例:`/favicon-dark.png`
-
-
-
-
-
- 社交媒体与页面预览的缩略图自定义。
-
-
-
- 缩略图的视觉主题。若未指定,将使用 `colors` 字段定义的站点配色方案。
-
-
-
- 缩略图背景图像。可为相对路径或绝对 URL。
-
-
-
-
-
- 视觉样式配置。
-
-
-
- 页面 eyebrow 的样式。选择 `section` 显示章节名称,或选择 `breadcrumbs` 显示完整导航路径。默认值为 `section`。
-
-
-
- 代码块主题配置。默认值为 `"system"`。
-
- **简单配置:**
-
- * `"system"`:跟随当前站点模式(浅色或深色)
- * `"dark"`:始终使用深色模式
-
- **自定义主题配置:**
-
- * 使用字符串为所有代码块指定一个 [Shiki 主题](https://shiki.style/themes)
- * 使用对象分别为浅色和深色模式指定 [Shiki 主题](https://shiki.style/themes)
-
-
- 一个同时用于浅色与深色模式的 Shiki 主题名称。
-
- ```json
- "styling": {
- "codeblocks": {
- "theme": "dracula"
- }
- }
- ```
-
-
-
- 分别为浅色和深色模式设置主题。
-
-
-
- 浅色模式的 Shiki 主题名称。
-
-
-
- 深色模式的 Shiki 主题名称。
-
-
- ```json
- "styling": {
- "codeblocks": {
- "theme": {
- "light": "github-light",
- "dark": "github-dark"
- }
- }
- }
- ```
-
-
-
-
-
-
-
- 图标库设置。
-
-
-
- 文档全站使用的图标库。默认值为 `fontawesome`。
-
-
- 无论库设置如何,您都可以为任意单个图标指定外部托管图标的 URL、项目中图标文件的路径,或兼容 JSX 的 SVG 代码。
-
-
-
-
-
-
- 文档站点的字体配置。默认字体为 [Inter](https://fonts.google.com/specimen/Inter)。
-
-
-
- 字体系列,例如“Open Sans”。
-
-
-
- 字重,例如 400 或 700。可变字体支持更精细的字重,例如 550。
-
-
-
- 字体源文件的 URL,例如 https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2。指定 Google 字体的 `family` 名称时会自动加载 [Google Fonts](https://fonts.google.com),因此无需提供 source 的 URL。
-
-
-
- 字体文件格式。
-
-
-
- 专用于标题的字体设置覆盖。
-
-
-
- 字体系列,例如“Open Sans”、“Playfair Display”。
-
-
-
- 字重,例如 400、700。可变字体支持更精细的字重,例如 550。
-
-
-
- 字体源文件的 URL,例如 https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2。指定 Google 字体的 `family` 名称时会自动加载 [Google Fonts](https://fonts.google.com),因此无需提供 source 的 URL。
-
-
-
- 字体文件格式。
-
-
-
-
-
- 专用于正文的字体设置覆盖。
-
-
-
- 字体系列,例如“Open Sans”、“Playfair Display”。
-
-
-
- 字重,例如 400、700。可变字体支持更精细的字重,例如 550。
-
-
-
- 字体源文件的 URL,例如 https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2。指定 Google 字体的 `family` 名称时会自动加载 [Google Fonts](https://fonts.google.com),因此无需提供 source 的 URL。
-
-
-
- 字体文件格式。
-
-
-
-
-
-
-
- 明/暗模式切换设置。
-
-
-
- 默认主题模式。选择 `system` 以匹配用户的操作系统设置,或选择 `light` 或 `dark` 以强制特定模式。默认值为 `system`。
-
-
-
- 是否隐藏明/暗模式切换。默认值为 `true`。
-
-
-
-
-
- 背景颜色与装饰的设置。
-
-
-
- 站点的背景图片。可为单个文件,或分别为浅色与深色模式提供不同文件。
-
-
-
- 浅色模式的背景图片路径。需包含文件扩展名。示例:`/background.png`。
-
-
-
- 深色模式的背景图片路径。需包含文件扩展名。示例:`/background-dark.png`。
-
-
-
-
-
- 主题的背景装饰效果。
-
-
-
- 为浅色与深色模式自定义背景颜色。
-
-
-
- 浅色模式的背景颜色。
-
- 必须是以 `#` 开头的十六进制色值。
-
-
-
- 深色模式的背景颜色。
-
- 必须是以 `#` 开头的十六进制色值。
-
-
-
-
-
-
-
- ### 结构
-
-
-
- 指向外部链接的导航栏条目。
-
-
-
- 要在导航栏中显示的链接
-
-
-
- 链接文本。
-
-
-
- 链接目标。必须是有效的外部 URL。
-
-
-
-
-
-
-
- 导航栏中的主按钮。
-
-
-
- 按钮样式。选择 `button` 表示带有文本的标准按钮;选择 `github` 表示指向 GitHub 存储库并带有 icon 的链接。
-
-
-
- 按钮文本。仅当 `type` 为 `button` 时生效。
-
-
-
- 按钮目标。必须是外部 URL。若 `type` 为 `github`,则必须是 GitHub 存储库的 URL。
-
-
-
-
-
-
-
- 您内容的导航结构。
-
-
-
- 在所有页面和章节中显示的全局导航元素。
-
-
-
- 本地化站点的语言切换配置。
-
-
-
- 符合 ISO 639-1 的语言代码
-
-
-
- 是否为默认语言。
-
-
-
- 是否默认隐藏此语言选项。
-
-
-
- 指向该语言文档版本的有效路径或外部链接。
-
-
-
-
-
- 用于多版本站点的版本切换器配置。
-
-
-
- 版本的显示名称。
-
- 最小长度:1
-
-
-
- 是否为默认版本。
-
-
-
- 是否默认隐藏该版本选项。
-
-
-
- 指向该文档版本的 URL 或路径。
-
-
-
-
-
- 用于组织主要版块的顶层导航选项卡。
-
-
-
- 标签页的显示名称。
-
- 最小长度:1
-
-
-
-
-
- 是否默认隐藏此标签页。
-
-
-
- 指向该标签页目标的 URL 或路径。
-
-
-
-
-
- 在侧边栏导航中醒目显示的锚点链接。
-
-
-
- 锚点的显示名称。
-
- 最小长度:1
-
-
-
-
-
- 锚点的自定义颜色。
-
-
-
- 浅色模式下的锚点颜色。
-
- 必须是以 `#` 开头的十六进制色值。
-
-
-
- 深色模式下的锚点颜色。
-
- 必须是以 `#` 开头的十六进制色值。
-
-
-
-
-
- 是否默认隐藏此锚点。
-
-
-
- 指向锚点目标的 URL 或路径。
-
-
-
-
-
- 用于组织相关内容的下拉菜单。
-
-
-
- 下拉菜单的显示名称。
-
- 最小长度:1
-
-
-
-
-
- 是否默认隐藏该下拉菜单。
-
-
-
- 下拉菜单目标的 URL 或路径。
-
-
-
-
-
-
-
- 适用于[多语言](zh/navigation#languages)站点的语言切换器。
-
-
-
- 为拥有多个[版本](zh/navigation#versions)的网站提供版本切换器。
-
-
-
- 顶层导航的 [tabs](zh/navigation#tabs)。
-
-
-
- 侧边栏[锚点](zh/navigation#anchors)。
-
-
-
- [下拉菜单](zh/navigation#dropdowns),用于分组相关内容。
-
-
-
- [Groups](zh/navigation#groups) 用于将内容组织成各个部分。
-
-
-
- 构成文档的各个[页面](zh/navigation#pages)。
-
-
-
-
-
- 导航元素的用户交互设置。
-
-
-
- 控制选择导航分组时的自动导航行为。设为 `true` 时,在展开导航分组时强制进入第一篇页面。设为 `false` 时不跳转,仅展开或折叠该分组。留空则使用主题的默认行为。
-
-
-
-
-
- 页脚内容与社交媒体链接。
-
-
-
- 要在页脚中显示的社交媒体帐号。每个 key 为平台名称,每个 value 为你的个人资料 URL。例如:
-
- ```json
- {
- "x": "https://x.com/mintlify"
- }
- ```
-
- 可用的属性名称:`x`、`website`、`facebook`、`youtube`、`discord`、`slack`、`github`、`linkedin`、`instagram`、`hacker-news`、`medium`、`telegram`、`twitter`、`x-twitter`、`earth-americas`、`bluesky`、`threads`、`reddit`、`podcast`
-
-
-
- 要在页脚中显示的链接。
-
-
-
- 列标题。
-
- 最小长度:1
-
-
-
- 要在该列中显示的链接。
-
-
-
- 链接文本。
-
- 最小长度:1
-
-
-
- 链接目标 URL。
-
-
-
-
-
-
-
-
-
- 显示在页面顶部的全站横幅。
-
-
-
- 横幅内容。支持纯文本和 Markdown 格式。例如:
-
- ```json
- {
- "content": "🚀 Banner is live! [Learn more](mintlify.com)"
- }
- ```
-
-
-
- 用户是否可以关闭横幅。默认为 `false`。
-
-
-
-
-
- 针对页面移动、重命名或删除的重定向。
-
-
-
- 要从中重定向的源路径。示例:`/old-page`
-
-
-
- 要重定向到的目标路径。示例:`/new-page`
-
-
-
- 是否使用永久重定向(301)。默认为 `true`。
-
-
-
-
-
- 用于 AI 优化内容和集成的上下文菜单。
-
-
-
- 上下文菜单中的可用操作。第一个选项将作为默认项显示。
-
- * `copy`:将当前页面以 Markdown 形式复制到剪贴板。
- * `view`:在新标签页中以 Markdown 查看当前页面。
- * `chatgpt`:将当前页面内容发送到 ChatGPT。
- * `claude`:将当前页面内容发送到 Claude。
- * `perplexity`:将当前页面内容发送到 Perplexity。
- * `mcp`:将你的 MCP 服务器 URL 复制到剪贴板。
- * `cursor`:在 Cursor 中安装你托管的 MCP 服务器。
- * `vscode`:在 VSCode 中安装你托管的 MCP 服务器。
-
-
-
-
- 上下文菜单仅在预览和生产部署中可用。
-
-
-
-
-
-
- ### API 配置
-
-
-
- API 文档与交互式操作台的相关设置。
-
-
-
- 用于生成 API 文档的 OpenAPI 规范文件。可为单个 URL/路径,也可为多个 URL/路径组成的数组。
-
-
-
- OpenAPI 规范文件的 URL 或路径。
-
- 最小长度:1
-
-
-
- 用于搜索 OpenAPI 文件的目录。
-
- 请勿以斜杠开头。
-
-
-
-
-
- 用于生成 API 文档的 AsyncAPI 规范文件。可为单个 URL/路径,也可为多个 URL/路径组成的数组。
-
-
-
- AsyncAPI 规范文件的 URL 或路径。
-
- 最小长度:1
-
-
-
- 用于搜索 AsyncAPI 文件的目录。
-
- 请勿以斜杠开头。
-
-
-
-
-
- API 参数的显示设置。
-
-
-
- 是否默认展开所有参数。默认值为 `closed`。
-
-
-
-
-
- API 操作台设置。
-
-
-
- API 操作台的显示模式。默认值为 `interactive`。
-
-
-
- 是否通过代理服务器转发 API 请求。默认值为 `true`。
-
-
-
-
-
- 自动生成的 API 示例配置。
-
-
-
- 自动生成的 API 代码片段的示例语言。
-
-
-
- 是否在 API 示例中显示可选参数。默认值为 `all`。
-
-
-
-
-
- 基于 `MDX` 文件生成的 API 页面配置。
-
-
-
- 基于 MDX 的 API 请求的认证配置。
-
-
-
- API 请求的认证方式。
-
-
-
- API 请求的认证名称。
-
-
-
-
-
- API 请求的服务器配置。
-
-
-
-
-
-
-
- ### SEO 与搜索
-
-
-
- SEO(搜索引擎优化)索引配置。
-
-
-
- 添加到每个页面的 Meta 标签。必须是有效的 key-value 键值对。可在 [常用 Meta 标签参考](/zh/settings/seo#common-meta-tags-reference) 中查看可选项。
-
-
-
- 指定哪些页面应被搜索引擎收录。选择 `navigable` 仅收录 `docs.json` 的 navigation 中的页面,选择 `all` 则收录所有页面。默认值为 `navigable`。
-
-
-
-
-
- 搜索展示设置。
-
-
-
- 搜索栏的占位提示文本。
-
-
-
-
-
- ### 集成
-
-
-
- 第三方集成。
-
-
-
- Amplitude Analytics 集成。
-
-
-
- 您的 Amplitude API 密钥。
-
-
-
-
-
- Clearbit 数据富集集成。
-
-
-
- 您的 Clearbit API key。
-
-
-
-
-
- Fathom Analytics 集成。
-
-
-
- 您的 Fathom 站点 ID。
-
-
-
-
-
- Front 聊天集成。
-
-
-
- 你的 Front 聊天代码片段 ID。
-
- 最小长度:6
-
-
-
-
-
- Google Analytics 4 集成。
-
-
-
- 您的 Google Analytics 4 measurement ID。
-
- 必须符合模式:^G
-
-
-
-
-
- Google Tag Manager 集成。
-
-
-
- 您的 Google Tag Manager 标签 ID。
-
- 必须符合模式:^G
-
-
-
-
-
- Heap Analytics 集成。
-
-
-
- 你的 Heap appId。
-
-
-
-
-
- Hotjar 集成。
-
-
-
- 您的 Hotjar ID。
-
-
-
- 您的 Hotjar 脚本版本。
-
-
-
-
-
- Intercom 集成。
-
-
-
- 您的 Intercom 应用 ID。
-
- 最小长度:6
-
-
-
-
-
- Koala 集成。
-
-
-
- 您的 Koala 公共 API key。
-
- 最小长度:2
-
-
-
-
-
- LogRocket 集成。
-
-
-
- 您的 LogRocket 应用 ID。
-
-
-
-
-
- Mixpanel 集成。
-
-
-
- 您的 Mixpanel 项目令牌。
-
-
-
-
-
- 与 Osano 的集成。
-
-
-
- 您的 Osano 脚本地址。
-
-
-
-
-
- Pirsch Analytics 集成。
-
-
-
- 你的 Pirsch ID。
-
-
-
-
-
- PostHog 集成。
-
-
-
- 你的 PostHog API key。
-
- 必须匹配模式:^phc_
-
-
-
- 你的 PostHog API 主机地址。
-
-
-
-
-
- Plausible Analytics 集成。
-
-
-
- 你的 Plausible domain(域名)。
-
-
-
- 你的 Plausible 服务器地址。
-
-
-
-
-
- Segment 集成。
-
-
-
- 你的 Segment key。
-
-
-
-
-
- 遥测设置。
-
-
-
- 是否启用遥测。
-
-
-
-
-
- Cookie 设置。
-
-
-
- Cookie 的 key。
-
-
-
- Cookie 的值。
-
-
-
-
-
-
-
- ### 错误
-
-
-
- 错误处理设置。
-
-
-
- 404“页面未找到”错误的处理。
-
-
-
- 当页面未找到时是否自动重定向到首页。
-
-
-
- 404 错误页面的自定义标题。
-
-
-
- 404 错误页面的自定义说明。支持 Markdown 格式。
-
-
-
-
-
-
-
- ## 示例
-
-
-
-
- ```json title="docs.json" wrap lines
- {
- "$schema": "https://mintlify.com/docs.json",
- "theme": "maple",
- "name": "Example Co.",
- "description": "Example Co. 是一家提供示例内容和占位符文本的公司。",
- "colors": {
- "primary": "#3B82F6",
- "light": "#F8FAFC",
- "dark": "#0F172A"
- },
- "navigation": {
- "dropdowns": [
- {
- "dropdown": "文档",
- "icon": "book",
- "description": "如何使用 Example Co. 产品",
- "groups": [
- {
- "group": "快速开始",
- "pages": [
- "index",
- "quickstart"
- ]
- },
- {
- "group": "自定义配置",
- "pages": [
- "settings",
- "users",
- "features"
- ]
- },
- {
- "group": "计费管理",
- "pages": [
- "billing/overview",
- "billing/payments",
- "billing/subscriptions"
- ]
- }
- ]
- },
- {
- "dropdown": "更新日志",
- "icon": "history",
- "description": "产品更新和变更记录",
- "pages": [
- "changelog"
- ]
- }
- ]
- },
- "logo": {
- "light": "/logo-light.svg",
- "dark": "/logo-dark.svg",
- "href": "https://example.com"
- },
- "navbar": {
- "links": [
- {
- "label": "社区",
- "href": "https://example.com/community"
- }
- ],
- "primary": {
- "type": "button",
- "label": "立即开始",
- "href": "https://example.com/start"
- }
- },
- "footer": {
- "socials": {
- "x": "https://x.com/example",
- "linkedin": "https://www.linkedin.com/company/example",
- "github": "https://github.com/example",
- "slack": "https://example.com/community"
- },
- "links": [
- {
- "header": "资源",
- "items": [
- {
- "label": "客户案例",
- "href": "https://example.com/customers"
- },
- {
- "label": "企业版",
- "href": "https://example.com/enterprise"
- },
- {
- "label": "申请试用",
- "href": "https://example.com/preview"
- }
- ]
- },
- {
- "header": "公司",
- "items": [
- {
- "label": "招聘信息",
- "href": "https://example.com/careers"
- },
- {
- "label": "博客",
- "href": "https://example.com/blog"
- },
- {
- "label": "隐私政策",
- "href": "https://example.com/legal/privacy"
- }
- ]
- }
- ]
- },
- "integrations": {
- "ga4": {
- "measurementId": "G-XXXXXXXXXX"
- },
- "koala": {
- "publicApiKey": "pk_example_key_123"
- },
- "telemetry": {
- "enabled": true
- },
- "cookies": {
- "key": "example_cookie_key",
- "value": "example_cookie_value"
- }
- },
- "contextual": {
- "options": [
- "copy",
- "view",
- "chatgpt",
- "claude"
- ]
- },
- "errors": {
- "404": {
- "redirect": false,
- "title": "页面未找到",
- "description": "这个_页面_到底**怎么了**?"
- }
- }
- }
- ```
-
-
-
- ```json title="docs.json" wrap lines highlight={43-61, 72-79}
- {
- "$schema": "https://mintlify.com/docs.json",
- "theme": "maple",
- "name": "Example Co.",
- "description": "Example Co. 是一家提供示例内容和占位符文本的公司。",
- "colors": {
- "primary": "#3B82F6",
- "light": "#F8FAFC",
- "dark": "#0F172A"
- },
- "navigation": {
- "dropdowns": [
- {
- "dropdown": "文档",
- "icon": "book",
- "description": "如何使用 Example Co. 产品",
- "groups": [
- {
- "group": "快速入门",
- "pages": [
- "index",
- "quickstart"
- ]
- },
- {
- "group": "自定义配置",
- "pages": [
- "settings",
- "users",
- "features"
- ]
- },
- {
- "group": "计费管理",
- "pages": [
- "billing/overview",
- "billing/payments",
- "billing/subscriptions"
- ]
- }
- ]
- },
- {
- "dropdown": "API 参考",
- "icon": "terminal",
- "description": "如何使用 Example Co. API",
- "groups": [
- {
- "group": "API 参考",
- "pages": [
- "api-reference/introduction"
- ]
- },
- {
- "group": "接口端点",
- "openapi": {
- "source": "openapi.json"
- }
- }
- ]
- },
- {
- "dropdown": "更新日志",
- "icon": "history",
- "description": "更新和变更记录",
- "pages": [
- "changelog"
- ]
- }
- ]
- },
- "api": {
- "playground": {
- "display": "interactive"
- },
- "examples": {
- "languages": ["javascript", "curl", "python"]
- }
- },
- "logo": {
- "light": "/logo-light.svg",
- "dark": "/logo-dark.svg",
- "href": "https://example.com"
- },
- "navbar": {
- "links": [
- {
- "label": "社区",
- "href": "https://example.com/community"
- }
- ],
- "primary": {
- "type": "button",
- "label": "立即开始",
- "href": "https://example.com/start"
- }
- },
- "footer": {
- "socials": {
- "x": "https://x.com/example",
- "linkedin": "https://www.linkedin.com/company/example",
- "github": "https://github.com/example",
- "slack": "https://example.com/community"
- },
- "links": [
- {
- "header": "资源",
- "items": [
- {
- "label": "客户案例",
- "href": "https://example.com/customers"
- },
- {
- "label": "企业版",
- "href": "https://example.com/enterprise"
- },
- {
- "label": "申请预览",
- "href": "https://example.com/preview"
- }
- ]
- },
- {
- "header": "公司",
- "items": [
- {
- "label": "招聘信息",
- "href": "https://example.com/careers"
- },
- {
- "label": "博客",
- "href": "https://example.com/blog"
- },
- {
- "label": "隐私政策",
- "href": "https://example.com/legal/privacy"
- }
- ]
- }
- ]
- },
- "integrations": {
- "ga4": {
- "measurementId": "G-XXXXXXXXXX"
- },
- "koala": {
- "publicApiKey": "pk_example_key_123"
- },
- "telemetry": {
- "enabled": true
- },
- "cookies": {
- "key": "example_cookie_key",
- "value": "example_cookie_value"
- }
- },
- "contextual": {
- "options": [
- "copy",
- "view",
- "chatgpt",
- "claude"
- ]
- },
- "errors": {
- "404": {
- "redirect": false,
- "title": "页面未找到",
- "description": "这个**页面**到底_去哪了_?"
- }
- }
- }
- ```
-
-
-
- ```json title="docs.json" wrap lines
- {
- "$schema": "https://mintlify.com/docs.json",
- "theme": "maple",
- "name": "Example Co.",
- "description": "Example Co. 是一家提供示例内容和占位符文本的公司。",
- "colors": {
- "primary": "#3B82F6",
- "light": "#F8FAFC",
- "dark": "#0F172A"
- },
- "navigation": {
- "global": {
- "anchors": [
- {
- "anchor": "文档",
- "href": "https://mintlify.com/docs"
- },
- {
- "anchor": "更新日志",
- "href": "https://mintlify.com/docs/changelog"
- }
- ]
- },
- "languages": [ // [!code highlight:3]
- {
- "language": "en",
- "dropdowns": [
- {
- "dropdown": "文档",
- "icon": "book",
- "description": "如何使用 Example Co. 产品",
- "pages": [
- {
- "group": "快速入门",
- "pages": ["index", "quickstart"]
- },
- {
- "group": "自定义配置",
- "pages": ["settings", "users", "features"]
- },
- {
- "group": "计费管理",
- "pages": [
- "billing/overview",
- "billing/payments",
- "billing/subscriptions"
- ]
- }
- ]
- },
- {
- "dropdown": "更新日志",
- "icon": "history",
- "description": "更新和变更记录",
- "pages": ["changelog"]
- }
- ]
- },
- {
- "language": "es",// [!code highlight]
- "dropdowns": [
- {
- "dropdown": "文档",
- "icon": "book",
- "description": "如何使用 Example Co. 产品",
- "pages": [
- {
- "group": "快速入门",
- "pages": ["es/index", "es/quickstart"]
- },
- {
- "group": "自定义配置",
- "pages": ["es/settings", "es/users", "es/features"]
- },
- {
- "group": "计费管理",
- "pages": [
- "es/billing/overview",
- "es/billing/payments",
- "es/billing/subscriptions"
- ]
- }
- ]
- },
- {
- "dropdown": "更新日志",
- "icon": "history",
- "description": "更新和变更记录",
- "pages": ["es/changelog"]
- }
- ]
- }
- ]
- },
- "logo": {
- "light": "/logo-light.svg",
- "dark": "/logo-dark.svg",
- "href": "https://example.com"
- },
- "navbar": {
- "links": [
- {
- "label": "社区",
- "href": "https://example.com/community"
- }
- ],
- "primary": {
- "type": "button",
- "label": "立即开始",
- "href": "https://example.com/start"
- }
- },
- "footer": {
- "socials": {
- "x": "https://x.com/example",
- "linkedin": "https://www.linkedin.com/company/example",
- "github": "https://github.com/example",
- "slack": "https://example.com/community"
- },
- "links": [
- {
- "header": "资源",
- "items": [
- {
- "label": "客户案例",
- "href": "https://example.com/customers"
- },
- {
- "label": "企业版",
- "href": "https://example.com/enterprise"
- },
- {
- "label": "申请试用",
- "href": "https://example.com/preview"
- }
- ]
- },
- {
- "header": "公司",
- "items": [
- {
- "label": "招聘信息",
- "href": "https://example.com/careers"
- },
- {
- "label": "博客",
- "href": "https://example.com/blog"
- },
- {
- "label": "隐私政策",
- "href": "https://example.com/legal/privacy"
- }
- ]
- }
- ]
- },
- "integrations": {
- "ga4": {
- "measurementId": "G-XXXXXXXXXX"
- },
- "koala": {
- "publicApiKey": "pk_example_key_123"
- },
- "telemetry": {
- "enabled": true
- },
- "cookies": {
- "key": "example_cookie_key",
- "value": "example_cookie_value"
- }
- },
- "contextual": {
- "options": ["copy", "view", "chatgpt", "claude"]
- },
- "errors": {
- "404": {
- "redirect": false,
- "title": "页面未找到",
- "description": "这个**页面**到底_怎么了_?"
- }
- }
- }
- ```
-
-
-
-
- ## 从 `mint.json` 升级
-
-
-如果你的文档项目仍在使用已废弃的 `mint.json` 文件,请按以下步骤升级到 `docs.json`。
-
-
-
- 如果你尚未安装[命令行界面(CLI)](/zh/installation),请先安装:
-
-
- ```bash npm
- npm i -g mint
- ```
-
- ```bash yarn
- yarn global add mint
- ```
-
- ```bash pnpm
- pnpm add -g mint
- ```
-
-
- 如果你已经安装了 CLI,请确保更新至最新版本:
-
- ```bash
- mint update
- ```
-
-
-
- 在你的文档存储库中运行:
-
- ```bash
- mint upgrade
- ```
-
- 该命令会基于现有的 `mint.json` 生成一个 `docs.json` 文件。请检查生成的文件,确保所有设置正确。
-
-
-
- 在确认 `docs.json` 配置无误后,你即可安全删除旧的 `mint.json` 文件。
-
-
\ No newline at end of file
diff --git a/zh/settings/broken-links.mdx b/zh/settings/broken-links.mdx
deleted file mode 100644
index 3b7ead960..000000000
--- a/zh/settings/broken-links.mdx
+++ /dev/null
@@ -1,47 +0,0 @@
----
-title: "重定向与失效链接"
-description: "防止链接失效的工具"
-icon: "link-2"
----
-
-当你更改 docs 文件夹中文件的路径时,该页面的 URL 也会随之更改。这通常发生在重组文档或更改侧边栏标题时。
-
-
- ## 失效链接
-
-
-使用我们的命令行界面(CLI)检查并发现失效链接。[安装 CLI](/zh/installation) 后运行以下命令:
-
-```bash
-mint broken-links
-```
-
-命令行界面(CLI)会检测文档中所有指向不存在目标的相对链接。
-
-
- ## 重定向
-
-
-在你的 `docs.json` 文件中添加 `redirects` 字段来设置 301 重定向。
-
-```json
-"redirects": [
- {
- "source": "/source/path",
- "destination": "/destination/path"
- }
-]
-```
-
-这会将 `/source/path` 永久重定向到 `/destination/path`,从而保留原页面既有的 SEO(搜索引擎优化)权重。
-
-要匹配通配路径,请在参数后使用 `*`。在此示例中,`/beta/:slug*` 会匹配 `/beta/introduction`,并将其重定向到 `/v2/introduction`。
-
-```json
-"redirects": [
- {
- "source": "/beta/:slug*",
- "destination": "/v2/:slug*"
- }
-]
-```
diff --git a/zh/settings/ci.mdx b/zh/settings/ci.mdx
deleted file mode 100644
index e5f70faad..000000000
--- a/zh/settings/ci.mdx
+++ /dev/null
@@ -1,425 +0,0 @@
----
-title: "CI 检查"
-description: "在更新流程中添加死链检测、lint 与语法检查"
-icon: "circle-check"
----
-
-
- [Pro 和 Enterprise 套餐](https://mintlify.com/pricing?ref=docs-ci)包含针对 GitHub 仓库的 CI 检查。
-
-
-使用 CI 检查对文档进行 lint、发现错误,并在部署前提供 Warning。CI 检查会在对已配置的部署用分支的提交上,或针对该分支的拉取请求(PR)上运行。
-
-
- ## 安装
-
-
-首先,请按照 [GitHub](/zh/settings/github) 页面上的步骤操作。
-
-对于 GitHub 应用,您可以选择仅为单个存储库授予权限。我们强烈建议这样做,因为我们只需要访问托管您文档的存储库。
-
-
- ## 配置
-
-
-前往控制台的 [附加组件](https://dashboard.mintlify.com/products/addons) 页面,配置在部署中启用的 CI 检查。启用你希望运行的检查项。
-
-启用检查时,你可以选择以 `Warning` 或 `Blocking` 级别运行。
-
-* `Warning` 级别的检查即使存在错误或建议,也不会标记为失败。
-* `Blocking` 级别的检查若未通过或提出了更改建议,将标记为失败。
-
-
- ## 可用的 CI 检查
-
-
-
- ### 断链
-
-
-与本地的 [CLI 链接检查器](/zh/settings/broken-links#broken-links) 类似,我们会自动扫描文档中的断链。
-
-要查看检查结果,请前往 GitHub 上该特定提交的检查结果页面。
-
-
- ### Vale
-
-
-[Vale](https://vale.sh/) 是一个开源的、基于规则的文本风格校验器,支持包括 Markdown 和 MDX 在内的多种文档类型。
-
-Mintlify 支持在 CI 检查中自动运行 Vale,并将结果显示为检查状态。
-
-
- #### 配置
-
-
-如果在部署的根内容目录中有 `.vale.ini` 文件,我们会自动使用该配置文件。我们也会自动加载你在 `stylesPath` 中指定的任何配置文件。
-
-如果没有 Vale 配置文件,将使用默认配置。
-
-```mdx Default vale.ini configuration expandable
-# 顶级样式
-StylesPath = /app/styles
-MinAlertLevel = suggestion
-IgnoredScopes = code, tt, img, url, a
-SkippedScopes = script, style, pre, figure, code
-
-# 词汇表
-Vocab = Mintlify
-
-# 这是必需的,因为 Vale 官方不支持 MDX
-[formats]
-mdx = md
-
-# MDX 支持
-[*.mdx]
-BasedOnStyles = Vale
-Vale.Terms = NO # 强制执行非常严格的大小写规则,保持关闭
-
-# `import ...`, `export ...`
-# `
`
-# `
... `
-# `{ ... }`
-TokenIgnores = (?sm)((?:import|export) .+?$), \
-(?)(?!`), \
-(<[A-Z]\w+>.+?<\/[A-Z]\w+>)
-
-# 排除:
-# `
`
-BlockIgnores = (?sm)^(<\w+\n .*\s\/>)$, \
-(?sm)^({.+.*})
-
-CommentDelimiters = {/*, */}
-```
-
-```text Default Vale vocabulary expandable
-Mintlify
-mintlify
-VSCode
-openapi
-OpenAPI
-GitHub
-API
-
-repo
-npm
-dev
-
-Lorem
-ipsum
-impsum
-amet
-
-const
-myName
-myObject
-bearerAuth
-favicon
-topbar
-url
-borderRadius
-args
-modeToggle
-ModeToggle
-isHidden
-autoplay
-
-_italic_
-Strikethrough
-Blockquotes
-Blockquote
-Singleline
-Multiline
-
-onboarding
-
-async
-await
-boolean
-enum
-func
-impl
-init
-instanceof
-typeof
-params
-stdin
-stdout
-stderr
-stdout
-stdin
-var
-const
-let
-null
-undefined
-struct
-bool
-
-cors
-csrf
-env
-xhr
-xhr2
-jwt
-oauth
-websocket
-localhost
-middleware
-runtime
-webhook
-stdin
-stdout
-
-json
-yaml
-yml
-md
-txt
-tsx
-jsx
-css
-scss
-html
-png
-jpg
-svg
-
-cdn
-命令行界面(CLI)
-css
-dom
-dto
-env
-Git
-gui
-http
-https
-ide
-jvm
-mvc
-orm
-rpc
-SDK
-sql
-ssh
-ssl
-tcp
-tls
-uri
-URL
-ux
-ui
-
-nodejs
-npm
-yarn
-pnpm
-eslint
-pytest
-golang
-rustc
-kubectl
-mongo
-postgres
-redis
-
-JavaScript
-TypeScript
-Python
-Ruby
-Rust
-Go
-Golang
-Java
-Kotlin
-Swift
-Node.js
-NodeJS
-Deno
-
-React
-Vue
-Angular
-Next.js
-Nuxt
-Express
-Django
-Flask
-Spring
-Laravel
-Redux
-Vuex
-TensorFlow
-PostgreSQL
-MongoDB
-Redis
-PNPM
-
-Docker
-Kubernetes
-AWS
-Azure
-GCP
-Terraform
-Jenkins
-CircleCI
-GitLab
-Heroku
-
-Git
-git
-GitHub
-GitLab
-Bitbucket
-VSCode
-Visual Studio Code
-IntelliJ
-WebStorm
-ESLint
-eslint
-Prettier
-prettier
-Webpack
-webpack
-Vite
-vite
-Babel
-babel
-Jest
-jest
-Mocha
-Cypress
-Postman
-
-HTTP
-HTTPS
-OAuth
-JWT(JSON Web Token)
-GraphQL
-REST
-WebSocket
-TCP/IP
-
-NPM
-Yarn
-PNPM
-Pip
-PIP
-Cargo
-RubyGems
-
-Swagger
-OpenAPI
-Markdown
-MDX
-Storybook
-TypeDoc
-JSDoc
-
-MySQL
-PostgreSQL
-MongoDB
-Redis
-Elasticsearch
-DynamoDB
-
-Linux
-Unix
-macOS
-iOS
-
-Firefox
-Chromium
-WebKit
-
-config
-ctx
-desc
-dir
-elem
-err
-len
-msg
-num
-obj
-prev
-proc
-ptr
-req
-res
-str
-tmp
-val
-vars
-
-todo
-href
-lang
-nav
-prev
-next
-toc
-```
-
-
- 请注意,出于安全原因,我们不支持任何绝对路径的 `stylesPath`,以及包含 `..` 的 `stylesPath`。请使用相对路径,并将 `stylesPath` 包含在你的存储库中。
-
-
-
- #### 包
-
-
-Vale 支持一系列[包](https://vale.sh/docs/keys/packages),可用于检查拼写和样式错误。
-你在存储库中按正确的 `stylesPath` 放置的任何包都会被自动安装,并用于你的 Vale 配置。
-
-对于未包含在存储库中的包,你可以从 [Vale package registry](https://vale.sh/explorer) 指定任意包,它们会被自动下载并用于你的 Vale 配置。
-
-
- 请注意,出于安全原因,我们不支持自动下载不来自 [Vale package registry](https://vale.sh/explorer) 的包。
-
-
-
- #### 在 `MDX` 中使用 Vale
-
-
-Vale 并不原生支持 `MDX`,但 Vale 的作者提供了一个[自定义扩展](https://github.com/errata-ai/MDX)来实现支持。
-
-如果你不想使用此扩展,我们建议在 `.vale.ini` 文件中加入以下几行:
-
-```ini
-[formats]
-mdx = md
-
-[*.mdx]
-CommentDelimiters = {/*, */}
-
-TokenIgnores = (?sm)((?:import|export) .+?$), \
-(?)(?!`), \
-(<[A-Z]\w+>.+?<\/[A-Z]\w+>)
-
-BlockIgnores = (?sm)^(<\w+\n .*\s\/>)$, \
-(?sm)^({.+.*})
-```
-
-要在文档中使用 Vale 的文内注释,请采用 MDX 风格的注释 `{/* ... */}`。如果你在配置中启用 `CommentDelimiters = {/*, */}` [设置](https://vale.sh/docs/keys/commentdelimiters),Vale 会在 lint 过程中自动识别这些注释。这样你就可以轻松使用 Vale 的内置功能,比如跳过某些行或部分。
-
-```mdx
-{/* vale off */}
-
-此文本将被 Vale 忽略
-
-{/* vale on */}
-```
-
-如果你选择不使用 `CommentDelimiters`,但仍要使用 Vale 的注释,则必须将所有 Vale 注释包裹在 MDX 注释 `{/* ... */}` 中。例如:
-
-```mdx
-{/* */}
-
-此文本将被 Vale 忽略
-
-{/* */}
-```
-
-这些注释标签在 Mintlify 组件内不受支持,但可以在文档的根级任意位置使用。
diff --git a/zh/settings/custom-404-page.mdx b/zh/settings/custom-404-page.mdx
deleted file mode 100644
index 8422ef25f..000000000
--- a/zh/settings/custom-404-page.mdx
+++ /dev/null
@@ -1,46 +0,0 @@
----
-title: "自定义 404 页面"
-description: "自定义 404 错误页面的标题和说明"
-icon: "file-warning"
----
-
-你可以自定义当用户访问失效或缺失链接时显示的 404 错误页面的标题和说明。
-
-在自定义 404 页面时,利用说明引导用户前往文档中的相关资源或链接,帮助他们找到所需内容。
-
-
- ## 配置
-
-
-在 `docs.json` 文件的 `errors.404` 部分配置你的 404 页面:
-
-```json
-"errors": {
- "404": {
- "redirect": false,
- "title": "页面未找到",
- "description": "这个_页面_**怎么了**?"
- }
-}
-```
-
-
-
- ## 参数
-
-
-
- 当页面未找到时,是否自动重定向到首页。
-
- 设为 `true` 会重定向到首页。
-
- 设为 `false` 将显示自定义 404 页面。
-
-
-
- 404 错误页面的自定义标题。此项将替换默认的“Page not found”标题。
-
-
-
- 404 错误页面的自定义说明。支持 Markdown 格式。
-
\ No newline at end of file
diff --git a/zh/settings/custom-domain.mdx b/zh/settings/custom-domain.mdx
deleted file mode 100644
index 19d3b99a9..000000000
--- a/zh/settings/custom-domain.mdx
+++ /dev/null
@@ -1,55 +0,0 @@
----
-title: "自定义域名"
-description: "将文档托管在你的网站自定义域名下"
-icon: "globe"
----
-
-要在自定义域名下托管文档,你需要先在 Mintlify 设置中填写所需的自定义域名,并在你的域名服务商处配置 DNS(域名系统)记录。
-
-
- 想设置类似 `mintlify.com/docs` 的自定义子目录?请查看[自定义子目录](/zh/advanced/subpath/cloudflare)文档。
-
-
-
- ## 控制台设置
-
-
-1. 前往你的[控制台](https://dashboard.mintlify.com)
-2. 选择「设置」
-3. 选择「域名设置」
-4. 输入你想使用的自定义域名,例如:`docs.mintlify.com`
-
-
-
-
-
-
-
-
- ## 配置你的 DNS
-
-
-1. 在域名提供商的网站中,进入你的域名的 DNS 设置页面。
-2. 新建一条 DNS 记录,并输入以下值:
-
-```bash
-CNAME | docs | cname.vercel-dns.com.
-```
-
-
-
-
-
-
- ## 面向特定提供商的设置
-
-
-
-
- 如果 Vercel 是你的域名提供商,你必须添加一个用于验证的 `TXT` 记录。提交自定义域名后,这些信息会显示在你的控制台中,并通过电子邮件发送给你。
-
-
-
- 如果 Cloudflare 是你的 DNS 提供商,你必须在 HTTPS 设置中启用“Full (strict)”安全选项。
-
-
\ No newline at end of file
diff --git a/zh/settings/custom-scripts.mdx b/zh/settings/custom-scripts.mdx
deleted file mode 100644
index 8ec60b335..000000000
--- a/zh/settings/custom-scripts.mdx
+++ /dev/null
@@ -1,195 +0,0 @@
----
-title: "自定义脚本"
-description: "通过自定义 CSS 和 JS 完全定制你的文档"
-icon: "code"
----
-
-使用 CSS 为 HTML 元素设置样式,或添加自定义 CSS 和 JavaScript,以全面定制文档的外观与体验。
-
-
- ## 使用 Tailwind CSS 进行样式设计
-
-
-使用 Tailwind CSS v3 为 HTML 元素设置样式。你可以控制布局、间距、颜色及其他视觉属性。常见的类包括:
-
-* `w-full` - 宽度占满容器
-* `aspect-video` - 16:9 宽高比
-* `rounded-xl` - 大号圆角
-* `block`, `hidden` - 显示控制
-* `dark:hidden`, `dark:block` - 深色模式下的可见性
-
-不支持 Tailwind CSS 的任意值语法。需要自定义值时,请改用 `style` 属性。
-
-```html
-
-```
-
-
-
- ## 自定义 CSS
-
-
-将 CSS 文件添加到你的存储库后,其中定义的类名会自动生效,并可在所有 `MDX` 文件中使用。
-
-
- ### 添加 `style.css`
-
-
-例如,你可以添加下面的 `style.css` 文件来自定义导航栏和页脚的样式。
-
-```css
-#navbar {
- background: "#fffff2";
- padding: 1rem;
-}
-
-footer {
- margin-top: 2rem;
-}
-```
-
-
-
- ### 使用标识符和选择器
-
-
-Mintlify 提供了一组常用的标识符和选择器,帮助你为 UI 中的重要元素打上标签。
-
-
- 使用“检查元素”来定位你想自定义的元素及其引用。
-
-
-
-
- - APIPlaygroundInput: `api-playground-input`
- - AssistantEntry: `assistant-entry`
- - AssistantEntryMobile: `assistant-entry-mobile`
- - Banner: `banner`
- - ChangelogFilters: `changelog-filters`
- - ChangelogFiltersContent: `changelog-filters-content`
- - ChatAssistantSheet: `chat-assistant-sheet`
- - ChatAssistantTextArea: `chat-assistant-textarea`
- - ContentArea: `content-area`
- - ContentContainer: `content-container`
- - ContentSideLayout: `content-side-layout`
- - Footer: `footer`
- - Header: `header`
- - NavBarTransition: `navbar-transition`
- - NavigationItems: `navigation-items`
- - Navbar: `navbar`
- - PageContextMenu: `page-context-menu`
- - PageContextMenuButton: `page-context-menu-button`
- - PageTitle: `page-title`
- - Pagination: `pagination`
- - Panel: `panel`
- - RequestExample: `request-example`
- - ResponseExample: `response-example`
- - SearchBarEntry: `search-bar-entry`
- - SearchBarEntryMobile: `search-bar-entry-mobile`
- - SearchInput: `search-input`
- - Sidebar: `sidebar`
- - SidebarContent: `sidebar-content`
- - TableOfContents: `table-of-contents`
- - TableOfContentsContent: `table-of-contents-content`
- - TableOfContentsLayout: `table-of-contents-layout`
- - TopbarCtaButton: `topbar-cta-button`
-
-
- - Accordion: `accordion`
- - AccordionGroup: `accordion-group`
- - AlmondLayout: `almond-layout`
- - AlmondNavBottomSection: `almond-nav-bottom-section`
- - AlmondNavBottomSectionDivider: `almond-nav-bottom-section-divider`
- - Anchor: `nav-anchor`
- - Anchors: `nav-anchors`
- - APISection: `api-section`
- - APISectionHeading: `api-section-heading`
- - APISectionHeadingSubtitle: `api-section-heading-subtitle`
- - APISectionHeadingTitle: `api-section-heading-title`
- - Callout: `callout`
- - Card: `card`
- - CardGroup: `card-group`
- - ChatAssistantSheet: `chat-assistant-sheet`
- - ChatAssistantSheetHeader: `chat-assistant-sheet-header`
- - ChatAssistantSheetContent: `chat-assistant-sheet-content`
- - ChatAssistantInput: `chat-assistant-input`
- - ChatAssistantSendButton: `chat-assistant-send-button`
- - CodeBlock: `code-block`
- - CodeGroup: `code-group`
- - Content: `mdx-content`
- - DropdownTrigger: `nav-dropdown-trigger`
- - DropdownContent: `nav-dropdown-content`
- - DropdownItem: `nav-dropdown-item`
- - DropdownItemTextContainer: `nav-dropdown-item-text-container`
- - DropdownItemTitle: `nav-dropdown-item-title`
- - DropdownItemDescription: `nav-dropdown-item-description`
- - DropdownItemIcon: `nav-dropdown-item-icon`
- - Expandable: `expandable`
- - Eyebrow: `eyebrow`
- - FeedbackToolbar: `feedback-toolbar`
- - Field: `field`
- - Frame: `frame`
- - Icon: `icon`
- - Link: `link`
- - LoginLink: `login-link`
- - Logo: `nav-logo`
- - Mermaid: `mermaid`
- - MethodNavPill: `method-nav-pill`
- - MethodPill: `method-pill`
- - NavBarLink: `navbar-link`
- - NavTagPill: `nav-tag-pill`
- - NavTagPillText: `nav-tag-pill-text`
- - OptionDropdown: `option-dropdown`
- - PaginationNext: `pagination-next`
- - PaginationPrev: `pagination-prev`
- - PaginationTitle: `pagination-title`
- - Panel: `panel`
- - SidebarGroup: `sidebar-group`
- - SidebarGroupIcon: `sidebar-group-icon`
- - SidebarGroupHeader: `sidebar-group-header`
- - SidebarNavGroupDivider: `sidebar-nav-group-divider`
- - SidebarTitle: `sidebar-title`
- - Step: `step`
- - Steps: `steps`
- - Tab: `tab`
- - Tabs: `tabs`
- - TabsBar: `nav-tabs`
- - TabsBarItem: `nav-tabs-item`
- - TableOfContents: `toc`
- - TableOfContentsItem: `toc-item`
- - Tooltip: `tooltip`
- - TopbarRightContainer: `topbar-right-container`
- - TryitButton: `tryit-button`
- - Update: `update`
-
-
-
-
- 随着平台演进,引用与常见元素的样式可能会变更。请谨慎使用自定义样式。
-
-
-
- ## 自定义 JavaScript
-
-
-自定义 JS 允许你在全局添加自定义可执行代码,相当于在每个页面都插入一个包含 JS 代码的 `