book-open术语表

一项

操作菜单: 在 GitBook 界面中,当你点击页面或项目旁边的三个点时打开的菜单。操作菜单可能会根据你当前的视图模式显示不同的选项。

新增: 位于空间目录底部的按钮/菜单,可让你向空间添加新内容。也用于指代 + 旁边的按钮 文档站点空间 侧边栏中的各个部分标题,你可以点击它来创建一个新站点、空间或集合。

询问或搜索: GitBook 中用于搜索内容的工具。你可以点击侧边栏顶部将其打开,或按 ⌘ + K。你可以输入关键词进行标准搜索,或使用 GitBook AI 提问,它会根据你的内容总结结果。

受众设置: 决定谁可以访问已发布文档站点的设置。有关 发布文档站点 中的选项的更多信息,请参阅 受众设置菜单.

B

块: 你添加到页面中的每一项内容都存在于一个块中。块有很多不同类型,允许你添加文本、图片、表格、代码、API 参考、嵌入内容等等。你可以通过拖拽来移动块,更改其设置,并在某些情况下,将一个块更改为不同类型,方法是通过该块的 选项菜单.

C

变更请求: 变更请求类似于 GitHub 中的拉取请求。它们让你可以在同一个空间的多个分支上并行工作,同时保持原始版本不变。在 GitBook 中,你可以创建一个新的变更请求并对空间进行编辑,然后提交更改以供审核。直到有人合并该变更请求之前,这些更改不会出现在主空间中。

集合: 一组空间。你可以把集合看作是空间的文件夹。

上下文菜单: 在编辑器中高亮文本上方出现的菜单。你可以用它以多种方式格式化文本,包括加粗、斜体和代码,或为内容添加链接或注释。

评论: 一个侧边面板,可让你向页面上的任何块添加评论。你可以回复评论以创建一个 讨论,使用 @ 标记他人,并为评论添加表情符号。你还可以用表情对评论做出回应,解决不再相关的评论,并通过筛选只查看你需要的评论。

封面: 位于页面顶部的一张图片。你可以为任何页面添加封面,并将其设为横跨页面的全宽,或仅为内容宽度,作为英雄图片。请参阅 页面 了解更多。

自定义域名: 你可以为文档站点设置的自定义 URL,例如 docs.yourcompany.com。你可以在你的文档站点的 设置 面板中进行配置。请参阅 设置自定义域名 了解更多。

D

差异视图: 一种切换功能,可突出显示在变更请求中新增、编辑或删除的页面和块。你可以通过 查看更改 按钮,位于 空间页眉.

讨论: 当你回复评论时,就会创建一个讨论——实际上是在“评论”侧边面板中的一个线程式对话。

文档站点: 包含在 GitBook 编辑器中编写的信息的已发布站点。没有 GitBook 账号的用户也可以访问文档站点。

域名: 文档站点 URL 的基础部分。你可以从站点的 域名 部分进行自定义,位于你的站点 设置 页面。 设置自定义域名 将会覆盖此设置。

E

编辑器: 你登录应用后看到的 GitBook 界面。GitBook 的基于块的编辑器提供 Markdown 支持和所见即所得编辑工具,你可以在页面上添加和移动

F

文件: 你可以上传到空间中的图片、视频和其他项目。你可以通过打开内容左侧目录顶部的 文件 选项卡来查看和管理文件

G

Git 同步: Git 同步 可让你将 GitHub 或 GitLab 仓库与 GitBook 同步,并将 Markdown 文件转化为文档。这是双向同步,因此你在 GitBook 中所做的更改会出现在你的仓库中,而你直接在 GitHub 或 GitLab 中所做的更改会更新到 GitBook 中。你可以通过向你的组织添加 GitHub Sync 或 GitLab sync 集成来设置 Git Sync。了解更多

GitBook AI: 一个基于你的知识库和文档训练的 AI 助手,用于 回答问题。你可以从 提问或搜索 菜单中向 GitBook AI 询问任何关于你文档的问题。你还可以让 GitBook AI 帮助你 撰写或编辑内容 ,就在编辑器中。

I

行内面板: 输入 /在块编辑器 中间打开行内面板。它让你可以快速向块中添加不同类型的行内内容,从图片和表情符号到 Math & TeX。

插入面板: 输入 /一个空白块 以打开插入面板。它会显示你可以创建的所有可用块,包括插件和可复用内容。你可以搜索块以缩小选择范围,并使用键盘或光标进行选择。

洞察: GitBook 内置的文档站点分析工具,可让你查看已发布空间的页面浏览量、反馈和热门搜索。

集成: GitBook 集成可让你将 GitBook 空间连接到第三方服务和平台。你可以在组织中的任何空间里通过“集成”菜单安装集成。

L

实时编辑: 无需创建变更请求即可对文档的实时版本进行修改的能力。这是未发布 GitBook 空间的默认选项。

锁定实时编辑: 当你锁定实时编辑后,用户需要创建变更请求才能对 GitBook 中的文档进行修改。这有助于避免错误,并为重要文档保持良好的工作规范。你可以为任何空间锁定实时编辑——而且已发布空间会自动启用。

M

成员管理: 允许你查看和编辑组织成员的工具,包括其管理员权限以及他们可以访问的空间。

O

选项菜单: 当你点击块旁边的六个点时打开的菜单。在这里你可以更改块的外观。点击并拖动这六个点即可将块在页面上移动。

P

页面: 一个你可以使用块添加或撰写内容的地方。页面位于一个 空间内,每个页面都可以有标题和可选的图标或表情符号。

页面组: 将页面分组在一起的一种方式。你可以为每个页面组设置名称和可选的图标或表情符号。

页面选项: 你可以通过 页面选项 侧边面板为页面设置的一组选项。你可以选择布局预设,或控制单独的选项,例如隐藏页面标题和描述、目录或页面大纲。更多信息请参见 页面.

R

可复用内容: 在空间的多个位置同步的内容。当你创建 可复用内容 时,你可以根据需要将其多次添加到空间中,然后同时编辑所有这些实例。你可以通过 可复用内容 选项卡查看和管理某个空间的可复用内容,位于 目录.

S

侧边栏: GitBook 窗口最左侧的区域。它包含 提问或搜索 栏,以及你所有的文档站点、空间和集合,还有通知、集成和设置等内容。

站点部分: 如果你希望你的文档站点更像一个内容中心,你可以将多个空间作为 网站部分发布到同一个文档站点。这些站点部分会显示在已发布文档顶部的标签栏中,允许用户在内容之间切换。你可以在 结构 部分中设置站点部分 站点设置.

slug: URL 中可自定义的最后一部分,通常位于域名和一个 / 之后。在文档站点中,它会根据站点标题推断出来,并位于域名之后。如有需要,你可以在 域名 部分中设置站点部分 站点设置.

空间: 一个你可以组织相关内容的区域。它可以包含单个页面,或多个页面、子页面和页面组。

空间标题栏: 查看空间时,位于空间概览下方的菜单栏。它包含空间标题和图标,以及查看评论、失效链接和变更请求的按钮,还有该空间的 在变更请求中编辑 按钮。

空间概览: 查看空间时,GitBook 应用顶部的菜单栏。它包含你当前所在空间的面包屑导航,以及该空间的 Git 同步 配置按钮、分享按钮,以及 操作按钮 。如果其他人也在与你同时编辑这个空间,你也会在这里看到他们的头像。

子页面: 嵌套在另一页面中的页面,通常包含相关内容。

T

目录: 构成一个空间的文档页面、链接和分组的列表。你会在页面左侧、侧边栏旁边找到它。目录(TOC)还可让你访问该空间的 可复用内容文件。你可以将鼠标悬停在目录右上方附近来折叠它。

V

变体:A 变体 是文档的不同版本——例如,文档的翻译版本,或产品不同版本号的文档。站点读者可以在已发布站点上使用下拉菜单在不同变体之间切换。

版本: 在特定时间点保存的空间快照。你可以在 版本历史 菜单。

版本历史: 显示空间重大事件的菜单——例如创建日期、你已合并的任何变更请求,以及有人回滚到先前版本的任何时间。你可以点击任一版本查看该空间当时的样子,并在需要时回滚到先前版本。

最后更新于

这有帮助吗?