.. SPDX-License-Identifier: GFDL-1.3-or-later

开始使用
========

FreeKill自带fkp模块。

编译运行示例文件
----------------

（请无视这一节内容，过时了）

首先打开fkparse_qt.exe，看到如下界面（补个插图）

然后先点击Choose
File...，选择example文件夹下面的example.txt，然后点击Compile按钮进行编译。如果编译出错，错误将出现在下方，否则下面会告诉你编译成功了。

编译成功后点击一下Pack按钮，程序就会自动整合所有素材，然后在输入的txt的所在文件夹下面生成一个新的文件夹。将新文件夹下面的四个文件夹直接复制到太阳神三国杀的根目录下面，然后启动神杀即可。

至此，你已经知道如何使用fkparse了，接下来说明example.txt这种文件所要求的语法格式。

编写自己的第一个拓展文件
------------------------

首先，新建一个文本文件，就起名为study.txt吧。在之后的部分都将基于这个文件进行操作。打开study.txt，用记事本或者代码编辑器之类的东西都可。

创建拓展包
~~~~~~~~~~

TODO！

| 拓展文件首先要从创建拓展包开始。fkparse中创建拓展包的格式为：
| *拓展包 <标识符>*
| “标识符”就是用单引号括起来的文本，毕竟中文不用空格进行分词。一个拓展文件中可以含有多个拓展包，下面我们来创建两个空拓展包：

::

    拓展包 '学习包1'
    拓展包 '学习包2'

保存，然后用它去生成study.lua。将study.lua放入extensions里面，你应该能在游戏中看到这两个拓展包了。

创建武将
~~~~~~~~

创建武将的详细的内容在下一章说明。这里我们只是简单的新建一个武将而已。

现在我们要创建一个武将，它所属于学习包1，名字是猪八戒，称号是净坛使者，神势力，24体力。那么我们现在在“拓展包
’学习包1’”下面另起一个新行，然后输入：

::

    # 神 "净坛使者" '猪八戒' 24 []

这一段话的详细内容下一章再细说。现在保存文件，然后重新生成lua。现在你的study.txt的内容应该是像这样：

::

   拓展包 '学习包1'
   # 神 "净坛使者" '猪八戒' 24 []
   拓展包 '学习包2'

错误处理
--------

如果编译出错，错误信息将显示在窗口内部。请根据报错信息仔细检查出错或者咨询作者吧。