ApeML基本语法

ApeML程序存为fap文件，fap是纯文本文件，因此可用从记事本或其他文本编辑器创建和编辑。
ApeML文档遵循符合XML1.0的规范，因此可以使用任何支持XML规范的应用程序打开或者编辑，例如用IE即可浏览fap文件。

一、基本语法规则

1. ApeML是区分大小写的。
   
   
2. ApeML遵循XML规范，如果使用XML声明，则它必须是ApeML文档的第一行：
   <?xml version="1.0" encoding="gb2312" ?>
   XML声明不是必须的。
   
   
3. 每个ApeML文件中都只能有一个包含所有节点的ApeML根节点。
   ApeML根节点中的LID属性指定ApeML所有标签名使用的语言包。
   例如<ApeML LID="CHS" .... 指定使用简体语言包。
   
   
4. 所有元素的起始和结束标注必须成对出现。
   例如:<ApeML>.......</ApeML>
   
   
5. 元素要正确嵌套，不能交叉重叠但可能包含或被包含。
   
   
6. 空标签以<开始并以/>结束，而且可以有两种表示形式,例如：
   <数据区块/> 或者 <数据区块> </数据区块>
   
   
7. 元素属性必须用引号引起来，单、双引号都可以，但引号必须成对出现。如：
   <模拟区块 名称="Module3" 循环次数="1" 延时="0" 启用="true">
   
   
8. 可以为ApeML添加注释，注释在解析ApeML时被忽略，所以每次解析ApeML以后注释会被清除(ApeML根节点下的第一个注释会被保留)。
   如果您希望注释被永久保留可以在脚本区块中添加LAScript格式的注释。
   <!-- 注释语句放在这里面 -->
   
   
9. ApeML文档内容中的空格是有意义的，在转换后会保留。
   
   
10. 在部份属性中可以使用LAScript回调函数，属性值开始可以添加“LAScript:” 标记，这个标记是可选的(可以加也可以不加)，例如：
    
    失败="LAScript:return _CMD_LOOP "
    失败="LAScript:return fun() "
    
    
11. 脚本区块必须以" <![CDATA[ " 开始并以" ]]>"结束。并且不能在中间再次包含结束标志"]]>"。
    

    <脚本区块 语言="LAScript" 名称="init" 延时="0" 启用="true" 编辑密钥="" 运行公钥="">
    <![CDATA[
    --这里写LAScript代码
    ]]>
    </脚本区块>

    
    

二、ApeML命名规则

ApeML标签名以下划线、字母、中文字符开始；
ApeML标签名可包含字母、数字、中文字符、句点、下划线和冒号；
ApeML标签名不能包含空格；
ApeML标签名不能以数字开始，但可包含数字；
ApeML标签名区分大小写。

您可以添加自定义的语言包，通过创建 Fairy_Ape\Language\语言包ID.XML 语言包配置文件。
在语言包配置文件中指定ApeML使用的标签名字。

三、保留标记字符

如果要在ApeML中显示<或&之类的标记，就要使用字符的实体形式，ApeML中有五种预先定义了的实体：

&lt; 表示<字符
&gt; 表示>字符
&amp; 表示&字符
&apos; 表示'字符
&quot; 表示"字符

脚本区块不需要使用上面的字符实体，可以直接直接在脚本中书写<、>、&、'、"等字符