README

通过面板管理语言变量的Kirby字段。为此，它使用kirby-variables将这些变量放入YAML文件中，以便于操作。

⚠ 已弃用

通过将变量放入单独的文件并不同其他字段管理，您获得的收益很小。直接使用文本字段会更容易。有关详细信息，请查看已弃用的oblik/kirby-variables包。

composer require oblik/kirby-variables-field

在蓝图文件中，只需添加一个新的字段并将类型设置为variables

fields:
  vars:
    type: variables
    label: Variables

这将为所有变量创建一个编辑器，您可以在其中添加、删除和排序它们。

注意：这是一个“虚拟”字段，实际上不会在站点/页面txt文件中保存任何值。所有值都保存在变量所在的YAML文件中，所以选择什么字段名称都无关紧要。

您可以指定要编辑的确切变量。例如，如果您在bg.yml中这样设置

test: Тест
greetings:
  hello: Здравей

...并在您的蓝图文件中这样设置

myfield:
  type: variables
  variable: greetings.hello
  label: Hello

...您将得到以下结果

在上面的例子中，如果您想允许编辑器在greetings组中添加新条目，您只需将

variable: greetings.hello

...更改为

variable: greetings

这将显示变量编辑器。

当您没有设置要编辑的特定变量并且显示编辑器时，您可以配置它

myfield:
  type: variables
  editor:
    sort: false
    mutate: false

此插件使用由依赖项kirby-json提供的Vue组件JSON编辑器。有关其蓝图选项的详细信息，请参阅此处。

此插件还附带了一个名为var的KirbyTag。它简单地输出一个变量，并提供一个后备默认值。例如，在en.yml

labels:
  test: Test

在您的内容中

This is the label (var: labels.test default: Default Value)

结果

This is the label Test

这对于编辑器来说非常有用，因为现在他们可以在面板中设置和使用变量，这为他们提供了在内容中避免重复的机会。