5分钟内开始构建出色的文档
了解如何在本地更新文档并将其部署到公网。
在本地克隆文档
在入职流程中,我们在您的 Github 上创建了一个包含文档内容的仓库。您可以在我们的 控制台中找到这个仓库。要在本地克隆该仓库, 请在终端中按照这些说明 进行操作。
预览更改
预览功能可以帮助您确保更改的效果符合预期。我们构建了一个命令行界面来在本地渲染这些更改。
npm i -g mintlify
docs.json
mintlify dev
如果您当前正在使用旧版的 mint.json 配置文件,请更新 Mintlify CLI:
mint.json
npm i -g mintlify@latest 然后在您的文档仓库中运行新的升级命令:
npm i -g mintlify@latest
mintlify upgrade 现在您应该使用新的 docs.json 配置文件了。您可以从仓库中删除 mint.json 文件。
mintlify upgrade
安装我们的 Github 应用
我们的 Github 应用会自动将您的更改部署到文档站点,因此您无需自己管理部署。 您可以在控制台中找到安装链接。 一旦机器人安装成功,仓库的提交哈希值旁边就会出现一个对勾标记。
推送更改
提交并将更改推送到 Git 以更新您的文档站点。如果推送后没有看到 Github 应用成功部署您的更改, 您也可以通过我们的控制台手动更新文档。
使用 MDX 语法和 React 组件直接在文件中添加内容。您可以使用我们的任何组件,甚至可以构建自己的组件。
使用 MDX 语法向文档添加内容。
直接在文档中添加带有语法高亮的代码。
向文档添加图片,使其更具吸引力。
向文档添加模板,使其更易于重用。