Gulp 文档中文翻译说明

本项目中包含了 gulp 官方文档的中文翻译。目前已完成全部文档的翻译。

已翻译文档

已完成翻译的文档包括：

1. 基础文档

   • CLI.md - 命令行接口
   • FAQ.md - 常见问题
   • documentation-missing.md - 文档缺失页面
   • getting-started.md - 入门指南
   • README.md - 主目录

2. 入门指南

   • 快速入门
   • JavaScript 和 Gulpfiles
   • 创建任务
   • 异步完成
   • 处理文件
   • Glob 详解
   • 使用插件
   • 监视文件

3. API

   • README.md - API 目录
   • src() - src() 函数
   • dest() - dest() 函数
   • symlink() - symlink() 函数
   • lastRun() - lastRun() 函数
   • series() - series() 函数
   • parallel() - parallel() 函数
   • watch() - watch() 函数
   • task() - task() 函数
   • registry() - registry() 函数
   • tree() - tree() 函数
   • Vinyl - Vinyl 类
   • Vinyl.isVinyl() - Vinyl.isVinyl() 函数
   • Vinyl.isCustomProp() - Vinyl.isCustomProp() 函数

4. 编写插件

   • README.md - 编写插件介绍
   • guidelines.md - 插件编写指南
   • using-buffers.md - 使用缓冲区
   • dealing-with-streams.md - 处理流
   • testing.md - 测试
   • recommended-modules.md - 推荐模块

5. 高级

   • creating-custom-registries.md - 创建自定义注册表

6. 其他文档

   • why-use-pump/README.md - 为什么使用 Pump
   • support/for-enterprise.md - 企业版支持
   • recipes/README.md - 秘籍目录
   • recipes/automate-releases.md - 自动化发布
   • recipes/combining-streams-to-handle-errors.md - 合并流来处理错误
   • recipes/cron-task.md - 通过 cron 作业运行 gulp 任务
   • recipes/delete-files-folder.md - 删除文件和文件夹
   • recipes/minified-and-non-minified.md - 输出压缩和非压缩版本
   • recipes/pass-arguments-from-cli.md - 从命令行传递参数
   • recipes/mocha-test-runner-with-gulp.md - 使用 gulp 的 Mocha 测试运行器
   • recipes/using-multiple-sources-in-one-task.md - 在一个任务中使用多个源
   • recipes/templating-with-swig-and-yaml-front-matter.md - 使用 Swig 和 YAML front-matter 的模板
   • recipes/browserify-transforms.md - Browserify + 转换
   • recipes/browserify-uglify-sourcemap.md - Browserify + Uglify2 带源映射
   • recipes/browserify-multiple-destination.md - Browserify + Globs（多个目标）
   • recipes/browserify-with-globs.md - Browserify + Globs
   • recipes/handling-the-delete-event-on-watch.md - 处理 Watch 上的删除事件
   • recipes/run-grunt-tasks-from-gulp.md - 从 Gulp 运行 Grunt 任务
   • recipes/rollup-with-rollup-stream.md - 使用 rollup-stream 的 Rollup
   • recipes/fast-browserify-builds-with-watchify.md - 使用 watchify 构建快速的 browserify 项目
   • recipes/incremental-builds-with-concatenate.md - 增量重建，包括对完整文件集的操作
   • recipes/maintain-directory-structure-while-globbing.md - 在使用 glob 匹配时保持目录结构
   • recipes/make-stream-from-buffer.md - 从缓冲区创建流
   • recipes/minimal-browsersync-setup-with-gulp4.md - 使用 Gulp4 的最小 Browsersync 设置
   • recipes/running-task-steps-per-folder.md - 为每个文件夹生成一个文件
   • recipes/server-with-livereload-and-css-injection.md - 带有实时重载和 CSS 注入功能的服务器
   • recipes/sharing-streams-with-stream-factories.md - 使用流工厂共享流

翻译指南

翻译时请遵循以下原则：

1. 保持专业术语一致：对于专业术语，应保持翻译一致性。可参考已翻译的文档。

2. 代码示例不翻译：代码本身不做翻译，但代码中的注释可以翻译。

3. 保留原始格式：保持原文档的标题层级、列表格式、链接引用等结构不变。

4. 链接修复：将文档内部链接修改为对应的中文文档路径。

5. 完整审阅：确保翻译后的文档语义完整、表达准确，没有漏译内容。

参考资源

翻译过程中可参考的资源：

• Gulp 官方网站
• lisposter 的 gulp-docs-zh-cn
• Gulp 中文网

贡献方式

如果您想参与翻译，请按照以下步骤：

1. 选择一个尚未翻译的文档
2. 完成翻译后提交 PR
3. 在 PR 中注明所翻译的文档名称及简要说明

感谢您对 Gulp 中文文档的贡献！