YUI是一个免费的开源JavaScript和CSS框架,用于构建丰富的交互式Web应用程序。 YUI是根据BSD许可提供的,可在Github上获得分叉和贡献。
这是YUI 3的主动工作源树。它包含向下一个YUI 3发行的工作中的工作,可能是不稳定的。
我们鼓励您使用最新的来源进行评估,测试新功能和错误修复,并提供有关新功能的反馈。如果您正在寻找建议使用YUI的最新稳定版本,请参阅上面的“最新生产版本”链接。
如果您打算为YUI做出贡献,请加入并监视上面列出的“贡献者邮件列表”。有关里程碑和封闭树木的信息将在此处提供。
Yui的发展发生在五个主要分支机构上。以下描述了这些代码分支中的每个分支:
live-docs
:代表YUI的最新GA版本,以及任何仅文档的更新。最新版本的文档中的任何调整或添加都会在该分支机构上发生,并且它们会在网站上反映出来。
master
:(只读)包含live-docs
中的所有内容,以及将进入下一个YUI版本的代码更改。 master
中的代码更改是错误修复或小更改,不应破坏API兼容性。补丁释放将从该分支切割;例如3.6.x.该分支机构中的所有代码都已完全通过了所有单元测试,应保持稳定。
3.x
:(只读)代表下一个主要的YUI版本;例如3.7.0。这是一个集成分支,其中包含master
中的所有内容,再加上更大的代码更改,将进入未来的YUI版本。 3.x
中的更改需要次要版本的增量,然后才是发布的一部分,例如3.7.0。预览版本将从该分支中剪切,以供开发人员进行测试和评估。该分支机构中的所有代码都已完全通过了所有单元测试,应保持稳定。
dev-master
和dev-3.x
:当前的工作分支,其中包含尚未通过CI过程的代码。开发人员检查他们对这些集成分支的更改,以验证自动测试系统。一旦验证它们,代码将分别合并master
和3.x
切勿直接入住master
或3.x
release-3.xx
:短暂的发行分支,在其中仔细管理代码检查以进行广泛的测试和发布部署。
YUI源树包括以下目录:
build
:构建的YUI源文件。构建文件是从src
目录的内容在开发时间生成的。构建步骤生成调试文件(未经消息,完整注释和记录),原始文件(未经许可,但没有调试日志记录)和缩小文件(适用于生产部署和使用)。
库的src
RAW未构建源代码(JavaScript,CSS,图像资产,ActionScript文件等)。从YUI 3.4.0开始, src
目录还包含所有特定于模块的文档,测试和示例。对图书馆及其文档的所有修改都应在此目录中进行。
git checkout -b myfeature upstream/master --no-track
live-docs
, dev-master
或dev-3.x
分支提交拉动请求,以进行审查。所有更改都应继续在功能分支上进行;这样,您提交的拉动请求将自动更新以包括它们。请确保通过Master的最新更改来保持功能分支的更新,以免在您的开发过程中差异。
git checkout -b myfeature dev-master
dev-
分支,而不是master
或3.x
要构建YUI组件安装换档器( npm -g install shifter
),然后在该组件目录中运行shifter
。
Shifter还允许您重建整个YUI SRC树:
cd yui3/src && shifter --walk