yui3

Yui 3: a biblioteca da interface do usuário do Yahoo

O YUI é uma estrutura JavaScript de código aberto gratuito e CSS para criar aplicativos da Web ricamente interativos. O YUI é fornecido sob uma licença BSD e está disponível no GitHub para forking e contribuição.

Links

• Página inicial
• Documentação
• Blog
• Último lançamento de produção
• Fóruns
• Licença
• Informações do colaborador
• Lista de discussão de colaboradores
• Relatar um bug
• Shifter, para construir yui

Informações da fonte

Esta é a árvore de fonte de trabalho ativa para Yui 3. Ele contém trabalho em andamento em direção aos próximos lançamentos YUI 3 e pode ser instável.

Incentivamos você a usar a fonte mais recente para fins de avaliação, testar novos recursos e correções de bugs e fornecer feedback sobre a nova funcionalidade. Consulte o link "mais recente lançamento de produção" acima, se você estiver procurando o lançamento estável mais recente do YUI recomendado para uso da produção.

Se você planeja contribuir para o YUI, junte -se e monitore a "Lista de discussão colaboradores" listada acima. Informações sobre marcos e fechamentos de árvores serão disponibilizados lá.

Informações da filial

O desenvolvimento de Yui acontece em cinco ramos principais. A seguir, descreve o que cada uma dessas filiais de código representa:

• live-docs : representa o lançamento mais recente do GA do YUI, além de quaisquer atualizações somente de documentação. Quaisquer ajustes ou adições aos documentos para o último lançamento acontecem nesta filial e eles se refletem no site.

• master : (somente leitura) contém tudo em live-docs , além de alterações de código que entrarão no próximo lançamento do YUI. As alterações de código no master são correções de bug ou pequenas alterações que não devem quebrar a compatibilidade da API. As liberações de patches serão cortadas deste ramo; Por exemplo, 3.6.x. Todo o código nesta filial passou totalmente em todos os testes de unidade e deve ser estável.

• 3.x : (somente leitura) representa a próxima liberação principal de YUI; Por exemplo, 3.7.0. Esta é uma filial de integração que contém tudo no master , além de alterações maiores de código que entrarão em uma versão futura do YUI. As alterações no 3.x requerem um incremento de versão menor antes de fazer parte da liberação, por exemplo, 3.7.0. Os lançamentos de visualização serão cortados a partir desta filial para que os desenvolvedores testem e avaliem. Todo o código nesta filial passou totalmente em todos os testes de unidade e deve ser estável.

• dev-master e dev-3.x : ramificações de trabalho atuais que contêm código que não passaram pelo processo de IC. Os desenvolvedores verificam suas alterações nessas filiais de integração para o sistema de teste automatizado para validar. Uma vez validados, o código é mesclado no master e 3.x , respectivamente. Nunca faça o check -in para master ou 3.x diretamente.

• release-3.xx : ramificações de liberação de curta duração, onde as verificações de código são cuidadosamente gerenciadas para testes extensivos e implantação de liberação.

Árvore de origem

A árvore de origem Yui inclui os seguintes diretórios:

• build : Built Yui Source Arquivos. Os arquivos construídos são gerados no horário de desenvolvimento a partir do conteúdo do diretório src . A etapa Build gera arquivos de depuração (não são elevados e com comentários completos e registro), arquivos brutos (não são elevados, mas sem o registro de depuração) e arquivos minificados (adequados para implantação e uso de produção).

• Código -fonte Raw não construído src (JavaScript, CSS, Ativos de Imagem, Arquivos de Actionscript, etc.) para a biblioteca. A partir do YUI 3.4.0, o diretório src também contém toda a documentação, testes e exemplos específicos do módulo. Todas as modificações na biblioteca e sua documentação devem ocorrer neste diretório.

Configuração inicial

1. Fork o projeto no github (https://github.com/yui/yui3).
2. Clone o garfo ao seu ambiente local para desenvolvimento.

Fazer coisas boas

1. Crie uma filial de recursos para abrigar as alterações do código atômico. git checkout -b myfeature upstream/master --no-track
2. Satisfaça os requisitos de contribuição (consulte os padrões de contribuição YUI).
3. Empurre mudanças no seu garfo.
4. Envie uma solicitação de tração do seu garfo para o live-docs , dev-master ou dev-3.x Branch para revisão.
5. Incorporar feedback da comunidade.
6. Empurre alterações no garfo - a solicitação de tração será atualizada automaticamente.
7. Enxágue e repita.

Todas as alterações devem continuar sendo feitas na filial do recurso; Dessa forma, a solicitação de tração que você envia será atualizada automaticamente para incluí -los. Mantenha a filial do recurso atualizada com as últimas alterações do Master, para que elas não divergem durante o seu processo de desenvolvimento.

Dicas importantes

• Sempre trabalhe em uma filial de recursos. Como todos os envios de código serão através de uma solicitação de tração, as filiais dos recursos isolam as alterações de um envio para outro.
• Sempre inicie sua nova filial da filial que você deseja enviar para: git checkout -b myfeature dev-master
• Lembre-se de enviar sua solicitação de tração para a dev- apropriada e não master ou 3.x

Prédio

Para construir os componentes YUI, instale o shifter ( npm -g install shifter ) e, em seguida, basta executar shifter nesse diretório de componentes.

Shifter também permite que você reconstrua toda a árvore Yui SRC:

 cd yui3/src && shifter --walk