icons变量和表达式

创建可重复使用的变量,可在页面和空间中引用

使用变量,你可以创建可重复使用的文本,这些文本可以在 表达式自适应内容的条件中.

如果你在内容中多次重复相同的名称、短语或版本号,你可以创建一个 变量 来帮助保持所有这些实例同步且准确——如果你以后需要更新它们,或者它们很复杂且经常被误输入,这就很有用。

你可以创建作用域限定为单个页面或单个空间的变量。

创建新变量

要创建新变量,请点击 在编辑一个打开的 变更请求时目录中的。然后,点击 变量.

你可以使用顶部的切换来查看和创建变量,其作用域可以是你当前所在的页面,也可以是当前空间中的所有页面。

点击 创建变量 会打开一个模态窗口,你可以在其中为变量命名并设置值。

点击 添加变量 以保存你的变量。

A GitBook screenshot showing the Add variables screen. The variable Name box has been filled with the text ‘latest_version’ and the Value box has been filled with the text ‘v3.04.1’
你可以将变量添加到单个页面或整个空间中。当你更新变量的值时,它的每个实例都会更新。
circle-info

变量名称必须以字母开头,并且可以包含字母、数字和下划线。

在内容中使用变量

变量可以在一个 表达式 中被引用和使用——你可以将其内联插入到内容中。插入表达式后,双击它以打开表达式编辑器。

circle-info

表达式只能用于文档的页面内容中。它们不能用于页面标题或页面元数据。

在你的页面下定义的变量可通过 page.vars 对象访问。同样,在整个空间中定义的变量可通过 space.vars 对象访问。

A GitBook screenshot showing an expression block within the editor. The expression editor is open below it and the ‘space.vars.latest_version’ variable has been selected
你可以在表达式中向内容添加变量。表达式编辑器提供自动完成选项,帮助你找到所需的变量。

更新变量

你可以在变更请求中的任何时候更新变量。更新其值会同步更新引用它的所有表达式块中的值。该已更改的变量在变更请求合并后会对任何已发布站点生效。

最后更新于

这有帮助吗?