yui3

Yui 3：Yahooユーザーインターフェイスライブラリ

Yuiは、豊かなインタラクティブなWebアプリケーションを構築するための無料のオープンソースJavaScriptおよびCSSフレームワークです。 YuiはBSDライセンスの下で提供されており、Githubでフォーキングと貢献のために入手できます。

リンク

• ホームページ
• ドキュメント
• ブログ
• 最新の制作リリース
• フォーラム
• ライセンス
• 貢献者情報
• 貢献者メーリングリスト
• バグを報告します
• シフター、ユイを構築するため

ソース情報

これは、Yui 3のアクティブな作業源ツリーです。次のYui 3リリースに向けて進行中の作業が含まれており、不安定な場合があります。

評価の目的で最新のソースを使用し、新機能とバグ修正のテストを行い、新しい機能に関するフィードバックを提供することをお勧めします。生産用に推奨されるYuiの最新の安定したリリースを探している場合は、上記の「最新の生産リリース」リンクを参照してください。

Yuiに貢献する予定がある場合は、上記の「貢献者メーリングリスト」に参加して監視してください。マイルストーンとツリーの閉鎖に関する情報が利用可能になります。

ブランチ情報

Yuiの開発は、5つの主要な支店で行われます。以下は、これらの各コードブランチが表すものを説明しています。

• live-docs ：Yuiの最新のGAリリースに加えて、ドキュメントのみの更新を表します。最新リリースのドキュメントへの調整または追加は、このブランチで行われ、それらはウェブサイトに反映されています。

• master ：（読み取り専用） live-docsのすべてに加えて、次のYuiリリースに入るコードの変更が含まれています。 masterのコードの変更は、APIの互換性を破らないはずのバグ修正または小さな変更です。パッチリリースはこのブランチからカットされます。たとえば3.6.x.このブランチのすべてのコードは、すべてのユニットテストに完全に合格しており、安定している必要があります。

• 3.x ：（読み取り専用）は、次の主要なユイリリースを表します。例3.7.0。これは、 masterのすべてを含む統合ブランチに加えて、将来のYuiリリースになる大規模なコードの変更を含む統合ブランチです。 3.xの変更には、リリースの一部になる前にマイナーバージョンの増分が必要です。たとえば、3.7.0。プレビューリリースは、開発者がテストおよび評価するためにこのブランチからカットされます。このブランチのすべてのコードは、すべてのユニットテストに完全に合格しており、安定している必要があります。

• dev-master and dev-3.x ：CIプロセスを通過していないコードを含む現在の作業ブランチ。開発者は、自動化されたテストシステムが検証するために、これらの統合ブランチへの変更を確認します。それらが検証されると、コードはそれぞれmasterと3.xに統合されます。 masterまたは3.xに直接チェックインしないでください。

• release-3.xx ：コードチェックインが慎重に管理され、広範なテストとリリースの展開が慎重に管理されている短命のリリースブランチ。

ソースツリー

Yuiソースツリーには、次のディレクトリが含まれています。

• build ：YUIソースファイルの構築。構築されたファイルは、 srcディレクトリの内容から開発時に生成されます。ビルドステップでは、デバッグファイル（不均衡と完全なコメントとロギングを備えた）、生ファイル（乳化していないがデバッグロギングなし）、およびマニファイされたファイル（生産の展開と使用に適しています）を生成します。

• ライブラリ用のsrc RAW UNBUILTソースコード（JavaScript、CSS、Image Asset、ActionScriptファイルなど）。 YUI 3.4.0から始めて、 srcディレクトリには、すべてのモジュール固有のドキュメント、テスト、および例も含まれています。ライブラリとそのドキュメントのすべての変更は、このディレクトリで行われる必要があります。

初期セットアップ

1. Github（https://github.com/yui/yui3）でプロジェクトをフォークします。
2. 開発のために地元の環境にフォークをクローンします。

良いことをしてください

1. アトミックコードの変更をハウスするための機能ブランチを作成します。 git checkout -b myfeature upstream/master --no-track
2. 貢献要件を満たします（Yui貢献基準を参照）。
3. フォークに変更をプッシュします。
4. レビューのために、フォークからlive-docs 、 dev-master 、またはdev-3.xブランチにプルリクエストを送信します。
5. コミュニティのフィードバックを組み込みます。
6. フォークへの変更のプッシュ - プルリクエストは自動的に更新されます。
7. すすぎ、繰り返します。

すべての変更は、機能ブランチで引き続き行われる必要があります。そうすれば、提出するプルリクエストは自動的に更新されてそれらを含めます。マスターからの最新の変更で機能ブランチを更新しておくようにしてください。そうすれば、開発プロセス中に分岐しないようにしてください。

重要なヒント

• 常に機能ブランチから作業してください。すべてのコードの送信はプル要求を介して行われるため、特徴分岐は、ある提出から別の提出への変更を分離します。
• 提出したいブランチから常に新しいブランチを起動します： git checkout -b myfeature dev-master
• masterまたは3.xではなく、適切なdev-にプルリクエストを送信することを忘れないでください。

建物

YUIコンポーネントを構築するには、Shifter（ npm -g install shifter ）をインストールし、そのコンポーネントディレクトリでshifter実行するだけです。

シフターでは、Yui SRCツリー全体を再構築することもできます。

 cd yui3/src && shifter --walk