变量与表达式

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

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

如果您在内容中多次重复相同的名称、短语或版本号,您可以创建一个 表达式允许您动态显示在 以帮助保持所有这些实例同步且准确——如果您需要更新它们,或者它们很复杂且经常被错误输入,这会很有用。

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

创建新变量

要创建新变量,请在编辑打开的 变量 时点击右上角的图标 变更请求。这将打开“变量”侧边面板。

您可以使用顶部的切换来查看并创建作用域为当前页面或当前空间内所有页面的变量。

点击 创建变量 将弹出一个模态窗口,您可以在其中为变量命名并设置其值。

点击 添加变量 来保存您的变量。

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’
您可以将变量添加到单个页面或整个空间。当您更新变量的值时,该变量的每个实例都会更新。

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

在内容中使用变量

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

在页面下定义的变量可以通过 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
您可以在表达式中向内容添加变量。表达式编辑器提供自动完成选项,帮助您找到所需的变量。

更新变量

在变更请求中,您可以随时更新变量。更新其值将更新任何引用该变量的表达式块中的值。一旦变更请求合并,更改的变量将对任何已发布的网站生效。

最后更新于

这有帮助吗?