基本配置 #

工程描述信息 #

project:
  name: ebuild-example                          # 工程名
  version: "1.0"                                # 工程版本
  description: 这是由ebuild创建的示例工程。       # 工程的描述信息    
  author: SalHe                                 # 工程作者
  repository: https://github.com/SalHe/ebuild   # 工程的源码仓库地址
  homepage: https://github.com/SalHe            # 工程主页

您可以在ebuild.yaml中看到上述的内容，在project之下有若干用于描述工程的信息，他们对工程没有任何影响，仅仅是用于描述工程，方便了解工程的信息。

管理源码 #

在ebuild中，并不是所有源码都会参与e2txt、txt2e、编译等的过程，只有那些按照约定包含(includes)进来但又没有被排除掉的文件(excludes)的文件才能参与这些过程。

被管理的源文件 #

project:
  # ......
includes:
  - '**/*.e'

在includes节点中，您可以配置多种文件名匹配模式来选择你需要被纳入控制的源码。在上述配置中，要求工程管理所有目录(**/)下的易语言源文件(*.e)。

排除的源文件 #

有时候，您希望在工程中排除一些源文件，使他们不纳入ebuild的控制——既不参与e2txt也不参与编译。那么您可以配置excludes。

project:
  # ......
excludes:
  - '**/*.recover.e'
  - '**/*.ecode/*.e'
  - '**/*.代码/*.e'

上述代码中，排除了三种模式的文件，比如XXX.recover.e被排除掉了。

excludes的优先级是高于includes的，即：纵使includes中包含了XXX.recover.e，他也不会被纳入ebuild的控制。

仅在构建中排除源文件 #

project:
  # ......
exclude-builds:
  - './scripts/**/*.e' # 脚本文件不纳入'ebuild build'命令中进行自动构建

与excludes不同，有些源文件您希望参与e2txt，但不希望他作为编译目标——作为脚本的易语言源文件便是一个例子，上述配置使得scripts目录下的所有易语言源文件*.e都不参与编译，但是他们仍然参与e2txt。

exclude-builds的优先级高于includes，低于excludes，即：倘若excludes排除了指定源文件，即便该配置中未排除那个文件，该文件最终仍然被排除（既不参与e2txt也不参与编译）。