可重用内容

创建可跨空间使用的可重用内容区块，当您更改某个实例时可一次性更新全部

可重用内容可让您在多个页面和空间之间同步内容，因此您可以同时编辑该块的所有实例。

在空间内创建可重用内容。

基础知识

可重用内容的工作方式与其他内容相同——您可以通过更改请求修改它，将其包含在审核工作流中，并且它将在任何已发布站点上正确呈现。

虽然可重用内容可以在多个空间中被引用，但它属于单个 父空间.

“父空间”概念

父空间是拥有可重用内容的空间。它是唯一可以编辑该内容的位置。

尽管对可重用内容的更新会立即出现在所有实例中，但所有更改必须来源于父空间——无论是作为直接编辑还是通过更改请求。

空间是 GitBook 的核心概念，支持编辑工作流和安全性。由于 GitBook 强制基于权限的编辑，可重用内容只能从其父空间更改。这确保了即使内容在组织中重复使用，也能尊重编辑权限。

已知限制

集成

由集成提供的块在可重用内容中不受支持。这是因为 GitBook 中的集成是按空间安装的，限制访问可确保第三方集成仅具有您授予的权限。在空间间引用可重用内容会破坏此安全边界。

搜索

目前，可重用内容仅在其父空间内出现在搜索结果中。我们正在积极努力移除此限制，以便可重用内容在其被引用的任何地方都能出现在搜索结果中。

在应用中

创建可重用内容

要创建可重用内容， 选择一个或多个块，然后打开 操作菜单 ，选择 转换为，并选择 可重用内容。您还可以为块命名，以便以后更容易找到和复用。

或者，您可以选择一个或多个块，然后按下 Cmd + C 以打开提示，询问您是否要创建可重用内容。

插入可重用内容

您可以像使用任何其他块一样插入可重用内容。按 / 在空行上以打开 插入面板 并按名称搜索您的内容或直接搜索“reusable”。或者，点击任何块或空行左侧的 + 。

您还可以在页面侧边栏中找到可重用内容面板，在那里可以查看当前空间中先前创建的内容块列表。

编辑可重用内容

可重用内容就像其他内容一样——如果 实时编辑 已启用，您可以直接编辑任何实例，或者通过 更改请求 如果未启用。您所做的任何更改都会在内容使用的所有地方同步。

如果您在更改请求中进行更改，一旦该更改请求合并，内容将同步到所有其他实例。

分离可重用内容

您可以通过打开 操作菜单 并选择来删除集合 分离来分离可重用内容。分离将把内容转换回常规块。

一旦分离，您对该块（或这些块）所做的任何更改将不会反映到其他实例中，您在那些实例中所做的更改也不会反映到已分离的块（或这些块）中。可重用内容的所有其他实例仍会相互同步。

删除可重用内容

如果需要，您可以将可重用内容从您的空间中完全删除。在页面目录中找到可重用内容，然后打开 操作菜单 位于您要删除的内容旁边的 删除.

选择 删除可重用内容将从其使用的所有页面中删除它

。此操作无法撤销。

与 GitHub 和 GitLab 的同步 将可重用内容同步到 GitHub 和 GitLab 时，完全受支持。您的可重用内容将被导出到一个专用的 includes

文件夹，每个内容为一个单独的 Markdown 文件。 将可重用内容同步到 GitHub 和 GitLab 时，完全受支持。您的可重用内容将被导出到一个专用的 然后在其他页面中使用

指令来引用您的内容。 在同步时， .gitbook/includes 在同步时， 目录会在每个同步空间的根目录中创建（这可能不是整个仓库的根目录）。如果您的

示例

文件夹或其文件出现在您空间的目录中，您可能需要手动将它们从目录中隐藏。

如果您在 GitHub 端编写，请确保包含路径是相对于包含引用的文件的路径（而不是仓库根目录）。