FIS3 开源项目使用教程

1. 项目的目录结构及介绍

FIS3 是一个面向前端开发的工程构建系统，旨在解决前端工程中的性能优化、资源加载、模块化开发、自动化工具、开发规范和代码部署等问题。项目的主要目录结构如下：

• bin/: 存放命令行工具的脚本文件。
• doc/: 包含项目的文档，详细介绍了使用方法、配置和插件开发等。
• lib/: 核心代码库，包含了FIS3的主要逻辑。
• test/: 测试用例和测试代码，用于确保FIS3的稳定性和功能完整性。
• .editorconfig: 编辑器配置文件，用于统一开发者的代码风格。
• .gitignore: Git忽略文件，指定Git应该忽略的文件和目录。
• .jsdoc.json: JSDoc配置文件，用于生成API文档。
• .npmignore: NPM忽略文件，指定发布到NPM时应该忽略的文件和目录。
• CHANGELOG.md: 更新日志文件，记录了项目的版本更新和变更历史。
• ISSUE_TEMPLATE: Issue模板文件，用于指导用户如何提交问题和请求。
• LICENSE: 许可证文件，本项目采用BSD-2-Clause协议。
• Makefile: Makefile文件，用于构建和编译项目。
• README.md: 项目说明文件，包含了项目的基本信息和快速入门指南。
• index.js: FIS3的入口文件，启动FIS3的核心逻辑。
• package.json: 项目依赖管理和元数据文件。
• pub.sh: 发布脚本，用于将项目发布到特定的环境。
• release-doc.sh: 发布文档的脚本。

2. 项目的启动文件介绍

项目的启动文件是bin/fis3.js，这是通过命令行启动FIS3的主要脚本。当你通过命令行执行fis3命令时，实际上就是在调用这个脚本。脚本会解析命令行参数，并根据这些参数执行相应的操作，如启动本地服务器、执行构建任务等。

3. 项目的配置文件介绍

FIS3的配置文件通常是fis-conf.js，它位于项目根目录下。这个文件是JavaScript格式，用于定义FIS3的行为和设置。以下是fis-conf.js的一个基础配置示例：

// default settings. fis3 release
// Global start
fis
  .match
  (
    '*.{js,css}',
    {
      useHash: true
    }
  );
fis
  .match
  (
    '::image',
    {
      useHash: true
    }
  );
fis
  .match
  (
    '*.js',
    {
      optimizer: fis.plugin('uglify-js') // js 压缩
    }
  );
fis
  .match
  (
    '*.css',
    {
      optimizer: fis.plugin('clean-css') // css 压缩
    }
  );
fis
  .match
  (
    '*.png',
    {
      optimizer: fis.plugin('png-compressor') // png 图片压缩
    }
  );
// Global end

// default media is `dev`
fis
  .media
  (
    'dev'
  )
  .match
  (
    '*',
    {
      useHash: false,
      optimizer: null
    }
  );

// extends GLOBAL config
fis
  .media
  (
    'production'
  );

在配置文件中，你可以定义各种文件的处理规则，包括文件的后缀名、路径等，以及使用的插件和优化选项。通过不同的match函数，可以为不同类型的文件指定不同的处理策略。