岁寒配置文件的使用方法

2019-01-23 本文已影响241人临岁之寒

由于现在岁寒输入法增加了三种可配置的布局元素：键位布局、韵母键族布局和前置路径，为了减少配置文件的数量，同时也方便用户创造和分享自己的方案，岁寒新增了统一的配置文件格式，后缀名为.shpz。旧有布局文件（.bj/.ybj）依然可以导入，但新版本将不再支持这些文件格式的导出，而是统一导出为岁寒配置文件，因为岁寒配置文件已经囊括他们所能提供的配置信息。

1.注释的格式

凡是以#开头的行，该行的内容都将被视为注释信息，在导入时会被忽略，作者可以使用注释向使用者解释自己的设计意图。

2.配置区的格式

目前岁寒输入法有三种可配置元素：键位布局、韵母键族和前置路径。因此用户可以至多声明三个配置区，格式为：配置元素的名称+“=”，形式如下：

#注释行请以#开头；

键位布局=
w、z、u、i、v、c、s
q、y、a、o、e、r、p
j、f、g、h、d、k、l
[]、t、x、b、n、m、[]
#注意：该文件前四行即为布局文件的内容，剩余的部分将被忽略，不影响布局文件的读取，作者如需备注信息，可写于此处；
#注意：布局文件仅能改变键位的键值，并不能用于改变键位的功能分区，了解岁寒输入法键盘的功能分区请参见以下链接：https://www.jianshu.com/p/5bb842a9c866
#请遵守以下规则对布局进行修改，如违反，布局文件将无法通过验证：
#1.保持4行7列的格式；
#2.每一个键位值仅接收一个小写的英文字母或[]，[]表示为空，且仅限于左下角和右下角两个键位使用；
#3.除空键值外，其他键值不得重复；
#4.不可将z、c、s键放置在第一行之下的位置；
#5.不可将韵母放置在声母区，反之亦然；

韵母键族=
e、o、[]、[]、u、o、a
i、u、[]、[]、[]、a、i
i、u、a、o、e、i、u
i、u、a、o、e、i、u
e、e、i、u、a、a、e
#注意：该文件前五行即为韵母键族布局文件的内容，剩余的部分将被忽略，不影响布局文件的读取，作者如需备注信息，可写于此处；
#请遵守以下规则对布局进行修改，如违反，布局文件将无法通过验证：
#1.保持5行7列的格式；
#2.每一个键位值仅接收一个小写的韵母字母(a/o/e/i/u)或[]，[]表示为空

前置路径=
#前置路径的格式类似于：a0=ai
#更多关于前置路径的设置信息请参考以下教程：
y222=yao

2.1 键位布局配置区

键位布局配置区的内容以键位布局=一行的下一行为开始，到下一个配置区声明行的上一行或者文件尾为结束。

键位布局配置区的内容要满足下述要求：

内容的前四行即为键位布局的内容，剩余的部分将被忽略，不影响布局文件的读取，作者如需备注信息，可写于此处；
注意：布局文件仅能改变键位的键值，并不能用于改变键位的功能分区，了解岁寒输入法键盘的功能分区请参见以下链接：https://www.jianshu.com/p/5bb842a9c866
请遵守以下规则对布局进行修改，如违反，布局文件将无法通过验证：