跳到主要内容

YAML语法

这是你使用插件前，需要了解的一些知识！YAML写成的文件即为yml文件！本文使用通俗语言解释，仅供小白了解基础知识

一、基本语法​

k: v表示一组键值对（k: 的后面要有一个空格，切记切记）; 以空格的缩进来控制层级关系；只要是左对齐的同一列数据，都是同一个层级的

#这是一个示例
k: 
  options: 
    startX: "w*0"
    startY: "h*0"
  picture:
    type: 0
    enable: true

在上面这个例子中，就含有三个层级，k: 是第一层级，options: 与picture: 是第二层级，startX: 与startY: 与type: 与enable: 是第三层级

在本插件中，层级关系有着严格的要求，一般来说，插件内每个层级之间的缩进关系为两个空格，请在编写以及粘贴配置时严格检查层级关系是否一致

二、值的写法​

1、字面量：普通的值（数值，字符串，布尔值)​

k: v
# 字符串默认不用加上单引号或者双引号
""：双引号；会转义字符串里面的特殊字符；特殊字符会作为本身想表示的意思
#  例如 \n 代表换行
　　name: "GermMC\nTeaman"  
#   这样会输出:
#   GermMC
#   Teaman
''：单引号；不会转义特殊字符，特殊字符最终只是一个普通的字符串数据
　　name: 'GermMC\nTeaman'  
#   这样会输出:
#   GermMC\nTeaman

在本插件中单引号与双引号有着严格意义上的区别，请对照wiki内内容进行填写，不可出错！

2、数组：​

#这是一个示例
animations: 
  - "default_move"
  - "default_scale"
  - "custom_move"
  - "custom_scale"

在上面这个示例中表示的是yaml的数组，您可以不必知道数组是是什么，

key: 
  - value1
  - value2
  - value3

但是请记住他的格式，层级之间的缩进仍然是两个空格。

三、特别提示​

在本插件内你会在配置的注释里看到这样的字眼

    #该动画选项会使得整个GUI界面按照预设动画做出移动(可删除)
    animations:
      - "default_move"

(可删除)意味着你可以删除这个k: v键值对，删除时需要将k与v表示的内容一并删除！