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