yui3

Yui 3: la biblioteca de interfaz de usuario de Yahoo

Yui es un marco de JavaScript y CSS de código abierto gratuito para construir aplicaciones web ricamente interactivas. Yui se proporciona bajo una licencia BSD y está disponible en GitHub para bifurcarse y contribuir.

Campo de golf

• Página de inicio
• Documentación
• Blog
• Último lanzamiento de producción
• Foros
• Licencia
• Información de contribuyentes
• Lista de correo de contribuyentes
• Informar un error
• Palanca de cambios, para construir yui

Información de origen

Este es el árbol fuente de trabajo activo para YUI 3. Contiene trabajo en progreso hacia las próximas lanzamientos de Yui 3 y puede ser inestable.

Le recomendamos que use la última fuente para fines de evaluación, pruebe nuevas características y correcciones de errores, y proporcione comentarios sobre una nueva funcionalidad. Consulte el enlace "Último lanzamiento de producción" de arriba si está buscando el último lanzamiento estable de YUI recomendado para el uso de producción.

Si planea contribuir a YUI, únase y monitoree la "Lista de correo de contribuyentes" mencionada anteriormente. La información sobre hitos y cierres de árboles estará disponible allí.

Información de rama

El desarrollo de Yui ocurre en cinco ramas principales. A continuación se describe lo que representa cada una de estas ramas de código:

• live-docs : representa el último lanzamiento de GA de YUI, además de cualquier actualización de documentación. Cualquier ajuste o adición a los documentos para el último lanzamiento ocurre en esta rama, y ​​se reflejan en el sitio web.

• master : (solo de lectura) contiene todo en live-docs , más los cambios en el código que irán a la próxima versión de YUI. Los cambios en el código en master son correcciones de errores o pequeños cambios que no deberían romper la compatibilidad de la API. Las versiones de parche se cortarán de esta rama; por ejemplo, 3.6.x. Todo el código en esta rama ha pasado completamente todas las pruebas unitarias y debe ser estable.

• 3.x : (solo lectura) representa la próxima versión principal de YUI; por ejemplo, 3.7.0. Esta es una rama de integración que contiene todo en master , además de cambios de código más grandes que se destinarán a una futura versión de YUI. Los cambios en 3.x requieren un incremento de versión menor antes de que formen parte de la liberación, por ejemplo, 3.7.0. Las versiones de vista previa se cortarán de esta rama para que los desarrolladores prueben y evalúen. Todo el código en esta rama ha pasado completamente todas las pruebas unitarias y debe ser estable.

• dev-master y dev-3.x : ramas de trabajo actuales que contienen código que no ha pasado por el proceso CI. Los desarrolladores verifican sus cambios en estas ramas de integración para que el sistema de pruebas automatizado valida. Una vez que se validan, el código se fusiona en master y 3.x respectivamente. Nunca se registre en master o 3.x directamente.

• release-3.xx : ramas de lanzamiento de corta duración donde los controles de código se administran cuidadosamente para una amplia implementación de pruebas y lanzamientos.

Árbol fuente

El árbol fuente de Yui incluye los siguientes directorios:

• build : Archivos de origen YUI construidos. Los archivos construidos se generan en el tiempo de desarrollo desde el contenido del directorio src . El paso de compilación genera archivos de depuración (sin minificar y con comentarios y registros completos), archivos sin procesar (sin minificar, pero sin registro de depuración) y archivos minificados (adecuados para la implementación y uso de producción).

• src Código fuente sin construir sin construir (JavaScript, CSS, activos de imagen, archivos de ActionScript, etc.) para la biblioteca. Comenzando con YUI 3.4.0, el directorio src también contiene toda la documentación, pruebas y ejemplos específicos del módulo. Todas las modificaciones a la biblioteca y su documentación deben tener lugar en este directorio.

Configuración inicial

1. Bifurca el proyecto en GitHub (https://github.com/yui/yui3).
2. Clonar la bifurcación a su entorno local para el desarrollo.

Haz cosas buenas

1. Cree una rama de características para albergar cambios en el código atómico. git checkout -b myfeature upstream/master --no-track
2. Satisfacer los requisitos de contribución (ver estándares de contribución de YUI).
3. Empuje los cambios a su bifurcación.
4. Envíe una solicitud de extracción de su bifurcación a la rama live-docs , dev-master o dev-3.x para su revisión.
5. Incorporar comentarios de la comunidad.
6. Empuje los cambios a su bifurcación: la solicitud de extracción se actualizará automáticamente.
7. Enjuague y repita.

Todos los cambios deben seguir realizándose en la rama de características; De esa manera, la solicitud de extracción que envíe se actualizará automáticamente para incluirlos. Asegúrese de mantener la rama de funciones actualizada con los últimos cambios de Master, para que no divergen durante su proceso de desarrollo.

Consejos importantes

• Siempre trabaje desde una rama de características. Dado que todos los envíos de código serán a través de una solicitud de extracción, las ramas de características aislarán los cambios de una envío a otra.
• Comience siempre su nueva sucursal desde la sucursal a la que desea enviar a: git checkout -b myfeature dev-master
• Recuerde enviar su solicitud de extracción a la dev- adecuada y no master o 3.x

Edificio

Para construir los componentes YUI, instale la palanca de cambios ( npm -g install shifter ) y luego simplemente ejecute shifter en ese directorio de componentes.

Shifter también te permite reconstruir todo el árbol Yui Src:

 cd yui3/src && shifter --walk