mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
6825fd0926
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
67 lines
3.4 KiB
Plaintext
67 lines
3.4 KiB
Plaintext
---
|
||
title: "编辑器概览"
|
||
sidebarTitle: "概览"
|
||
description: "在浏览器中创建、编辑和发布文档，支持团队实时协作、自动保存、实时预览以及与 Git 持续同步。"
|
||
keywords: ["editor", "visual", "collaborative", "web editor"]
|
||
---
|
||
|
||
<img className="block dark:hidden my-0 pointer-events-none" src="/images/editor/editor-light.png" alt="浅色模式下的 Web 编辑器装饰性图像" />
|
||
|
||
<img className="hidden dark:block my-0 pointer-events-none" src="/images/editor/editor-dark.png" alt="深色模式下的 Web 编辑器装饰性图像" />
|
||
|
||
编辑器让你的内容与 Git 仓库保持同步，并让整个团队可以实时协同编辑。
|
||
|
||
<div id="open-the-editor">
|
||
## 打开编辑器
|
||
</div>
|
||
|
||
在 Mintlify 仪表板中，通过 [Editor](https://app.mintlify.com/editor) 标签页打开编辑器。你所在组织的任何成员都可以打开编辑器；你在编辑器内能做什么取决于你的[角色](/zh/dashboard/roles)。Admins 和 editors 可以编辑和发布，viewers 可以浏览内容，并留下[评论](/zh/editor/comments)或[建议](/zh/editor/suggestions)。
|
||
|
||
<div id="how-the-editor-works">
|
||
## 编辑器的工作原理
|
||
</div>
|
||
|
||
**更改自动保存。** 你在输入时，编辑器会自动保存你的工作。你的更改会在不同标签页、设备以及网络中断之间保持不变。只有在你发布时更改才会上线。
|
||
|
||
**Git 持续保持同步。** 当他人从编辑器之外向你的仓库推送更改时，这些更改会自动出现在编辑器中。你无需拉取或刷新。编辑器会自动合并无冲突的更改，并突出显示需要你关注的内容。
|
||
|
||
<Tip>
|
||
如果编辑器与你的仓库出现不同步的情况，请使用 [Reset editor](/zh/editor/settings#reset-editor) 强制从 Git 重新同步。例如，文件树为空，或即使文件确实存在于你的部署分支上仍显示 `Unable to find docs.json`。
|
||
</Tip>
|
||
|
||
**发布会写入 Git。** 当你发布时，编辑器会将你的更改提交到你的仓库。在部署 branch 上，这会立即更新你的线上站点。在功能 branch 上，则会创建一个拉取请求。
|
||
|
||
**团队协同编辑。** 多人可以同时编辑同一个页面。实时光标会显示谁在哪里进行编辑。
|
||
|
||
<div id="explore-the-editor">
|
||
## 探索编辑器
|
||
</div>
|
||
|
||
<Card title="Branching and publishing" icon="git-branch" horizontal href="/zh/editor/publish">
|
||
了解 branch 和保护规则如何决定你在发布时发生的行为，以及如何管理拉取请求审查流程。
|
||
</Card>
|
||
|
||
<Card title="评论" icon="message-square" horizontal href="/zh/editor/comments">
|
||
留下反馈、提出问题并与团队讨论更改。
|
||
</Card>
|
||
|
||
<Card title="建议" icon="pen-line" horizontal href="/zh/editor/suggestions">
|
||
提出团队成员可以审阅、接受或拒绝的更改建议。
|
||
</Card>
|
||
|
||
<Card title="创建和编辑页面" icon="notebook-pen" horizontal href="/zh/editor/pages">
|
||
添加新页面和更新现有页面所需的一切。
|
||
</Card>
|
||
|
||
<Card title="组织导航" icon="list-tree" horizontal href="/zh/editor/navigation">
|
||
重新排序页面并管理站点结构。
|
||
</Card>
|
||
|
||
<Card title="配置" icon="settings" horizontal href="/zh/editor/configurations">
|
||
配置站点品牌、配色和功能。
|
||
</Card>
|
||
|
||
<Card title="键盘快捷键" icon="keyboard" horizontal href="/zh/editor/keyboard-shortcuts">
|
||
使用键盘快捷键加快你的工作流程。
|
||
</Card>
|