yui3

Yui 3: Die Yahoo User Interface Library

Yui ist ein kostenloses Open -Source -JavaScript- und CSS -Framework für den Aufbau reichlich interaktiver Webanwendungen. Yui wird im Rahmen einer BSD -Lizenz zur Verfügung gestellt und ist auf GitHub für Gaber und Beitrag erhältlich.

Links

• Startseite
• Dokumentation
• Blog
• Neueste Produktionsveröffentlichung
• Foren
• Lizenz
• Info von Mitwirkenden
• Postfotor -Mailingliste
• Einen Fehler melden
• Shifter zum Bau von Yui

Quellinformationen

Dies ist der aktive Arbeitsquellbaum für Yui.

Wir empfehlen Ihnen, die neueste Quelle für Bewertungszwecke zu verwenden, neue Funktionen und Fehlerbehebungen zu testen und Feedback zu neuen Funktionen zu geben. Weitere Informationen finden Sie im obigen Link "Letzte Produktionsveröffentlichung", wenn Sie nach der neuesten stabilen Veröffentlichung von Yui suchen, die für die Produktionsnutzung empfohlen werden.

Wenn Sie vorhaben, zu YUI beizutragen, treten Sie bitte an und überwachen Sie die oben aufgeführte "Mitwirkende Mailingliste". Informationen zu Meilensteinen und Baumschließungen werden dort zur Verfügung gestellt.

Zweiginformationen

Die Entwicklung von Yui findet an fünf Hauptzweigen statt. Das Folgende beschreibt, was jeder dieser Code -Zweige darstellt:

• live-docs : Repräsentiert die neueste GA-Veröffentlichung von YUI sowie alle Updates nur für Dokumentationen. Alle Änderungen oder Ergänzungen zu den Dokumenten für die neueste Veröffentlichung in dieser Filiale finden sich auf der Website wider.

• master : (schreibgeschützt) enthält alles in live-docs sowie Codes-Änderungen, die in die nächste YUI-Veröffentlichung eingehen. Die Codeänderungen im master sind entweder Fehlerbehebungen oder kleine Änderungen, die die API -Kompatibilität nicht durchbrechen sollten. Patch -Releases werden aus diesem Zweig geschnitten. zB 3.6.x. Der gesamte Code in dieser Filiale hat alle Unit -Tests vollständig bestanden und sollte stabil sein.

• 3.x : (schreibgeschützt) repräsentiert die nächste große Yui-Veröffentlichung; ZB 3.7.0. Dies ist ein Integrationszweig, der alles im master sowie größere Codeänderungen enthält, die in eine zukünftige YUI -Veröffentlichung eingehen. Die Änderungen in 3.x erfordern ein kleines Versionsinkrement, bevor sie Teil der Veröffentlichung sind, z. B. 3.7.0. Die Vorschau -Veröffentlichungen werden aus diesem Zweig für Entwickler geschnitten, um sie zu testen und zu bewerten. Der gesamte Code in dieser Filiale hat alle Unit -Tests vollständig bestanden und sollte stabil sein.

• dev-master und dev-3.x : Aktuelle Arbeitszweige mit Code, die den CI-Prozess nicht durchlaufen haben . Entwickler überprüfen ihre Änderungen in diesen Integrationszweigen, damit das automatisierte Testsystem validieren kann. Sobald sie validiert sind, wird der Code in master bzw. 3.x zusammengeführt. Schauen Sie sich niemals direkt in master oder 3.x ein.

• release-3.xx : Kurzlebige Release-Zweige, in denen Code-Checkins sorgfältig für umfangreiche Test- und Release-Bereitstellungen verwaltet werden.

Quellbaum

Der Yui -Quellbaum enthält die folgenden Verzeichnisse:

• build : Erstellte Yui -Quelldateien. Die erstellten Dateien werden zum Entwicklungszeit aus dem Inhalt des src -Verzeichnisses generiert. Der Build -Schritt generiert Debug -Dateien (unberührt und mit vollständigen Kommentaren und Protokollierung), RAW -Dateien (unberührt, jedoch ohne Debug -Protokollierung) und minimierte Dateien (geeignet für die Bereitstellung und Verwendung von Produktion).

• src RAW UNBAILT Quellcode (JavaScript, CSS, Bildvermögen, ActionScript -Dateien usw.) für die Bibliothek. Ab YUI 3.4.0 enthält das src -Verzeichnis auch alle modulspezifischen Dokumentationen, Tests und Beispiele. Alle Änderungen an der Bibliothek und deren Dokumentation sollten in diesem Verzeichnis stattfinden.

Erstes Setup

1. Fork das Projekt auf GitHub (https://github.com/yui/yui3).
2. Klonen Sie die Gabel in Ihr lokales Umfeld, um Entwicklung zu entwickeln.

Mach gute Sachen

1. Erstellen Sie eine Feature -Zweigstelle für die Änderungen des Atomcode -Codes. git checkout -b myfeature upstream/master --no-track
2. Erfüllen Sie die Beitragsanforderungen (siehe YUI -Beitragsstandards).
3. Drücken Sie Änderungen in Ihre Gabel.
4. Senden Sie eine Pull-Anfrage von Ihrer Gabel an die live-docs , dev-master oder dev-3.x Branch zur Überprüfung.
5. Community -Feedback einbeziehen.
6. Drücken Sie Änderungen an Ihre Gabel - die Pull -Anfrage wird automatisch aktualisiert.
7. Spülen und wiederholen.

Alle Änderungen sollten weiterhin in der Feature -Filiale vorgenommen werden. Auf diese Weise wird die von Ihnen eingereichte Pull -Anfrage automatisch aktualisiert, um sie einzuschließen. Stellen Sie sicher, dass die Feature -Niederlassung mit den neuesten Änderungen vom Master auf dem Laufenden bleibt, damit sie während Ihres Entwicklungsprozesses nicht abweichen.

Wichtige Tipps

• Arbeiten Sie immer von einem Feature -Zweig aus. Da alle Code -Einreichungen durch eine Pull -Anfrage erfolgen, isolieren Feature -Zweider Änderungen von einer Einreichung zur anderen.
• Starten Sie immer Ihre neue Filiale aus der Filiale, die Sie einreichen möchten: git checkout -b myfeature dev-master
• Denken Sie daran, Ihre Pull-Anfrage an den ordnungsgemäßen dev- und nicht master oder 3.x zu senden.

Gebäude

So erstellen Sie YUI -Komponenten, um Shifter ( npm -g install shifter ) zu installieren und dann einfach shifter in diesem Komponentenverzeichnis auszuführen.

Mit Shifter können Sie auch den gesamten Yui SRC -Baum wieder aufbauen:

 cd yui3/src && shifter --walk