yui3

Yui 3: la bibliothèque d'interface utilisateur Yahoo

YUI est un cadre JavaScript gratuit et open source et CSS pour créer des applications Web richement interactives. YUI est fourni sous une licence BSD et est disponible sur GitHub pour la fourniture et la contribution.

Links

• Page d'accueil
• Documentation
• Blog
• Dernière version de production
• Forums
• Licence
• Informations sur le contributeur
• Liste de diffusion des contributeurs
• Signaler un bug
• Levier de vitesses, pour construire yui

Informations sur la source

Il s'agit de l'arbre source de travail actif pour YUI 3. Il contient du travail en cours vers les prochaines versions YUI 3 et peut être instable.

Nous vous encourageons à utiliser la dernière source à des fins d'évaluation, à tester de nouvelles fonctionnalités et corrections de bogues et à fournir des commentaires sur les nouvelles fonctionnalités. Veuillez vous référer au lien "Dernier Release de production" ci-dessus si vous recherchez la dernière version stable de YUI recommandée pour une utilisation en production.

Si vous prévoyez de contribuer à YUI, veuillez rejoindre et surveiller la "liste de diffusion des contributeurs" indiquée ci-dessus. Des informations sur les jalons et les fermetures d'arbres seront disponibles là-bas.

Informations sur les succursales

Le développement de Yui se produit sur cinq branches principales. Ce qui suit décrit ce que représente chacune de ces branches de code:

• live-docs : représente la dernière version GA de YUI, plus toutes les mises à jour de documentation uniquement. Tous les ajustements ou ajouts aux documents pour la dernière version se produisent sur cette branche, et ils sont reflétés sur le site Web.

• master : (en lecture seule) Contient tout dans live-docs , plus des modifications de code qui seront dans la prochaine version YUI. Les modifications de code dans master sont soit des corrections de bogues, soit de petites modifications qui ne devraient pas casser la compatibilité de l'API. Les versions de patch seront coupées de cette branche; par exemple 3.6.x. Tout le code de cette branche a entièrement passé tous les tests unitaires et doit être stable.

• 3.x : (en lecture seule) Représente la prochaine version majeure de YUI; par exemple 3.7.0. Il s'agit d'une branche d'intégration qui contient tout dans master , ainsi que des modifications de code plus importantes qui entreront dans une future version YUI. Les modifications de 3.x nécessitent une incrément de version mineure avant de faire partie de la libération, par exemple, 3.7.0. Les versions de prévisualisation seront coupées de cette branche pour que les développeurs testent et évaluent. Tout le code de cette branche a entièrement passé tous les tests unitaires et doit être stable.

• dev-master et dev-3.x : les branches de travail actuelles contenant du code qui n'a pas été via le processus CI. Les développeurs vérifient leurs modifications dans ces branches d'intégration pour que le système de test automatisé puisse valider. Une fois qu'ils sont validés, le code est fusionné respectivement en master et 3.x Ne vérifiez jamais directement au master ou 3.x

• release-3.xx : branches de libération de courte durée où les vérifications de code sont soigneusement gérées pour les tests approfondis et le déploiement de la version.

Arbre source

L'arbre source YUI comprend les répertoires suivants:

• build : construit des fichiers source YUI. Les fichiers construits sont générés au moment du développement à partir du contenu du répertoire src . L'étape de construction génère des fichiers de débogage (non mandifiés et avec des commentaires complets et de la journalisation), des fichiers bruts (non mandifiés, mais sans journalisation de débogage) et des fichiers minifiés (adaptés au déploiement et à l'utilisation de la production).

• Code source non construit src RAW (JavaScript, CSS, actifs d'image, fichiers ActionScript, etc.) pour la bibliothèque. En commençant par YUI 3.4.0, le répertoire src contient également toutes les documents, tests et exemples spécifiques au module. Toutes les modifications de la bibliothèque et de sa documentation devraient avoir lieu dans ce répertoire.

Configuration initiale

1. Fourk le projet sur GitHub (https://github.com/yui/yui3).
2. Clone la fourche vers votre environnement local pour le développement.

Faire de bonnes choses

1. Créez une branche de fonctionnalité pour abriter les modifications du code atomique. git checkout -b myfeature upstream/master --no-track
2. Satisfaire aux exigences de contribution (voir les normes de contribution YUI).
3. Poussez les modifications à votre fourchette.
4. Soumettez une demande de traction de votre fourchette aux live-docs , dev-master ou de la succursale dev-3.x pour examen.
5. Incorporer les commentaires de la communauté.
6. Poussez les modifications à votre fourche - la demande de traction se mettra automatiquement à jour.
7. Rincer et répéter.

Toutes les modifications doivent continuer à être apportées sur la branche des fonctionnalités; De cette façon, la demande de traction que vous soumettez sera automatiquement mise à jour pour les inclure. Assurez-vous de garder la branche de fonctionnalité à jour avec les derniers modifications de Master, afin qu'ils ne divergent pas pendant votre processus de développement.

Conseils importants

• Travaillez toujours à partir d'une branche de fonctionnalité. Étant donné que toutes les soumissions de code se feront via une demande de traction, les branches de fonctions d'isolat des changements d'une soumission à une autre.
• Commencez toujours votre nouvelle branche à partir de la branche à laquelle vous souhaitez soumettre: git checkout -b myfeature dev-master
• N'oubliez pas de soumettre votre demande de traction à la bonne dev- et non master ou 3.x

Bâtiment

Pour construire les composants YUI, installez le SHIFTER ( npm -g install shifter ), puis exécutez simplement shifter dans ce répertoire de composants.

Le levier de vitesses vous permet également de reconstruire l'intégralité de l'arbre YUI SRC:

 cd yui3/src && shifter --walk