jQTouch 项目教程

1. 项目目录结构及介绍

jQTouch 项目的目录结构如下：

jQTouch/
├── demos/
├── extensions/
├── lib/
│   └── jquery/
├── src/
├── submodules/
├── test/
├── themes/
├── .gitignore
├── .gitmodules
├── .npmignore
├── .travis.yml
├── Gruntfile.coffee
├── LICENSE.txt
├── README.md
├── VERSIONS.md
└── package.json

目录介绍：

• demos/: 包含项目的演示文件，展示了 jQTouch 的基本功能和用法。
• extensions/: 包含项目的扩展文件，提供了额外的功能和插件。
• lib/jquery/: 包含 jQuery 库文件，jQTouch 可以与 jQuery 或 Zepto.js 一起使用。
• src/: 包含项目的源代码文件，包括核心 JavaScript 文件。
• submodules/: 包含项目的子模块文件，通常用于依赖管理。
• test/: 包含项目的测试文件，用于测试 jQTouch 的功能和稳定性。
• themes/: 包含项目的主题文件，提供了不同的样式和主题。
• .gitignore: Git 忽略文件，指定哪些文件和目录不需要被 Git 管理。
• .gitmodules: Git 子模块配置文件，用于管理项目的子模块。
• .npmignore: npm 忽略文件，指定哪些文件和目录不需要被 npm 管理。
• .travis.yml: Travis CI 配置文件，用于持续集成和自动化测试。
• Gruntfile.coffee: Grunt 构建工具的配置文件，用于自动化构建和打包项目。
• LICENSE.txt: 项目的开源许可证文件，通常为 MIT 许可证。
• README.md: 项目的说明文件，包含项目的介绍、安装和使用说明。
• VERSIONS.md: 项目的版本记录文件，记录了项目的版本更新和变更。
• package.json: npm 包配置文件，包含了项目的依赖和脚本配置。

2. 项目启动文件介绍

jQTouch 项目的启动文件是 demos/index.html。这个文件是一个演示页面，展示了 jQTouch 的基本功能和用法。你可以通过打开这个文件来预览 jQTouch 的效果。

启动步骤：

1. 下载 jQTouch 项目代码。
2. 解压下载的文件。
3. 打开 demos/index.html 文件，使用支持 WebKit 的浏览器（如 Chrome 或 Safari）进行预览。

3. 项目配置文件介绍

jQTouch 项目的主要配置文件是 Gruntfile.coffee 和 package.json。

Gruntfile.coffee

Gruntfile.coffee 是 Grunt 构建工具的配置文件，用于自动化构建和打包项目。它包含了以下主要任务：

• grunt (default): 默认任务，用于创建 jQTouch 的构建版本，编译主题文件并更新 Zepto 子模块。
• grunt build: 用于迭代开发的任务，不会更新子模块或清理构建。
• grunt watch: 监视文件变化的任务，当主题或源文件发生变化时，自动编译并复制到构建目录。
• grunt compass: 仅构建主题文件的任务，通常用于开发自定义主题。
• grunt test: 运行测试套件的任务，用于测试 jQTouch 的功能和稳定性。
• grunt dist: 用于创建发布版本的任务，会压缩 JS/CSS 文件并更新演示文件的路径。

package.json

package.json 是 npm 包配置文件，包含了项目的依赖和脚本配置。它定义了项目的基本信息、依赖包和脚本命令。

配置步骤：

1. 安装 Node.js 和 npm。
2. 在项目根目录下运行 npm install 安装项目依赖。
3. 根据需要运行 Grunt 任务，如 grunt 或 grunt watch。

通过以上步骤，你可以轻松地配置和启动 jQTouch 项目，并进行开发和测试。