岁寒配置文件的使用方法

由于现在岁寒输入法增加了许多可配置的项目，为了减少配置文件的数量，同时也方便用户创造和分享自己的方案，岁寒新增了统一的配置文件格式，后缀名为.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)或[]，[]表示为空

十二宫格键位布局=
a、wor、e
u、i、v
jhl、bnd、xgy
qzp、fck、tsm

#注意：布局文件仅能改变键位的键值，并不能用于改变键位的功能分区，了解岁寒输入法十二宫格键盘的功能分区请参见以下链接：https://www.jianshu.com/p/5dbf43cbf9f8
#请遵守以下规则对布局进行修改，如违反，布局文件将无法通过验证：
#1.保持4行3列的格式；
#2.每一个键位值仅接收一个或者三个小写的英文字母；一个字母时，该字母为中心键值；三个字母时，第一个字母为左键值，第二个字母为中心键值，第三个字母为右键值；
#3.键值不得重复,亦不可缺失；
#4.不可将韵母放置在声母区

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

qwerty布局提示=
q/iu、w/ia/ua、/e、r/uan、t/ue/ve、y/ing/uai、sh/u、ch/i、/o/uo、p/un
/a、s/iong/ong、d/iang/uang、f/en、g/eng、h/ang、j/an、k/ao、l/ai、[]
[]、z/ei、x/ie、c/iao、zh/ui/v、b/ou、n/in、m/ian、[]、[]

#qwerty键盘提示的格式为3行10列；
#项与项之间用“、”；
#每一项可包含最多三行内容，内容之间用“/”分隔，如“a/an/ang”
#无内容可用[]表示

前置路径=
#当前无前置路径的设置信息；
#前置路径的格式类似于：a0=ai
#更多关于前置路径的设置信息请参考以下教程：https://www.jianshu.com/p/302e3bd53ed2
y222=yao

十二宫格前置路径=
#当前无十二宫格前置路径的设置信息；
#十二宫格前置路径的格式类似于：a0=ai
#注意，与26键布局下的前置路径不同的是，十二宫格前置路径的路径表示法中，锚点取中心键位的键值；即当一个键位存在三个键值时，取中间的键值来表示路径的锚点。
#更多关于前置路径的设置信息请参考以下教程：https://www.jianshu.com/p/302e3bd53ed2

左浮出子键盘=
“ ！ :/::
《 ， @
#注意：
#1. 左浮出子键盘的布局2行3列；
#2. 每个位置上可设置的字符串可有任意长度，但不能包含空格，因为字符串与字符串之间使用空格分隔；
#3. 第2行第2列为中心符号，固定为“，”,不可更改；
#4. 当设置的符号串长度大于1时，输入界面会只显示第一个字符，但输入时会输入实际的设置；


右浮出子键盘=
； ？ ”
、 。 》
#注意：
#1. 右浮出子键盘的布局2行3列；
#2. 每个位置上可设置的字符串可有任意长度，但不能包含空格，因为字符串与字符串之间使用空格分隔；
#3. 第2行第2列为中心符号，固定为“。”,不可更改；
#4. 当设置的符号串长度大于1时，输入界面会只显示第一个字符，但输入时会输入实际的设置；



十二宫格符号键盘=
， 。
“ ”
！ ？
： ；
《 》
@ 、
#注意：
#1. 十二宫格符号键盘的布局6行2列；
#2. 每个位置上可设置的字符串可有任意长度，但不能包含空格，因为字符串与字符串之间使用空格分隔；
#3. 当设置的符号串长度大于1时，输入界面会只显示第一个字符，但输入时会输入实际的设置；


小写英文键盘的符号=
1 2 3 4 5 6 7 8 9 0
@ * + - = / # () )
' ; " ? ! ~ …
#注意：
#1. 小写英文键盘的符号的布局为3行，第一行为10个字符串，第2行为9个字符串，第3行为7个字符串；
#2. 每个位置上可设置的字符串可有任意长度，但不能包含空格，因为字符串与字符串之间使用空格分隔；
#3. 当设置的符号串长度大于1时，输入界面会只显示第一个字符，但输入时会输入实际的设置；


大写英文键盘的符号=
1 2 3 4 5 6 7 8 9 0
@ * + - = / # ( )
' ; " ? ! ~ …
#注意：
#1. 大写英文键盘的符号的布局为3行，第一行为10个字符串，第2行为9个字符串，第3行为7个字符串；
#2. 每个位置上可设置的字符串可有任意长度，但不能包含空格，因为字符串与字符串之间使用空格分隔；
#3. 当设置的符号串长度大于1时，输入界面会只显示第一个字符，但输入时会输入实际的设置；

2.1 键位布局配置区

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

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

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

保持4行7列的格式；
每一个键位值仅接收一个小写的英文字母或[]，[]表示为空，且仅限于左下角和右下角两个键位使用；
除空键值外，其他键值不得重复；
不可将z、c、s键放置在第一行之下的位置；
不可将韵母放置在声母区，反之亦然；

2.2 韵母键族配置区

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

韵母键族配置区的内容应满足如下的要求：

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

注意：由于旧的文件格式没有引入#注释符，用户在导出的岁寒配置文件可能会发现键位布局配置区和韵母键族配置区的内容中的注释信息不以#符号开头，这不影响键位布局配置区和韵母键族配置区的内容的功能。但前置路径不是如此，前置路径配置区中的注释必须以#开头，否则将出错。

2.3 十二宫格键位布局配置区

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

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

内容的前四行即为键位布局的内容，剩余的部分将被忽略，不影响布局文件的读取。布局文件仅能改变键位的键值，并不能用于改变键位的功能分区，了解岁寒输入法十二宫格键盘的功能分区请参见以下链接：https://www.jianshu.com/p/5dbf43cbf9f8
请遵守以下规则对布局进行修改，如违反，布局文件将无法通过验证：
1.保持4行3列的格式；
2.每一个键位值仅接收一个或者三个小写的英文字母；一个字母时，该字母为中心键值；三个字母时，第一个字母为左键值，第二个字母为中心键值，第三个字母为右键值；
3.键值不得重复,亦不可缺失；
4.不可将韵母放置在声母区，且韵母只能作为中心键值；

2.4 十二宫格韵母键族配置区

十二宫格韵母键族配置区的内容以十二宫格韵母键族=、十二宫格韵母布局=、12宫格韵母键族=或12宫格韵母布局=一行的下一行为开始，到下一个配置区声明行的上一行或者文件尾为结束。

十二宫格韵母键族配置区的内容应满足如下的要求：

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

2.5 qwerty布局提示配置区

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

qwerty布局提示配置区的内容应满足如下的要求：

qwerty键盘提示的格式为3行10列；
项与项之间用“、”；
每一项可包含最多三行内容，内容之间用“/”分隔，如“a/an/ang”，允许空行，比如“/a/”、“//a”、“a//”
无内容可用[]表示;

前文给出的配置实例效果如下：

2.6 前置路径配置区

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

关于前置路径的设置方法，请参考下述两个教程：

2.7 十二宫格前置路径配置区

该配置区的配置方法同前置路径配置区

2.8 左浮出子键盘配置区

左浮出子键盘配置区的内容以左浮出子键盘=一行的下一个为开始，到下一个配置区声明行的上一行或者文件尾为结束。

该配置区主要配置在中文输入界面按下逗号键时浮出的子键盘上的符号；

左浮出子键盘配置区的内容应满足如下的要求：

左浮出子键盘的布局2行3列；
每个位置上可设置的字符串可有任意长度，但不能包含空格，因为字符串与字符串之间使用空格分隔；
第2行第2列为中心符号，固定为“，”,不可更改；
当设置的符号串长度大于1时，输入界面会只显示第一个字符，但输入时会输入实际的设置；

2.9 右浮出子键盘配置区

该配置区的配置方法同左浮出子键盘配置区
唯一不同的是中心符号为“。”

2.10 十二宫格符号键盘配置区

十二宫格符号键盘配置区的内容以十二宫格符号键盘=一行的下一个为开始，到下一个配置区声明行的上一行或者文件尾为结束。

该配置区主要配置十二宫格布局的左侧符号键盘的内容；

十二宫格符号键盘配置区的内容应满足如下的要求：

十二宫格符号键盘的布局6行2列；
每个位置上可设置的字符串可有任意长度，但不能包含空格，因为字符串与字符串之间使用空格分隔；
当设置的符号串长度大于1时，输入界面会只显示第一个字符，但输入时会输入实际的设置；

2.11 小写英文键盘的符号配置区

小写英文键盘的符号配置区的内容以小写英文键盘的符号=一行的下一个为开始，到下一个配置区声明行的上一行或者文件尾为结束。

该配置区主要配置在英文键盘为小写状态时各个键位上的下滑输入符号；

小写英文键盘的符号的内容应满足如下的要求：

小写英文键盘的符号的布局为3行，第一行为10个字符串，第2行为9个字符串，第3行为7个字符串；
每个位置上可设置的字符串可有任意长度，但不能包含空格，因为字符串与字符串之间使用空格分隔；
当设置的符号串长度大于1时，输入界面会只显示第一个字符，但输入时会输入实际的设置；

2.12 大写英文键盘的符号配置区

该配置区的配置方法同小写英文键盘的符号配置区

3. 如何导出岁寒配置文件

前往输入设置，点击导出岁寒配置文件；

即可导出岁寒配置文件，点击前往查看；

可见该文件已在文件空间中。

如何导入岁寒配置文件

在文件空间中点击配置文件，进入操作选择界面，点击导入该文件，则完成导出；

IMG_3652.png

或点击编辑内容，编辑完成后，点击保存，程序将验证配置的有效性，如有错误则报错，如无错误，则自动导入。

战略合作伙伴：落格输入法 X