KityMinder Editor 教程

1. 项目目录结构及介绍

KityMinder Editor 的目录结构如下：

.
├── dist                 # 打包后的发布文件
│   └── index.html       # 生产环境入口文件
├── less                 # 样式源码
├── server               # 本地服务器相关脚本
└── src                  # 项目源码
    ├── ui                # 用户界面相关代码
    │   └── ...
    ├── directives        # 自定义指令
    │   └── topTab        # 示例：顶部标签指令
    ├── app.js            # 主应用文件
    └── ...                # 更多源码文件

其中，src 目录包含了主要的项目代码，dist 目录是编译打包后用于部署的文件。

2. 项目启动文件介绍

index.html

位于根目录的 index.html 文件是开发环境的入口文件，引入了必要的 CSS、JavaScript 文件以及 AngularJS 环境，用于快速启动 KityMinder Editor 的开发环境。

另一个 dist/index.html 文件则是在执行构建命令（grunt build）后生成的，它包含了最终打包的所有资源，适用于线上环境。

Gruntfile.js

Gruntfile.js 是 Grunt 构建工具的配置文件，它定义了不同任务，如 grunt dev（启动开发服务器）和 grunt build（生成生产环境代码）。通过这些任务，你可以管理项目生命周期，包括代码编译、压缩、合并等。

3. 项目配置文件介绍

KityMinder Editor 的配置主要是通过 AngularJS 的 Provider 实现，例如在 app.js 中可以自定义配置。这里有一个例子来说明如何配置：

angular.module('kityminderDemo', ['kityminderEditor'])
.config(function(configProvider) {
  configProvider.set('imageUpload', 'path/to/image/upload/handler');
});

这段代码展示了如何配置图片上传处理器。configProvider.set 方法用来设置配置项，键（key）是 'imageUpload'，值（value）是你提供的图片上传处理路径。

此外，项目中的 package.json 和 bower.json 文件分别用于 Node.js 库管理和前端组件依赖管理，它们不直接影响运行时的行为，但对项目的构建过程至关重要。

注意，要正确运行项目，还需要确保已安装 nodejs, npm, bower 和 grunt，并初始化项目依赖（npm run init），然后通过执行 grunt dev 或 grunt build 来启动开发环境或构建生产环境的代码。