Workspace 与 Site
- Recents:你最近打开的 workspace 页面。
- Starred:你已加星标的 workspace 页面。若要给页面加星标,请打开其选项菜单并选择 Star。星标仅对你可见。
- Personal:你的私有页面。
- Teamspace:与组织中所有人共享的页面。请参阅 Teamspace。
- Shared with me:同事直接与你共享的页面。
- Navigation:站点导航中的页面和分组,在
docs.json中定义。 - Files:仓库中所有不在导航里的文件,包括图片、视频、OpenAPI 规范和
docs.json。
创建页面
- Navigation 分区标题:在导航末尾添加一个新页面。
- 分组或其他导航元素:在该元素内添加一个新页面。
- Files 分区标题或 Files 中的文件夹:创建一个不在导航中的文件。
编辑页面设置
- URL:页面的路径和重定向 URL。更改路径会移动该文件。
- Navigation:侧边栏标题、tag、mode 以及页面是否隐藏。
- SEO & sharing:Open Graph 图片和关键词。
添加媒体
- 上传的文件会保存到你的
images/、videos/和files/文件夹中,并随下次发布一起提交。在插入上传之前,你可以编辑其文件路径。 - 你可以上传 PNG、JPG、GIF、WebP、AVIF、ICO 和 BMP 图片,MP4、WebM 和 MOV 视频,以及 PDF 文件。SVG 文件无法在编辑器中上传。
- 每次上传的文件大小最多为 20 MB。
- 点击图片即可选中它。拖动图片可移动其位置,包括拖入或拖出 frames、cards、tabs 和 callouts 等组件。拖动图片边缘的控制柄可调整其大小。按 Delete 或 Backspace 可将其删除。
- 若要在深色模式下提供另一张图片,请选中图片,点击 Edit Image,然后设置 Dark mode image。
- 输入 /embed 添加嵌入内容。在 Video link 标签页中粘贴 YouTube、Loom 或 Vimeo 的 URL,或指向视频文件的直链。在 Embed code 标签页中粘贴 iframe 或其他嵌入代码片段。
docs.json。
有些元素无法嵌套在其他元素中。例如,tabs 不能嵌套在 groups 中。编辑器会阻止无效的组合。
文件
- 图片会在预览中打开。点击图片可放大。
- 视频会在编辑器中播放。
docs.json会以 source 模式打开。- 文本和代码文件(例如 YAML、JSON 和 CSS)会在 source 编辑器中打开。
- 编辑器无法预览其他文件(例如字体和压缩包)。
移动页面
- 打开的页面右上角的 More options。
- 侧边栏中页面旁边的 菜单。
- 在侧边栏中右键点击页面。
删除页面
版本历史
docs.json 不支持版本历史。
停止编辑页面约 10 秒后,编辑器会记录一个新版本。如果你持续编辑,编辑器至少每分钟记录一个版本。从 Git 仓库同步的更改也会创建版本,这些版本的作者显示为 Git sync。版本历史按分支划分,只能查看当前分支的版本历史。
- 点击页面右上角的 More options。
- 点击 Version history。
- 选择一个版本。编辑器会显示当前页面与该版本的差异。
- 若要恢复它,请点击 Restore this version。
私有页面
- Full Access:编辑、移动到你的 site 并共享。
- Editor:创建和编辑内容。
- Viewer:仅查看内容。